GTK+ 2.0 教学-卷动视窗 Scrolled Windows

卷动视窗(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_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>

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() 函式设置视窗或其它元件的预设尺寸。

« 

单元首页

Comments are closed.