📄 x1513.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"><HTML><HEAD><TITLE>笔记本 Notebooks</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+"><LINKREL="HOME"TITLE="GTK+ 2.0 教程"HREF="book1.html"><LINKREL="UP"TITLE="容器构件 Container Widgets"HREF="c1289.html"><LINKREL="PREVIOUS"TITLE="工具栏 Toolbar"HREF="x1465.html"><LINKREL="NEXT"TITLE="菜单构件"HREF="c1562.html"></HEAD><BODYCLASS="SECT1"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLESUMMARY="Header navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><THCOLSPAN="3"ALIGN="center">GTK+ 2.0 教程</TH></TR><TR><TDWIDTH="10%"ALIGN="left"VALIGN="bottom"><AHREF="x1465.html"ACCESSKEY="P"><<< Previous</A></TD><TDWIDTH="80%"ALIGN="center"VALIGN="bottom">容器构件 Container Widgets</TD><TDWIDTH="10%"ALIGN="right"VALIGN="bottom"><AHREF="c1562.html"ACCESSKEY="N">Next >>></A></TD></TR></TABLE><HRALIGN="LEFT"WIDTH="100%"></DIV><DIVCLASS="SECT1"><H1CLASS="SECT1"><ANAME="SEC-NOTEBOOKS">笔记本 Notebooks</H1><P>笔记本构件(The NoteBook Widget)是互相重叠的页面集合，每一页都包含不同的信息，且一次只有一个页面是可见的。该构件在GUI(图形用户接口)编程中很常用。要显示大量的相似信息，同时把它们分别显示时，使用这种构件是一个很好的方法。</P><P>第一个你要知道的函数调用，你可能已经猜到了，是用来创建一个新的笔记本构件。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">GtkWidget *gtk_notebook_new( void );</PRE></TD></TR></TABLE><P>一旦创建了笔记本构件，就可以使用一系列的函数操作该构件。下面将对它们进行分别讨论。</P><P>先看一下怎样定位页面指示器—或称页标签，可以有四种位置：上、下、左或右。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_notebook_set_tab_pos( GtkNotebook *notebook, GtkPositionType pos );</PRE></TD></TR></TABLE><P>GtkPositionType参数可以取以下几个值，从字面上很容易理解它们的含义：</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING"> GTK_POS_LEFT GTK_POS_RIGHT GTK_POS_TOP GTK_POS_BOTTOM</PRE></TD></TR></TABLE><P><TTCLASS="LITERAL">GTK_POS_TOP</TT>是缺省值。</P><P>下面看一下怎样向笔记本中添加页面。有三种方法向笔记本中添加页面。前两种方法是非常相似的。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_notebook_append_page( GtkNotebook *notebook, GtkWidget *child, GtkWidget *tab_label );void gtk_notebook_prepend_page( GtkNotebook *notebook, GtkWidget *child, GtkWidget *tab_label );</PRE></TD></TR></TABLE><P>这些函数通过向插入页面到笔记本的后端（append）或前端（prepend）来添加页面。<TTCLASS="LITERAL">child</TT>是放在笔记本页面里的子构件，<TTCLASS="LITERAL">tab_label</TT>是要添加的页面的标签。<TTCLASS="LITERAL">child</TT>构件必须另外创建，一般是一个包含一套选项设置的容器构件，比如一个表格。</P><P>最后一个添加页面的函数与前两个函数类似，不过允许指定页面插入的位置。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_notebook_insert_page( GtkNotebook *notebook, GtkWidget *child, GtkWidget *tab_label, gint position );</PRE></TD></TR></TABLE><P>其中的参数与_append_和_prepend_函数一样，还包含一个额外参数，<TTCLASS="LITERAL">position</TT>。该参数指定页面应该插入到哪一页。注意，第一页位置为0。</P><P>前面介绍了怎样添加一个页面，下面介绍怎样从笔记本中删除一个页面。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_notebook_remove_page( GtkNotebook *notebook, gint page_num );</PRE></TD></TR></TABLE><P>这个函数从<TTCLASS="LITERAL">notebook</TT>指定的笔记本中删除由<TTCLASS="LITERAL">page_num</TT>参数指定的页面。</P><P>用这个函数找出笔记本的当前页面：</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">gint gtk_notebook_get_current_page( GtkNotebook *notebook );</PRE></TD></TR></TABLE><P>下面两个函数将笔记本的页面向前或向后移动。对要操作的笔记本构件使用以下函数就可以了。注意：当笔记本正在最后一页时，调用 gtk_notebook_next_page() 函数，笔记本会跳到第一页。同样，如果笔记本在第一页，调用了函数 gtk_notebook_prev_page()，笔记本构件会跳到最后一页。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_notebook_next_page( GtkNoteBook *notebook );void gtk_notebook_prev_page( GtkNoteBook *notebook );</PRE></TD></TR></TABLE><P>下面这个函数设置“活动”页面。比如你想笔记本的第5页被打开，你将使用这个函数。不使用这个函数时笔记本默认显示第一页。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_notebook_set_current_page( GtkNotebook *notebook, gint page_num );</PRE></TD></TR></TABLE><P>下面两个函数分别显示或隐藏笔记本的页标签以及它的边框。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_notebook_set_show_tabs( GtkNotebook *notebook, gboolean show_tabs );void gtk_notebook_set_show_border( GtkNotebook *notebook, gboolean show_border );</PRE></TD></TR></TABLE><P>如果页面较多，标签页在页面上排列不下时，可以用下面这个函数。它允许用两个箭头按钮来滚动标签页。</P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_notebook_set_scrollable( GtkNotebook *notebook, gboolean scrollable );</PRE></TD></TR></TABLE><P><TTCLASS="LITERAL">show_tabs</TT>, <TTCLASS="LITERAL">show_border</TT>和<TTCLASS="LITERAL">scrollable</TT>参数可以为 TRUE 或 FALSE。</P><P>下面看一个示例，它由 GTK 发布版附带的<TTCLASS="FILENAME">testgtk.c</TT>扩展而来。这个小程序创建了一个含一个笔记本构件和6个按钮的窗口。笔记本包含11页，由三种方式添加进来：追加、插入、前插。点击按钮可以改变页标签的位置，显示/隐藏页标签和边框，删除一页，向前或向后移动标签页，以及退出程序。</P><P><SPANCLASS="INLINEMEDIAOBJECT"><IMGSRC="images/notebook.png"></SPAN></P><TABLEBORDER="0"BGCOLOR="#E0E0E0"WIDTH="100%"><TR><TD><PRECLASS="PROGRAMLISTING"> #include <stdio.h>#include <gtk/gtk.h>/* 这个函数旋转页标签的位置 */void rotate_book( GtkButton *button, GtkNotebook *notebook ){ gtk_notebook_set_tab_pos (notebook, (notebook->tab_pos + 1) % 4);}/* 显示/隐藏页标签和边框 */void tabsborder_book( GtkButton *button, GtkNotebook *notebook ){ gint tval = FALSE; gint bval = FALSE; if (notebook->show_tabs == 0) tval = TRUE; if (notebook->show_border == 0) bval = TRUE; gtk_notebook_set_show_tabs (notebook, tval); gtk_notebook_set_show_border (notebook, bval);}/* 从笔记本上删除一个页面 */void remove_book( GtkButton *button, GtkNotebook *notebook ){ gint page; page = gtk_notebook_get_current_page (notebook); gtk_notebook_remove_page (notebook, page); /* 需要刷新构件 -- 这会迫使构件重绘自身。 */ gtk_widget_queue_draw (GTK_WIDGET (notebook));}gint delete( GtkWidget *widget, GtkWidget *event, gpointer data ){ gtk_main_quit (); return FALSE;}int main( int argc, char *argv[] ){ GtkWidget *window; GtkWidget *button; GtkWidget *table; GtkWidget *notebook; GtkWidget *frame; GtkWidget *label; GtkWidget *checkbutton; int i; char bufferf[32]; char bufferl[32]; gtk_init (&argc, &argv); window = gtk_window_new (GTK_WINDOW_TOPLEVEL); g_signal_connect (G_OBJECT (window), "delete_event", G_CALLBACK (delete), NULL); gtk_container_set_border_width (GTK_CONTAINER (window), 10); table = gtk_table_new (3, 6, FALSE); gtk_container_add (GTK_CONTAINER (window), table); /* 创建一个新的笔记本，将标签页放在顶部 */ notebook = gtk_notebook_new (); gtk_notebook_set_tab_pos (GTK_NOTEBOOK (notebook), GTK_POS_TOP); gtk_table_attach_defaults (GTK_TABLE (table), notebook, 0, 6, 0, 1); gtk_widget_show (notebook); /* 在笔记本后面追加几个页面 */ for (i = 0; i < 5; i++) { sprintf(bufferf, "Append Frame %d", i + 1); sprintf(bufferl, "Page %d", i + 1); frame = gtk_frame_new (bufferf); gtk_container_set_border_width (GTK_CONTAINER (frame), 10); gtk_widget_set_size_request (frame, 100, 75); gtk_widget_show (frame); label = gtk_label_new (bufferf); gtk_container_add (GTK_CONTAINER (frame), label); gtk_widget_show (label); label = gtk_label_new (bufferl); gtk_notebook_append_page (GTK_NOTEBOOK (notebook), frame, label); } /* 在指定位置添加页面 */ checkbutton = gtk_check_button_new_with_label ("Check me please!"); gtk_widget_set_size_request (checkbutton, 100, 75); gtk_widget_show (checkbutton); label = gtk_label_new ("Add page"); gtk_notebook_insert_page (GTK_NOTEBOOK (notebook), checkbutton, label, 2); /* 最后向笔记本前插页面 */ for (i = 0; i < 5; i++) { sprintf (bufferf, "Prepend Frame %d", i + 1); sprintf (bufferl, "PPage %d", i + 1); frame = gtk_frame_new (bufferf); gtk_container_set_border_width (GTK_CONTAINER (frame), 10); gtk_widget_set_size_request (frame, 100, 75); gtk_widget_show (frame); label = gtk_label_new (bufferf); gtk_container_add (GTK_CONTAINER (frame), label); gtk_widget_show (label); label = gtk_label_new (bufferl); gtk_notebook_prepend_page (GTK_NOTEBOOK (notebook), frame, label); } /* 设置起始页(第4页) */ gtk_notebook_set_current_page (GTK_NOTEBOOK (notebook), 3); /* 创建一排按钮 */ button = gtk_button_new_with_label ("close"); g_signal_connect_swapped (G_OBJECT (button), "clicked", G_CALLBACK (delete), NULL); gtk_table_attach_defaults (GTK_TABLE (table), button, 0, 1, 1, 2); gtk_widget_show (button); button = gtk_button_new_with_label ("next page"); g_signal_connect_swapped (G_OBJECT (button), "clicked", G_CALLBACK (gtk_notebook_next_page), notebook); gtk_table_attach_defaults (GTK_TABLE (table), button, 1, 2, 1, 2); gtk_widget_show (button); button = gtk_button_new_with_label ("prev page"); g_signal_connect_swapped (G_OBJECT (button), "clicked", G_CALLBACK (gtk_notebook_prev_page), notebook); gtk_table_attach_defaults (GTK_TABLE (table), button, 2, 3, 1, 2); gtk_widget_show (button); button = gtk_button_new_with_label ("tab position"); g_signal_connect (G_OBJECT (button), "clicked", G_CALLBACK (rotate_book), notebook); gtk_table_attach_defaults (GTK_TABLE (table), button, 3, 4, 1, 2); gtk_widget_show (button); button = gtk_button_new_with_label ("tabs/border on/off"); g_signal_connect (G_OBJECT (button), "clicked", G_CALLBACK (tabsborder_book), notebook); gtk_table_attach_defaults (GTK_TABLE (table), button, 4, 5, 1, 2); gtk_widget_show (button); button = gtk_button_new_with_label ("remove page"); g_signal_connect (G_OBJECT (button), "clicked", G_CALLBACK (remove_book), notebook); gtk_table_attach_defaults (GTK_TABLE (table), button, 5, 6, 1, 2); gtk_widget_show (button); gtk_widget_show (table); gtk_widget_show (window); gtk_main (); return 0;}</PRE></TD></TR></TABLE><P>我希望这些能帮你在你自己的应用程序中创建笔记本。</P></DIV><DIVCLASS="NAVFOOTER"><HRALIGN="LEFT"WIDTH="100%"><TABLESUMMARY="Footer navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top"><AHREF="x1465.html"ACCESSKEY="P"><<< Previous</A></TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="book1.html"ACCESSKEY="H">Home</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top"><AHREF="c1562.html"ACCESSKEY="N">Next >>></A></TD></TR><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top">工具栏 Toolbar</TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="c1289.html"ACCESSKEY="U">Up</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top">菜单构件</TD></TR></TABLE></DIV></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -