捲動視窗(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>
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 則留言