GTK Gossip: GtkAssistant

最新推荐文章于 2019-01-05 18:32:33 发布

转载最新推荐文章于 2019-01-05 18:32:33 发布 · 525 阅读

文章标签：

#gtk #image #wizard #callback #signal #null

software 同时被 2 个专栏收录

461 篇文章

订阅专栏

friendly

400 篇文章

订阅专栏

本文介紹了如何使用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;

}

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