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;
}