滚动窗口 Scrolled Windows

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

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

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

第一个参数是水平方向的调整对象,第二个参数是垂直方向的调整对象。它们一般都设置为NULL。

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

这个函数可以设置滚动条出现的方式。第一个参数是要设置的滚动窗口,第二个设置水平滚动条出现的方式,第三个参数设置垂直滚动条出现的方式。

滚动条的方式取值可以为GTK_POLICY_AUTOMATICGTK_POLICY_ALWAYS。当要求滚动条根据需要自动出现时, 可设为GTK_POLICY_AUTOMATIC ;若设为GTK_POLICY_ALWAYS,滚动条会一直出现在滚动窗口上。

可以用下面的函数将构件放到滚动窗口里:

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

下面是一个简单示例:在滚动窗口构件中放置一个表格构件,并在表格中放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), "GtkScrolledWindow example");
    gtk_container_set_border_width (GTK_CONTAINER (window), 0);
    gtk_widget_set_size_request (window, 300, 300);
    
    /* 创建一个新的滚动窗口。 */
    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,将一直显示一个滚动条
     * 第一个是设置水平滚动条,第二个是垂直滚动条 */
    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 = 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);
    
    /* 将表格组装到滚动窗口中 */
    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);
	  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() 函数设置窗口或其它构件的缺省尺寸。