状态栏 Statusbars@GTK+ 2.0 中文教程连载

状态栏 Statusbars

状态栏(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; void push_item( GtkWidget *widget, gpointer data ) { static int count = 1; char buff[20]; g_snprintf (buff, 20, "Item %d", count++); gtk_statusbar_push (GTK_STATUSBAR (status_bar), GPOINTER_TO_INT (data), buff); return; } void pop_item( GtkWidget *widget, gpointer data ) { gtk_statusbar_pop (GTK_STATUSBAR (status_bar), GPOINTER_TO_INT (data)); return; } 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 (G_OBJECT (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 (G_OBJECT (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 (G_OBJECT (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; }

---

<<< Previous	Home	Next >>>
标尺 Rulers	Up	文本输入构件 Text Entries