滚动窗口(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_AUTOMATIC或GTK_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() 函数设置窗口或其它构件的缺省尺寸。