GtkAssistant

在應用程式安裝或是使用者註冊、設定時，可以提供使用者「精靈」（Wizard）進行一些選項設定與資訊填寫，在Step by Step的過程中，提示使用者完成所有必要的選項設定或資訊填寫，精靈可以使用GtkAssistant類別來提供這個功能。

GtkAssistant中每一步的畫面，要參考至一個GtkWidget，所以您可以事先設計好一個GtkWidget，當中進行元件置放、設定版面管理、設定圖片、標題等，接著使用gtk_assistant_append_page ()附加為GtkAssistant的一個頁面，接著要使用gtk_assistant_set_page_type()設定好頁面類型：

GTK_ASSISTANT_PAGE_CONTENT：一般內容頁面
GTK_ASSISTANT_PAGE_INTRO：簡介頁面，通常是精靈的開始
GTK_ASSISTANT_PAGE_CONFIRM：確認頁面，通常是精靈的結束
GTK_ASSISTANT_PAGE_SUMMARY：顯示使用者的變更資訊
GTK_ASSISTANT_PAGE_PROGRESS：進度頁面，通常是精靈中的某個步驟

每個頁面預設的「下一步」（例如GTK_ASSISTANT_PAGE_INTRO或GTK_ASSISTANT_PAGE_PROGRESS等）或「套用」（例如GTK_ASSISTANT_PAGE_CONFIRM）預設是無法作用的，您要使用 gtk_assistant_set_page_complete()並設定complete參數為TRUE，「下一步」或「套用」按鈕才會有作用。

下面這個程式是個簡單的示範，程式中將用GtkAssistant建立精靈：

gtkassistant_demo.c

#include <gtk/gtk.h>

GtkWidget* gtk_assistant_page_new(GtkWidget *assistant, 
                                  GtkWidget *widget, 
                                  gchar *title,
                                  gchar *image,
                                  GtkAssistantPageType type) {
    gtk_assistant_append_page(GTK_ASSISTANT(assistant), widget);
    gtk_assistant_set_page_title(GTK_ASSISTANT(assistant), widget, title);
    gtk_assistant_set_page_side_image(GTK_ASSISTANT(assistant), 
             widget, gdk_pixbuf_new_from_file(image, NULL));
    gtk_assistant_set_page_type(GTK_ASSISTANT(assistant), widget, type);
    gtk_assistant_set_page_complete(GTK_ASSISTANT(assistant), widget, TRUE);
    
    return assistant;
}

int main(int argc, char *argv[]) {
    GtkWidget *assistant;
    GtkWidget *label;

    gtk_init (&argc, &argv);

    assistant = gtk_assistant_new();
    gtk_window_set_title(GTK_WINDOW(assistant), "GtkAssistant");
    gtk_window_set_default_size(GTK_WINDOW(assistant), 300, 180);

    gtk_assistant_page_new(assistant, gtk_label_new("簡介"), 
         "精靈開始", "caterpillar.jpg", GTK_ASSISTANT_PAGE_INTRO);
    gtk_assistant_page_new(assistant, gtk_label_new("說明內容或元件"), 
         "精靈第二頁", "caterpillar.jpg", GTK_ASSISTANT_PAGE_PROGRESS);
    gtk_assistant_page_new(assistant, gtk_label_new("說明內容或元件"), 
         "精靈第三頁", "caterpillar.jpg", GTK_ASSISTANT_PAGE_PROGRESS);
    gtk_assistant_page_new(assistant, gtk_label_new("說明內容或元件"), 
         "精靈結束", "caterpillar.jpg", GTK_ASSISTANT_PAGE_CONFIRM);
                                       
    g_signal_connect(GTK_OBJECT(assistant), "cancel",
                     G_CALLBACK(gtk_main_quit), NULL);
    
    gtk_widget_show_all(assistant);
    
    gtk_main(); 

    return 0;
}

一個執行的結果如下所示：