GTK+ 2.0 教学-状态列 Statusbars

By:
On:
In: LinuxDev

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

Comments are closed.