滚动窗口 Scrolled Windows

滚动窗口(Scrolled windows)用于创建一个可滚动的区域，并将其它控件放入其中。可以在滚动窗口中插入任何其它控件，在其内部的控件不论尺寸大小都可以通过滚动条访问。

创建滚动窗口

用下面的函数创建新的滚动窗口。

GtkWidget *gtk_scrolled_window_new( GtkAdjustment *hadjustment,
                                    GtkAdjustment *vadjustment );

参数：

• hadjustment
  该参数是水平方向的调整对象，一般都设置为 NULL；
• vadjustment
  该参数是垂直方向的调整对象，一般都设置为 NULL；

设置滚动条显示方式

void gtk_scrolled_window_set_policy( GtkScrolledWindow *scrolled_window,
                                     GtkPolicyType      hscrollbar_policy,
                                     GtkPolicyType      vscrollbar_policy );

参数：

• scrolled_window
  该参数是要设置的滚动窗口；
• hscrollbar_policy
  该参数设置水平滚动条显示方式；
• vscrollbar_policy
  该参数设置垂直滚动条显示方式；

将控件添加到滚动窗口

void gtk_scrolled_window_add_with_viewport( GtkScrolledWindow *scrolled_window,
                                            GtkWidget         *child);

示例

功能

在滚动窗口控件中放置一个table控件，并在table控件中放100个开关按钮，效果如下：

源码

注：
我将只对那些你可能比较陌生的代码作些注释。

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

void destroy( GtkWidget *widget,
              gpointer   data )
{
    gtk_main_quit ();
}

int main( int   argc,
          char *argv[] )
{
    static GtkWidget *window;
    GtkWidget *scrolled_window;
    GtkWidget *table;
    GtkWidget *button;
    char buffer[32];
    int i, j;

    gtk_init (&argc, &argv);

    /* 创建一个新的对话框窗口，滚动窗口就放在这个窗口上 */
    window = gtk_dialog_new ();
    g_signal_connect (G_OBJECT (window), "destroy",
                            G_CALLBACK (destroy), NULL);
    gtk_window_set_title (GTK_WINDOW (window), "www.softool.cn - scrolled window");
    gtk_container_set_border_width (GTK_CONTAINER (window), 0);
    gtk_widget_set_size_request (window, 800, 480);

    /* 创建一个新的滚动窗口。 */
    scrolled_window = gtk_scrolled_window_new (NULL, NULL);
    gtk_container_set_border_width (GTK_CONTAINER (scrolled_window), 10);
    /* 滚动条的出现方式可以是 GTK_POLICY_AUTOMATIC 或 GTK_POLICY_ALWAYS。
     * 设为GTK_POLICY_AUTOMATIC将自动决定是否需要出现滚动条，而设为GTK_POLICY_ALWAYS，将一直显示一个滚动条。
     * 第1个是上面新创建的滚动窗口句柄，第2个是设置水平滚动条为自动显示，第3个是垂直滚动条为一直显示。*/
    gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_window),
                                    GTK_POLICY_AUTOMATIC, GTK_POLICY_ALWAYS);
    /*注意：对话框窗口内部已经包含了一个vbox控件 */
    gtk_box_pack_start (GTK_BOX (GTK_DIALOG(window)->vbox), scrolled_window,
                            TRUE, TRUE, 0);
    gtk_widget_show (scrolled_window);

    /* 创建一个包含10×10个格子的table控件： */
    table = gtk_table_new (10, 10, FALSE);
    /* 设置x和y方向的行间间距为10像素 */
    gtk_table_set_row_spacings (GTK_TABLE (table), 10);
    gtk_table_set_col_spacings (GTK_TABLE (table), 10);
    /* 将table控件添加到滚动窗口中 */
    gtk_scrolled_window_add_with_viewport (GTK_SCROLLED_WINDOW (scrolled_window), table);
    gtk_widget_show (table);

    /* 简单地在表格中添加许多开关按钮以展示滚动窗口 */
    for (i = 0; i < 10; i++)
    {
       for (j = 0; j < 10; j++)
        {
            sprintf (buffer, "button (%d,%d)\n", i, j);

            //新建带标签的按钮：
            button = gtk_toggle_button_new_with_label (buffer);
            //将新建的按钮添加到table控件中：
            gtk_table_attach_defaults (GTK_TABLE (table), button,
                                             i, i+1, j, j+1);
            gtk_widget_show (button);
       }
    }

    /* 在对话框的底部添加一个"close"按钮 */
    button = gtk_button_new_with_label ("close");
    g_signal_connect_swapped (G_OBJECT (button), "clicked",
                                      G_CALLBACK (gtk_widget_destroy),
                                      window);
    /* 让按钮能被缺省 */
    GTK_WIDGET_SET_FLAGS (button, GTK_CAN_DEFAULT);
    gtk_box_pack_start (GTK_BOX (GTK_DIALOG (window)->action_area), button, TRUE, TRUE, 0);

    /* 将按钮固定为缺省按钮，只要按回车键就相当于点击了这个按钮 */
    gtk_widget_grab_default (button);
    gtk_widget_show (button);

    gtk_widget_show (window);

    gtk_main();

    return 0;
}

尝试改变窗口的大小，可以看到滚动条是如何起作用的。还可以用 gtk_widget_set_size_request() 函数设置窗口或其它控件的缺省尺寸。