GTK+ 例項/樹形檢視/簡介

GtkTreeView 是一個用於顯示單列或多列列表和樹的部件。它取代了舊的 Gtk+-1.2 GtkCList 和 GtkCTree 部件。儘管 GtkTreeView 比其前身稍微難掌握，但它功能強大且靈活，以至於大多數應用程式開發者在瞭解之後都不願錯過它。

本章的目的是不是要提供 GtkTreeView 的詳盡文件 - 那是 API 文件的用途，應該與本教程一起閱讀。目標更像是介紹 GtkTreeView 最常用的方面，並演示各種 GtkTreeView 元件和概念是如何協同工作的。此外，還嘗試闡明自定義樹模型和自定義單元格渲染器，這些內容似乎經常被提及，但很少解釋。

希望快速瞭解並能在五段以內學會所有內容的開發人員，在這裡找不到。作者的經驗表明，不瞭解樹檢視和模型如何協同工作的開發人員，在嘗試修改給定示例時會遇到問題，而使用其他採用模型/檢視/控制器設計模式的工具包的開發人員會發現 API 參考提供了他們需要的所有資訊，而且形式更簡潔。當然，不同意的開發人員可以直接跳到示例程式碼。

請注意，以下部分中的程式碼示例不一定演示了在特定情況下如何最佳地使用 GtkTreeView。有不同的方法可以達到相同的結果，示例只是展示了這些不同的方法，以便開發人員能夠決定哪一種最適合當前任務。

Hello World

/* 
 * Compile with:
 *  gcc -o helloworld helloworld.c `pkg-config --cflags --libs gtk+-2.0`
 *
 */

#include <gtk/gtk.h>

enum
{
  COL_NAME = 0,
  COL_AGE,
  NUM_COLS
} ;


static GtkTreeModel *
create_and_fill_model (void)
{
  GtkListStore  *store;
  GtkTreeIter    iter;
  
  store = gtk_list_store_new (NUM_COLS, G_TYPE_STRING, G_TYPE_UINT);

  /* Append a row and fill in some data */
  gtk_list_store_append (store, &iter);
  gtk_list_store_set (store, &iter,
                      COL_NAME, "Heinz El-Mann",
                      COL_AGE, 51,
                      -1);
  
  /* append another row and fill in some data */
  gtk_list_store_append (store, &iter);
  gtk_list_store_set (store, &iter,
                      COL_NAME, "Jane Doe",
                      COL_AGE, 23,
                      -1);
  
  /* ... and a third row */
  gtk_list_store_append (store, &iter);
  gtk_list_store_set (store, &iter,
                      COL_NAME, "Joe Bungop",
                      COL_AGE, 91,
                      -1);
  
  return GTK_TREE_MODEL (store);
}

static GtkWidget *
create_view_and_model (void)
{
  GtkCellRenderer     *renderer;
  GtkTreeModel        *model;
  GtkWidget           *view;

  view = gtk_tree_view_new ();

  /* --- Column #1 --- */

  renderer = gtk_cell_renderer_text_new ();
  gtk_tree_view_insert_column_with_attributes (GTK_TREE_VIEW (view),
                                               -1,      
                                               "Name",  
                                               renderer,
                                               "text", COL_NAME,
                                               NULL);

  /* --- Column #2 --- */

  renderer = gtk_cell_renderer_text_new ();
  gtk_tree_view_insert_column_with_attributes (GTK_TREE_VIEW (view),
                                               -1,      
                                               "Age",  
                                               renderer,
                                               "text", COL_AGE,
                                               NULL);

  model = create_and_fill_model ();

  gtk_tree_view_set_model (GTK_TREE_VIEW (view), model);

  /* The tree view has acquired its own reference to the
   *  model, so we can drop ours. That way the model will
   *  be freed automatically when the tree view is destroyed */

  g_object_unref (model);

  return view;
}


int
main (int argc, char **argv)
{
  GtkWidget *window;
  GtkWidget *view;

  gtk_init (&argc, &argv);

  window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
  g_signal_connect (window, "delete_event", gtk_main_quit, NULL); /* dirty */

  view = create_view_and_model ();

  gtk_container_add (GTK_CONTAINER (window), view);

  gtk_widget_show_all (window);

  gtk_main ();

  return 0;
}