如果想要将一个窗口分成两个部分，可以使用分栏窗口控件(The paned window widgets)。

窗口两部分的尺寸由用户控制，它们之间有一个凹槽，上面有一个手柄，用户可以拖动此手柄改变两部分的比例。

窗口划分可以是水平(HPaned)或垂直的(VPaned)。

创建分栏窗口

用以下函数之一创建一个新的分栏窗口：

//创建水平分栏窗口：
GtkWidget *gtk_hpaned_new (void);

//创建垂直分栏窗口：
GtkWidget *gtk_vpaned_new (void);

向分栏窗口添加控件

创建了分栏窗口控件后，可以在它的两边添加控件。用下面的函数完成：

//gtk_paned_add1() 将子控件添加到分栏窗口的左边或顶部
void gtk_paned_add1 (GtkPaned *paned, GtkWidget *child);

//gtk_paned_add2()将子控件添加到分栏窗口的右边或下部
void gtk_paned_add2 (GtkPaned *paned, GtkWidget *child);

示例

功能

1. 在本示例中，模拟了一个的email程序的用户界面。
2. 窗口被垂直划分为两个部分：上面部分显示一个email信息列表，下部显示email文本信息。
3. 程序大部分都是漂亮直接的。

有两点要注意：

1. 在文本控件实例化(realized)前,文本不能加到文本控件中。但你可以调用 gtk_widget_realize() 函数完成，不过，作为一个可变通技巧的展示，我们为控件的 “realize” 信号设置一个信号处理函数，并在这个函数里面添加文本。
2. 我们需要为表(table)控件中包含文本窗口和它的滚动条的格子设置GTK_SHRINK选项，以便当窗口的下面部分变小时，下部的控件能够自动地缩小，而不是被压到窗口的底部去，只部分显示。

源码

#include <stdio.h>
#include <gtk/gtk.h>

/* 创建一个"信息"列表 */
GtkWidget *create_list( void )
{
    GtkWidget *scrolled_window;
    GtkWidget *tree_view;
    GtkListStore *model;
    GtkTreeIter iter;
    GtkCellRenderer *cell;
    GtkTreeViewColumn *column;

    int i;

    /* 创建一个新的滚动窗口(scrolled window)，只有需要时，水平方向和垂直方向的滚动条才出现 */
    scrolled_window = gtk_scrolled_window_new (NULL, NULL);
    gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_window),
                                    GTK_POLICY_AUTOMATIC,
                                    GTK_POLICY_AUTOMATIC);

    //新建一种 list store 模式：
    model = gtk_list_store_new (1, G_TYPE_STRING);
    //新建一个 tree view 控件：
    tree_view = gtk_tree_view_new ();
    gtk_scrolled_window_add_with_viewport (GTK_SCROLLED_WINDOW (scrolled_window),
                                           tree_view);
    //将 tree view控件的模式设置为 list store :
    gtk_tree_view_set_model (GTK_TREE_VIEW (tree_view), GTK_TREE_MODEL (model));
    gtk_widget_show (tree_view);

    /* 在窗口中添加一些消息 */
    for (i = 0; i < 10; i++)
    {
        gchar *msg = g_strdup_printf ("Message #%d", i);

        //追加一个新行：
        gtk_list_store_append (GTK_LIST_STORE (model), &iter);
        gtk_list_store_set (GTK_LIST_STORE (model),
                            &iter,    //iter指向的行
                            0,         //第0列
                            msg,    //设置的值
                            -1        //该行设置结束
                            );
        //内存资源手动回收:
        g_free (msg);
    }

       //新建列使用的渲染器:
    cell = gtk_cell_renderer_text_new ();
    //新建一列:
    column = gtk_tree_view_column_new_with_attributes ("Messages",    //设置该列的标题
                                                       cell,        //该列使用的渲染器
                                                       //开始设置当前列的属性：
                                                       "text",        //该列的属性为 text ，可用来显示字符串
                                                       0,            //第 0 列
                                                       NULL            //表示当前列属性设置完毕
                                                       );
    //将该列添加到 tree view 控件中：
    gtk_tree_view_append_column (GTK_TREE_VIEW (tree_view),
                                GTK_TREE_VIEW_COLUMN (column));

    return scrolled_window;
}

/* 向文本控件中添加一些文本 - 这是当窗口被实例化(realized)时调用的回调函数。
 * 我们也可以用 gtk_widget_realize 强行将窗口实例化，但这必须在它的层次关系
 * 确定后(be part of a hierarchy)才行。
 *
 * 译者注：控件的层次关系就是其parent被确定。将一个子控件加到一个容器中
 * 时，其parent就是这个容器。层次关系被确定要求，其parent的parent...也
 * 确定了。顶级窗口可以不要parent。只是我的经验理解。
*/
void insert_text (GtkTextBuffer *buffer)
{
    GtkTextIter iter;

    gtk_text_buffer_get_iter_at_offset (buffer, &iter, 0);

    gtk_text_buffer_insert (buffer, &iter,
                            "From: pathfinder@nasa.gov\n"
                            "To: mom@nasa.gov\n"
                            "Subject: Made it!\n"
                            "\n"
                            "We just got in this morning. The weather has been\n"
                            "great - clear but cold, and there are lots of fun sights.\n"
                            "Sojourner says hi. See you soon.\n"
                            " -Path\n",
                            -1
                            );
}

/* 创建一个滚动文本区域，用于显示一个"信息" */
GtkWidget *create_text( void )
{
    GtkWidget *scrolled_window;
    GtkWidget *view;
    GtkTextBuffer *buffer;

    view = gtk_text_view_new ();
    buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (view));

    scrolled_window = gtk_scrolled_window_new (NULL, NULL);
    gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_window),
    GTK_POLICY_AUTOMATIC,
    GTK_POLICY_AUTOMATIC);

    gtk_container_add (GTK_CONTAINER (scrolled_window), view);

    insert_text (buffer);

    gtk_widget_show_all (scrolled_window);

    return scrolled_window;
}

int main( int   argc,
          char *argv[] )
{
    GtkWidget *window;
    GtkWidget *vpaned;
    GtkWidget *list;
    GtkWidget *text;

    gtk_init (&argc, &argv);

    window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
    gtk_window_set_title (GTK_WINDOW (window), "www.softool.cn - Paned Window");
    g_signal_connect (G_OBJECT (window), "destroy",
    G_CALLBACK (gtk_main_quit), NULL);
    gtk_container_set_border_width (GTK_CONTAINER (window), 10);
    gtk_widget_set_size_request (GTK_WIDGET (window), 450, 400);

    /* 在顶级窗口上添加一个垂直分栏的窗口控件 */
    vpaned = gtk_vpaned_new ();
    gtk_container_add (GTK_CONTAINER (window), vpaned);
    gtk_widget_show (vpaned);

    /* 在分栏窗口的两部分各添加一些控件 */
    list = create_list ();
    //垂直分栏：上面
    gtk_paned_add1 (GTK_PANED (vpaned), list);
    gtk_widget_show (list);

    text = create_text ();
    //垂直分栏：下面
    gtk_paned_add2 (GTK_PANED (vpaned), text);
    gtk_widget_show (text);
    gtk_widget_show (window);

    gtk_main ();

    return 0;
}