狀態列(Statusbars)是一些簡單的元件，一般用來顯示文字訊息。它將一堆文字訊息推到元件上，當彈出當前訊息時，將重新顯示前一條文字訊息。
為了讓應用程式的不同部分使用同一個狀態列顯示訊息，狀態列元件使用上下文識別字(Context Identifiers)來識別不同「用戶」。在堆疊頂部的訊息就是要顯示的訊息，不管它的上下文是什麼。訊息在堆疊裡面是以後進先出(last-in- first-out)的方式保存的，而不是按上下文識別字順序。
狀態列元件用下面的函式創建：
GtkWidget *gtk_statusbar_new( void ); |
用一個上下文的簡短文字描述呼叫下面的函式，可以獲得新的上下文識別字：
guint gtk_statusbar_get_context_id( GtkStatusbar *statusbar,
const gchar *context_description );
|
有三個函式用來操作狀態列：
guint gtk_statusbar_push( GtkStatusbar *statusbar,
guint context_id,
const gchar *text );
void gtk_statusbar_pop( GtkStatusbar *statusbar)
guint context_id );
void gtk_statusbar_remove( GtkStatusbar *statusbar,
guint context_id,
guint message_id );
|
第一個函式 gtk_statusbar_push() 用於將新訊息加到狀態列中，它返回一個訊息識別字(Message Identifier)。這個識別字可以和上下文識別字一起傳給gtk_statusbar_remove函式以將該訊息從狀態列的堆疊中刪除。
函式 gtk_statusbar_pop() 刪除在堆疊中給定上下文識別字的最上面的一條訊息。
除了顯示訊息，狀態列還可以顯示一個大小調整把手(resize grip)，用戶可以用滑鼠拖動它來改變視窗的大小，就像拖動視窗邊框一樣．下面的函式控制大小調整把手的顯示．
void gtk_statusbar_set_has_resize_grip( GtkStatusbar *statusbar, gboolean setting ); gboolean gtk_statusbar_get_has_resize_grip( GtkStatusbar *statusbar ); |
下面的範例創建了一個狀態列和兩個按鈕，一個將訊息壓入到狀態列堆疊中，另一個將最上面一條訊息彈出。
#include <stdlib.h>
#include <gtk/gtk.h>
#include <glib.h>
GtkWidget *status_bar;
static void push_item( GtkWidget *widget,
gpointer data )
{
static int count = 1;
gchar *buff;
buff = g_strdup_printf ("Item %d", count++);
gtk_statusbar_push (GTK_STATUSBAR (status_bar), GPOINTER_TO_INT (data), buff);
g_free (buff);
}
static void pop_item( GtkWidget *widget,
gpointer data )
{
gtk_statusbar_pop (GTK_STATUSBAR (status_bar), GPOINTER_TO_INT (data));
}
int main( int argc,
char *argv[] )
{
GtkWidget *window;
GtkWidget *vbox;
GtkWidget *button;
gint context_id;
gtk_init (&argc, &argv);
/* 創建新視窗 */ window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
gtk_widget_set_size_request (GTK_WIDGET (window), 200, 100);
gtk_window_set_title (GTK_WINDOW (window), "GTK Statusbar Example");
g_signal_connect (window, "delete-event",
G_CALLBACK (exit), NULL);
vbox = gtk_vbox_new (FALSE, 1);
gtk_container_add (GTK_CONTAINER (window), vbox);
gtk_widget_show (vbox);
status_bar = gtk_statusbar_new ();
gtk_box_pack_start (GTK_BOX (vbox), status_bar, TRUE, TRUE, 0);
gtk_widget_show (status_bar);
context_id = gtk_statusbar_get_context_id(
GTK_STATUSBAR (status_bar), "Statusbar example");
button = gtk_button_new_with_label ("push item");
g_signal_connect (button, "clicked",
G_CALLBACK (push_item), GINT_TO_POINTER (context_id));
gtk_box_pack_start (GTK_BOX (vbox), button, TRUE, TRUE, 2);
gtk_widget_show (button);
button = gtk_button_new_with_label ("pop last item");
g_signal_connect (button, "clicked",
G_CALLBACK (pop_item), GINT_TO_POINTER (context_id));
gtk_box_pack_start (GTK_BOX (vbox), button, TRUE, TRUE, 2);
gtk_widget_show (button);
/* 將視窗最後顯示，讓整個視窗立刻出現在螢幕上． */
gtk_widget_show (window);
gtk_main ();
return 0;
}
|
1 則留言