GTK+ 2.0 教學-筆記本 Notebooks

筆記本元件(The NoteBook Widget)是互相重疊的頁面集合,每一頁都包含不同的訊息,且一次只有一個頁面是可見的。該元件在GUI(圖形用戶介面)程式設計中很常用。要顯示大量的相似訊息,同時把它們分別顯示時,使用這種元件是一個很好的方法。

第一個你要知道的函式呼叫,你可能已經猜到了,是用來創建一個新的筆記本元件。

GtkWidget *gtk_notebook_new( void );

一旦創建了筆記本元件,就可以使用一系列的函式操作該元件。下面將對它們進行分別討論。

先看一下怎樣定位頁面指示器—或稱頁標籤,可以有四種位置:上、下、左或右。

void gtk_notebook_set_tab_pos( GtkNotebook     *notebook,
                               GtkPositionType  pos );

GtkPositionType參數可以取以下幾個值,從字面上很容易理解它們的含義:

  GTK_POS_LEFT
  GTK_POS_RIGHT
  GTK_POS_TOP
  GTK_POS_BOTTOM

GTK_POS_TOP是預設值。

下面看一下怎樣向筆記本中添加頁面。有三種方法向筆記本中添加頁面。前兩種方法是非常相似的。

void gtk_notebook_append_page( GtkNotebook *notebook,
                               GtkWidget   *child,
                               GtkWidget   *tab_label );

void gtk_notebook_prepend_page( GtkNotebook *notebook,
                                GtkWidget   *child,
                                GtkWidget   *tab_label );

這些函式通過向插入頁面到筆記本的後端(append)或前端(prepend)來添加頁面。child是放在筆記本頁面裡的子元件,tab_label是要添加的頁面的標籤。child元件必須另外創建,一般是一個包含一套選項設置的容器元件,比如一個表格。

最後一個添加頁面的函式與前兩個函式類似,不過允許指定頁面插入的位置。

void gtk_notebook_insert_page( GtkNotebook *notebook,
                               GtkWidget   *child,
                               GtkWidget   *tab_label,
                               gint         position );

其中的參數與_append_和_prepend_函式一樣,還包含一個額外參數,position。該參數指定頁面應該插入到哪一頁。注意,第一頁位置為0。

前面介紹了怎樣添加一個頁面,下面介紹怎樣從筆記本中刪除一個頁面。

void gtk_notebook_remove_page( GtkNotebook *notebook,
                               gint         page_num );

這個函式從notebook指定的筆記本中刪除由page_num參數指定的頁面。

用這個函式找出筆記本的當前頁面:

gint gtk_notebook_get_current_page( GtkNotebook *notebook );

下面兩個函式將筆記本的頁面向前或向後移動。對要操作的筆記本元件使用以下函式就可以了。注意:當筆記本正在最後一頁時,呼叫 gtk_notebook_next_page() 函式,筆記本會跳到第一頁。同樣,如果筆記本在第一頁,呼叫了函式 gtk_notebook_prev_page(),筆記本元件會跳到最後一頁。

void gtk_notebook_next_page( GtkNoteBook *notebook );

void gtk_notebook_prev_page( GtkNoteBook *notebook );

下面這個函式設置「活動」頁面。比如你想筆記本的第5頁被打開,你將使用這個函式。不使用這個函式時筆記本預設顯示第一頁。

void gtk_notebook_set_current_page( GtkNotebook *notebook,
                                    gint         page_num );

下面兩個函式分別顯示或隱藏筆記本的頁標籤以及它的邊框。

void gtk_notebook_set_show_tabs( GtkNotebook *notebook,
                                 gboolean     show_tabs );

void gtk_notebook_set_show_border( GtkNotebook *notebook,
                                   gboolean     show_border );

如果頁面較多,標籤頁在頁面上排列不下時,可以用下面這個函式。它允許用兩個箭頭按鈕來滾動標籤頁。

void gtk_notebook_set_scrollable( GtkNotebook *notebook,
                                  gboolean     scrollable );

show_tabs, show_borderscrollable參數可以為 TRUE 或 FALSE。

下面看一個範例,它由 GTK 發佈版附帶的testgtk.c擴展而來。這個小程式創建了一個含一個筆記本元件和6個按鈕的視窗。筆記本包含11頁,由三種方式添加進來:追加、插入、前插。點擊按鈕可以改變頁標籤的位置,顯示/隱藏頁標籤和邊框,刪除一頁,向前或向後移動標籤頁,以及退出程式。

#include <stdio.h>
#include <gtk/gtk.h>

/* 這個函式旋轉頁標籤的位置 */
static void rotate_book( GtkButton   *button,
                         GtkNotebook *notebook )
{
    gtk_notebook_set_tab_pos (notebook, (notebook->tab_pos + 1) % 4);
}

/* 顯示/隱藏頁標籤和邊框 */
static void tabsborder_book( GtkButton   *button,
                             GtkNotebook *notebook )
{
    gint tval = FALSE;
    gint bval = FALSE;
    if (notebook->show_tabs == 0)
	    tval = TRUE; 
    if (notebook->show_border == 0)
	    bval = TRUE;
    
    gtk_notebook_set_show_tabs (notebook, tval);
    gtk_notebook_set_show_border (notebook, bval);
}

/* 從筆記本上刪除一個頁面 */
static void remove_book( GtkButton   *button,
                         GtkNotebook *notebook )
{
    gint page;
    
    page = gtk_notebook_get_current_page (notebook);
    gtk_notebook_remove_page (notebook, page);
      /* 需要刷新元件 -- 
     這會迫使元件重繪自身。 */
    gtk_widget_queue_draw (GTK_WIDGET (notebook));
}

static gboolean delete( GtkWidget *widget,
                        GtkWidget *event,
                        gpointer   data )
{
    gtk_main_quit ();
    return FALSE;
}

int main( int argc,
          char *argv[] )
{
    GtkWidget *window;
    GtkWidget *button;
    GtkWidget *table;
    GtkWidget *notebook;
    GtkWidget *frame;
    GtkWidget *label;
    GtkWidget *checkbutton;
    int i;
    char bufferf[32];
    char bufferl[32];
    
    gtk_init (&argc, &argv);
    
    window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
    
    g_signal_connect (window, "delete-event",
	              G_CALLBACK (delete), NULL);
    
    gtk_container_set_border_width (GTK_CONTAINER (window), 10);

    table = gtk_table_new (3, 6, FALSE);
    gtk_container_add (GTK_CONTAINER (window), table);
    
    /* 創建一個新的筆記本,將標籤頁放在頂部 */
    notebook = gtk_notebook_new ();
    gtk_notebook_set_tab_pos (GTK_NOTEBOOK (notebook), GTK_POS_TOP);
    gtk_table_attach_defaults (GTK_TABLE (table), notebook, 0, 6, 0, 1);
    gtk_widget_show (notebook);
    
    /* 在筆記本後面追加幾個頁面 */
    for (i = 0; i < 5; i++) {
	sprintf(bufferf, "Append Frame %d", i + 1);
	sprintf(bufferl, "Page %d", i + 1);
	
	frame = gtk_frame_new (bufferf);
	gtk_container_set_border_width (GTK_CONTAINER (frame), 10);
	gtk_widget_set_size_request (frame, 100, 75);
	gtk_widget_show (frame);
	
	label = gtk_label_new (bufferf);
	gtk_container_add (GTK_CONTAINER (frame), label);
	gtk_widget_show (label);
	
	label = gtk_label_new (bufferl);
	gtk_notebook_append_page (GTK_NOTEBOOK (notebook), frame, label);
    }
      
    /* 在指定位置添加頁面 */
    checkbutton = gtk_check_button_new_with_label ("Check me please!");
    gtk_widget_set_size_request (checkbutton, 100, 75);
    gtk_widget_show (checkbutton);
   
    label = gtk_label_new ("Add page");
    gtk_notebook_insert_page (GTK_NOTEBOOK (notebook), checkbutton, label, 2);
    
    /* 最後向筆記本前插頁面 */
    for (i = 0; i < 5; i++) {
	sprintf (bufferf, "Prepend Frame %d", i + 1);
	sprintf (bufferl, "PPage %d", i + 1);
	
	frame = gtk_frame_new (bufferf);
	gtk_container_set_border_width (GTK_CONTAINER (frame), 10);
	gtk_widget_set_size_request (frame, 100, 75);
	gtk_widget_show (frame);
	
	label = gtk_label_new (bufferf);
	gtk_container_add (GTK_CONTAINER (frame), label);
	gtk_widget_show (label);
	
	label = gtk_label_new (bufferl);
	gtk_notebook_prepend_page (GTK_NOTEBOOK (notebook), frame, label);
    }
    
    /* 設置起始頁(第4頁) */
    gtk_notebook_set_current_page (GTK_NOTEBOOK (notebook), 3);

    /* 創建一排按鈕 */
    button = gtk_button_new_with_label ("close");
    g_signal_connect_swapped (button, "clicked",
			      G_CALLBACK (delete), NULL);
    gtk_table_attach_defaults (GTK_TABLE (table), button, 0, 1, 1, 2);
    gtk_widget_show (button);
    
    button = gtk_button_new_with_label ("next page");
    g_signal_connect_swapped (button, "clicked",
			      G_CALLBACK (gtk_notebook_next_page),
			      notebook);
    gtk_table_attach_defaults (GTK_TABLE (table), button, 1, 2, 1, 2);
    gtk_widget_show (button);
    
    button = gtk_button_new_with_label ("prev page");
    g_signal_connect_swapped (button, "clicked",
			      G_CALLBACK (gtk_notebook_prev_page),
			      notebook);
    gtk_table_attach_defaults (GTK_TABLE (table), button, 2, 3, 1, 2);
    gtk_widget_show (button);
    
    button = gtk_button_new_with_label ("tab position");
    g_signal_connect (button, "clicked",
                      G_CALLBACK (rotate_book),
	              notebook);
    gtk_table_attach_defaults (GTK_TABLE (table), button, 3, 4, 1, 2);
    gtk_widget_show (button);
    
    button = gtk_button_new_with_label ("tabs/border on/off");
    g_signal_connect (button, "clicked",
                      G_CALLBACK (tabsborder_book),
                      notebook);
    gtk_table_attach_defaults (GTK_TABLE (table), button, 4, 5, 1, 2);
    gtk_widget_show (button);
    
    button = gtk_button_new_with_label ("remove page");
    g_signal_connect (button, "clicked",
                      G_CALLBACK (remove_book),
                      notebook);
    gtk_table_attach_defaults (GTK_TABLE (table), button, 5, 6, 1, 2);
    gtk_widget_show (button);
    
    gtk_widget_show (table);
    gtk_widget_show (window);
    
    gtk_main ();
    
    return 0;
}

我希望這些能幫你在你自己的應用程式中創建筆記本。

<<< Previous 單元首頁 Next >>>
GTK+ 2.0 教學-工具欄 Toolbar 向上 GTK+ 2.0 教學-選單元件

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

點我分享到Facebook

發佈留言

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