状态栏 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;
} |