GTK+中状态栏（Status Bar）使用说明

状态栏(Status bar)是一些简单的构件，一般用来显示文本消息。它将文本消息压入到一个栈里面，当弹出当前消息时，将重新显示前一条文本消息。

 

为了让应用程序的不同部分使用同一个状态栏显示消息，状态栏构件使用上下文标识符 (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;
}