GtkComboBox 與 GtkListStore

ACTom

本文转载自：http://blog.csdn.net/caterpillar ... /07/10/2632833.aspx
GtkComboBox可以建立下拉選單，以供使用者選取項目，GtkComboBox實現了Model-View模式，可提供豐富的項目類型與表現方式，但這也提高了程式撰寫時的複雜度，為此，GtkComboBox提供了gtk_combo_box_new_text()以建立一般常用的文字下拉清單功能之GtkComboBox，若想要設定下拉清單中的文字項目，則可以使用gtk_combo_box_append_text()、 gtk_combo_box_insert_text()、gtk_combo_box_prepend_text()、gtk_combo_box_remove_text()、gtk_combo_box_get_active_text()等函式。下面這個程式是個簡單的示範，實作只有文字選項的GtkComboBox，作為介紹GtkComboBox的開始，下拉選定項目後，會在下方的GtkLabel顯示所選中的文字：         

[li]gtk_combo_box_demo.c[/li]

1. #include <gtk/gtk.h>
2. gboolean combo_changed(GtkComboBox *comboBox, GtkLabel *label)
3. {
4.     gchar *active = gtk_combo_box_get_active_text(comboBox);
5.     gtk_label_set_text(label, active);
6. }
7. int main(int argc, char *argv[])
8. {
9.     GtkWidget *window;
10.     GtkWidget *comboBox;
11.     GtkWidget *label;
12.     GtkWidget *vbox;
14.     gtk_init(&argc, &argv);
16.     window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
17.     gtk_window_set_title(GTK_WINDOW(window), "GtkComboBox");
18.     gtk_window_set_default_size(GTK_WINDOW(window), 200, 50);
19.     comboBox = gtk_combo_box_new_text();
20.     gtk_combo_box_append_text(GTK_COMBO_BOX(comboBox), "caterpillar");
21.     gtk_combo_box_append_text(GTK_COMBO_BOX(comboBox), "momor");
22.     gtk_combo_box_append_text(GTK_COMBO_BOX(comboBox), "hamimi");
23.     gtk_combo_box_append_text(GTK_COMBO_BOX(comboBox), "bush");
24.     gtk_combo_box_set_active(GTK_COMBO_BOX(comboBox), 0);
25.     label = gtk_label_new("caterpillar");
26.     vbox = gtk_vbox_new(TRUE, 5);
27.     gtk_box_pack_start(GTK_BOX(vbox), comboBox, TRUE, TRUE, 5);
28.     gtk_box_pack_start(GTK_BOX(vbox), label, TRUE, TRUE, 5);
29.     gtk_container_add(GTK_CONTAINER(window), vbox);
30.     g_signal_connect(GTK_OBJECT(comboBox), "changed",                     
31.                      G_CALLBACK(combo_changed), label);
32.     g_signal_connect(GTK_OBJECT(window), "destroy",
33.                      G_CALLBACK(gtk_main_quit), NULL);
35.     gtk_widget_show_all(window);
37.     gtk_main();
39.     return 0;
40. }

复制代码

一個執行時的畫面如下所示：


   上面的範例，是GtkComboBox最簡單的用法，選項只有純文字，若想要進一步讓GtkComboBox呈現更多的功能與樣貌，則必須了解GtkComboBox的Model-View設計。GtkComboBox的外觀是View物件的部份，選項資料的部份則是Model物件的部份，GtkComboBox使用的Model物件為實作GtkTreeModel介面的物件，例如GtkListStore或GtkTreeStore，其實作了Model物件的資料儲存與存取方式等，在這邊先介紹GtkComboBox與GtkListStore的使用。GtkListStore是沒有階層平坦式的資料，當下拉選單需要的是直接列示選項就可以使用，GtkListStore中可以設定文字、圖片、元件等，要建立GtkListStore，必須指明要建立幾個欄位以及欄位中的型態，例如：

1. GtkListStore *store = gtk_list_store_new(2, GDK_TYPE_PIXBUF, G_TYPE_STRING);

复制代码

這個程式片段將建立一個具有兩個欄位的GtkListStore，一個欄位儲存圖片，使用GDK_TYPE_PIXBUF來指定，欄位將儲存的是GdkPixbuf，另一個儲存文字，使用G_TYPE_STRING來指定。您可以使用gdk_pixbuf_new_from_file()讀取圖檔並傳回其GdkPixbuf，第二個參數是GError，若不需要可以設定為NULL：

1. GdkPixbuf *pixbuf = gdk_pixbuf_new_from_file(files[[b]i[/b]], NULL);

复制代码

GtkListStore使用GtkTreeIter作為內部的資料位置指標，當您使用gtk_list_store_append()時，會將GtkTreeIter指向GtkListStore下一列的位置，接著您再搭配gtk_list_store_set()設定GtkListStore該位置的欄位資料，例如：

1. GtkTreeIter iter;
2. gtk_list_store_append(store, &iter);
3. gtk_list_store_set(store, &iter,
4.                    0, pixbuf,
5.                    1, filename,
6.                    -1);

复制代码

gtk_list_store_set()的前兩個參數分別為GtkListStore與GtkTreeIter，之後則兩兩成對指定欄位索引與資料，最後以-1作為結束。有了GtlListStore這個Model物件之後，接著可以用以建立View，也就是GtkComboBox，您可以使用gtk_combo_box_new_with_model()來建立：

1. GtkWidget *comboBox = gtk_combo_box_new_with_model(GTK_TREE_MODEL(store));

复制代码

您的資料要如何顯示，需要對應的GtkCellRenderer來進行繪製，哪個欄位要使用哪個GtkCellRenderer以及該欄位的一些相關屬性，則要告知GtkCellLayout，GtkComboBox有實作GtkCellLayout介面，因此，您可以如下使用gtk_cell_layout_pack_start()設定GtkCellRenderer繪製哪個欄位，以及使用gtk_cell_layout_set_attributes()設定相關屬性：         

1. GtkCellRender *render;  renderer = gtk_cell_renderer_pixbuf_new();
2. gtk_cell_layout_pack_start(GTK_CELL_LAYOUT(comboBox), renderer, FALSE);
3. gtk_cell_layout_set_attributes(GTK_CELL_LAYOUT(comboBox), renderer,
4.                                "pixbuf", 0, // "pixbuf" 設定圖像
5.                                NULL);  // 最後以 NULL 結尾
6. renderer = gtk_cell_renderer_text_new();
7. gtk_cell_layout_pack_start(GTK_CELL_LAYOUT(comboBox), renderer, FALSE);
8. gtk_cell_layout_set_attributes(GTK_CELL_LAYOUT(comboBox), renderer,
9.                                "text", 1, // "text" 設定文字
10.                                NULL);

复制代码

以上這些大致上是設定GtkComboBox的Model與View的基本流程。假設現在使用者選擇下拉清單中的選項，則要取得選項資料，則需先取得Model，也就是CtkComboBox中的GtkListStore，並取得選中的選項之GtkTreeIter（記得嗎？GtkTreeIter指向GtkListStore中的某列資料），然後再使用gtk_tree_model_get()取得想要的欄位值，例如：         

1. gboolean combo_changed(GtkComboBox *comboBox, GtkLabel *label) {
2.     GtkTreeModel *model = gtk_combo_box_get_model(comboBox);
3.     GtkTreeIter iter;
4.     gchar *active;
5.     gtk_combo_box_get_active_iter(comboBox, &iter);
6.     gtk_tree_model_get(model, &iter,
7.                        1, &active,
8.                        -1);
10.     gtk_label_set_text(label, active);
11. }

复制代码

綜合以上說明，來改寫一下上面的範例，讓下拉選項可以擁有一個小圖示：         

[li]gtk_combo_box_with_icon_demo.c[/li]

1. #include <gtk/gtk.h>
2. enum {     PIXBUF_COL,     TEXT_COL };
3. GtkTreeModel* createModel()
4. {
5.     const gchar *files[] = {"caterpillar.jpg", "momor.jpg",                             "hamimi.jpg", "bush.jpg"};
6.     GdkPixbuf *pixbuf;
7.     GtkTreeIter iter;
8.     GtkListStore *store;
9.     gint i;
10.     store = gtk_list_store_new(2, GDK_TYPE_PIXBUF, G_TYPE_STRING);
11.     for(i = 0; i < 4; i++)
12.     {
13.         pixbuf = gdk_pixbuf_new_from_file(files[[b]i[/b]], NULL);
14.         gtk_list_store_append(store, &iter);
15.         gtk_list_store_set(store, &iter,                            PIXBUF_COL, pixbuf,                            TEXT_COL, files[[b]i[/b]],                            -1);
16.     }
17.     return GTK_TREE_MODEL(store);
18. }
19. gboolean combo_changed(GtkComboBox *comboBox, GtkLabel *label)
20. {
21.     GtkTreeModel *model = gtk_combo_box_get_model(comboBox);
22.     GtkTreeIter iter;
23.     gchar *active;
24.     gtk_combo_box_get_active_iter(comboBox, &iter);
25.     gtk_tree_model_get(model, &iter,                        1, &active,                        -1);
26.     gtk_label_set_text(label, active);
27. }
28. int main(int argc, char *argv[])
29. {
30.     GtkWidget *window;
31.     GtkWidget *comboBox;
32.     GtkCellRenderer *renderer;
33.     GtkWidget *label;
34.     GtkWidget *vbox;
36.     gtk_init(&argc, &argv);
38.     window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
39.     gtk_window_set_title(GTK_WINDOW(window), "GtkComboBox");
40.     gtk_window_set_default_size(GTK_WINDOW(window), 200, 50);
41.     comboBox = gtk_combo_box_new_with_model(createModel());
42.     gtk_combo_box_set_active(GTK_COMBO_BOX(comboBox), 0);
43.     renderer = gtk_cell_renderer_pixbuf_new();
44.     gtk_cell_layout_pack_start(GTK_CELL_LAYOUT(comboBox), renderer, FALSE);
45.     gtk_cell_layout_set_attributes(GTK_CELL_LAYOUT(comboBox), renderer,                                    
46.                                    "pixbuf", PIXBUF_COL,                                    
47.                                    NULL);
48.     renderer = gtk_cell_renderer_text_new();
49.     gtk_cell_layout_pack_start(GTK_CELL_LAYOUT(comboBox), renderer, FALSE);
50.     gtk_cell_layout_set_attributes(GTK_CELL_LAYOUT(comboBox), renderer,                                    
51.                                    "text",
52.                                    TEXT_COL,                                    
53.                                    NULL);
54.     label = gtk_label_new("caterpillar.jpg");
55.     vbox = gtk_vbox_new(TRUE, 5);
56.     gtk_box_pack_start(GTK_BOX(vbox), comboBox, TRUE, TRUE, 5);
57.     gtk_box_pack_start(GTK_BOX(vbox), label, TRUE, TRUE, 5);
58.     gtk_container_add(GTK_CONTAINER(window), vbox);
59.     g_signal_connect(GTK_OBJECT(comboBox), "changed",                     
60.                      G_CALLBACK(combo_changed), label);
61.     g_signal_connect(GTK_OBJECT(window), "destroy",
62.                      G_CALLBACK(gtk_main_quit), NULL);
64.     gtk_widget_show_all(window);
66.     gtk_main();
68.     return 0;
69. }

复制代码

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