如果想要將一個視窗分成兩個部分，可以使用窗格視窗元件(The paned window widgets)。視窗兩部分的尺寸由用戶控制，它們之間有一個凹槽，上面有一個把手，用戶可以拖動此把手改變兩部分的比例。視窗劃分可以是水平 (HPaned)或垂直的(VPaned)。
用以下函式之一創建一個新的窗格視窗：
GtkWidget *gtk_hpaned_new (void); GtkWidget *gtk_vpaned_new (void); |
創建了窗格視窗元件後，可以在它的兩邊添加子元件。用下面的函式完成：
void gtk_paned_add1 (GtkPaned *paned, GtkWidget *child); void gtk_paned_add2 (GtkPaned *paned, GtkWidget *child); |
gtk_paned_add1()將子元件添加到窗格視窗的左邊或頂部。gtk_paned_add2()將子元件添加到窗格視窗的右邊或下部。
在下面的範例中，創建了一個假想的email程式的用戶介面。視窗被垂直劃分為兩個部分，上面部分顯示一個email訊息列表，下部顯示email文字訊息。程式大部分都是漂亮直接的。有兩點要注意：在文字元件實現(realized)前文字不能加到文字元件中。但你可以呼叫 gtk_widget_realize() 函式完成，不過，作為一個可變通技巧的展示，我們為元件的 “realize” 信號設置一個信號處理函式，並在這個函式裡面添加文字。還有，我們需要新增GTK_SHRINK選項到包含有文字視窗和其捲軸的表格(table)裡的一些項目中，以便當視窗的下面部分變小時，下部的元件能夠自動地縮小，而不是被壓到視窗的底部去，只部分顯示。
#include <stdio.h>
#include <gtk/gtk.h>
/* 創建一個"訊息"列表" */
static GtkWidget *create_list( void )
{
GtkWidget *scrolled_window;
GtkWidget *tree_view;
GtkListStore *model;
GtkTreeIter iter;
GtkCellRenderer *cell;
GtkTreeViewColumn *column;
int i;
/* 創建一個新的捲動視窗(scrolled window)，只有需要時，捲軸才出現 */
scrolled_window = gtk_scrolled_window_new (NULL, NULL);
gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_window),
GTK_POLICY_AUTOMATIC,
GTK_POLICY_AUTOMATIC);
model = gtk_list_store_new (1, G_TYPE_STRING);
tree_view = gtk_tree_view_new ();
gtk_container_add (GTK_CONTAINER (scrolled_window), tree_view);
gtk_tree_view_set_model (GTK_TREE_VIEW (tree_view), GTK_TREE_MODEL (model));
gtk_widget_show (tree_view);
/* 在視窗中添加一些訊息 */
for (i = 0; i < 10; i++) {
gchar *msg = g_strdup_printf ("Message #%d", i);
gtk_list_store_append (GTK_LIST_STORE (model), &iter);
gtk_list_store_set (GTK_LIST_STORE (model),
&iter,
0, msg,
-1);
g_free (msg);
}
cell = gtk_cell_renderer_text_new ();
column = gtk_tree_view_column_new_with_attributes ("Messages",
cell,
"text", 0,
NULL);
gtk_tree_view_append_column (GTK_TREE_VIEW (tree_view),
GTK_TREE_VIEW_COLUMN (column));
return scrolled_window;
}
/* 向文字元件中添加一些文字 - 這是當視窗被實現(realized)時呼叫的回呼函式。
* 我們也可以用 gtk_widget_realize 強行將視窗實現，但這必須在它的層次關係
* 確定後(be part of a hierarchy)才行。 */
// 譯者註： 元件的層次關係就是其parent被確定。將一個子元件加到一個容器中
// 時，其parent就是這個容器。層次關係被確定要求，其parent的parent...也
// 確定了。頂層視窗可以不要parent。這是我的經驗理解。
static void insert_text( GtkTextBuffer *buffer )
{
GtkTextIter iter;
gtk_text_buffer_get_iter_at_offset (buffer, &iter, 0);
gtk_text_buffer_insert (buffer, &iter,
"From: pathfinder@nasa.govn"
"To: mom@nasa.govn"
"Subject: Made it!n"
"n"
"We just got in this morning. The weather has beenn"
"great - clear but cold, and there are lots of fun sights.n"
"Sojourner says hi. See you soon.n"
" -Pathn", -1);
}
/* 創建一個捲動文字區域，用於顯示一個"訊息" */
static GtkWidget *create_text( void )
{
GtkWidget *scrolled_window;
GtkWidget *view;
GtkTextBuffer *buffer;
view = gtk_text_view_new ();
buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (view));
scrolled_window = gtk_scrolled_window_new (NULL, NULL);
gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_window),
GTK_POLICY_AUTOMATIC,
GTK_POLICY_AUTOMATIC);
gtk_container_add (GTK_CONTAINER (scrolled_window), view);
insert_text (buffer);
gtk_widget_show_all (scrolled_window);
return scrolled_window;
}
int main( int argc,
char *argv[] )
{
GtkWidget *window;
GtkWidget *vpaned;
GtkWidget *list;
GtkWidget *text;
gtk_init (&argc, &argv);
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
gtk_window_set_title (GTK_WINDOW (window), "Paned Windows");
g_signal_connect (window, "destroy",
G_CALLBACK (gtk_main_quit), NULL);
gtk_container_set_border_width (GTK_CONTAINER (window), 10);
gtk_widget_set_size_request (GTK_WIDGET (window), 450, 400);
/* 在頂層視窗上添加一個垂直窗格視窗元件 */
vpaned = gtk_vpaned_new ();
gtk_container_add (GTK_CONTAINER (window), vpaned);
gtk_widget_show (vpaned);
/* 在窗格視窗的兩部分各添加一些元件 */
list = create_list ();
gtk_paned_add1 (GTK_PANED (vpaned), list);
gtk_widget_show (list);
text = create_text ();
gtk_paned_add2 (GTK_PANED (vpaned), text);
gtk_widget_show (text);
gtk_widget_show (window);
gtk_main ();
return 0;
}
2 則留言