GTK Gossip: 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;

}

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