卷动视窗(Scrolled windows)用于创建一个可卷动区域,并将其它元件放入其中。可以在卷动视窗中插入任何其它元件,在其内部的元件不论尺寸大小都可以通过卷轴来存取。
[adsense][/adsense]
用下面的函式创建新的卷动视窗。
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> static 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 (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 (button, "clicked", G_CALLBACK (gtk_widget_destroy), window); /* 让按钮能被预设 */ gtk_widget_set_can_default (button, TRUE); gtk_box_pack_start (GTK_BOX (GTK_DIALOG (window)->action_area), button, TRUE, TRUE, 0); /* 将按钮固定为预设按钮,只要ENTER键就相当于点击了这个按钮 */ gtk_widget_grab_default (button); gtk_widget_show (button); gtk_widget_show (window); gtk_main(); return 0; }
尝试改变视窗的大小,可以看到卷轴是如何起作用的。还可以用 gtk_widget_set_size_request() 函式设置视窗或其它元件的预设尺寸。
2 則留言
Comments are closed.