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;

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;
}

感謝你看到這裡,很快就可以離開了,但最好的獎勵行動就是按一下幫我分享或留言,感恩喔~

點我分享到Facebook

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *