GTK+ 2.0 教学-窗格视窗元件 Paned Window Widgets

By:
On:
In: LinuxDev

如果想要将一个视窗分成两个部分，可以使用窗格视窗元件(The paned window widgets)。视窗两部分的尺寸由用户控制，它们之间有一个凹槽，上面有一个把手，用户可以拖动此把手改变两部分的比例。视窗划分可以是水平 (HPaned)或垂直的(VPaned)。

[adsense][/adsense]

用以下函式之一创建一个新的窗格视窗：

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.gov\n"
    "To: mom@nasa.gov\n"
    "Subject: Made it!\n"
    "\n"
    "We just got in this morning. The weather has been\n"
    "great - clear but cold, and there are lots of fun sights.\n"
    "Sojourner says hi. See you soon.\n"
    " -Path\n", -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;
}

Comments are closed.