我的书签
添加书签
移除书签前言
我发现在Gtk+这种风格叫Note Book，在C#中它们被称作 TabPage 。
笔记本 Notebooks
笔记本控件(The NoteBook Widget)是互相重叠的页面集合，每一页都包含不同的信息，且一次只有一个页面是可见的。
笔记本控件在GUI(图形用户接口)编程中很常用，如果我们想要显示大量的相似信息，同时把它们分别显示时，使用这种控件是一个很好的方法。
创建笔记本控件
第一个你要知道的函数调用，你可能已经猜到了，是用来创建一个新的笔记本控件。
GtkWidget *gtk_notebook_new( void );一旦创建了笔记本控件，就可以使用一系列的函数操作该控件。下面将对它们进行分别讨论。
设置页标签方向
先看一下怎样定位页面指示器—或称页标签，可以有四种位置：上、下、左或右。
void gtk_notebook_set_tab_pos( GtkNotebook *notebook,
GtkPositionType pos ); GtkPositionType参数可以取以下几个值，从字面上很容易理解它们的含义：
GTK_POS_LEFT
GTK_POS_RIGHT
GTK_POS_TOP
GTK_POS_BOTTOM GTK_POS_TOP是缺省值。
追加页标签
下面看一下怎样向笔记本中添加页面。有三种方法向笔记本中添加页面。前两种方法是非常相似的。
void gtk_notebook_append_page( GtkNotebook *notebook,
GtkWidget *child,
GtkWidget *tab_label );
void gtk_notebook_prepend_page( GtkNotebook *notebook,
GtkWidget *child,
GtkWidget *tab_label );参数:
- child
该参数是放在笔记本页面里的子控件；
child控件必须另外创建，一般是一个包含一套选项设置的容器控件，比如一个表格；- tab_label
该参数是要添加的页面的标签;
这些函数通过向插入页面到笔记本的后端（append）或前端（prepend）来添加页面。
插入标签页
最后一个添加页面的函数与前两个函数类似，不过允许指定页面插入的位置。
void gtk_notebook_insert_page( GtkNotebook *notebook,
GtkWidget *child,
GtkWidget *tab_label,
gint position ); 其中的参数与append和prepend函数一样，还包含一个额外参数，position。该参数指定页面应该插入到哪一页。注意，第一页位置为0。
删除标签页
前面介绍了怎样添加一个页面，下面介绍怎样从笔记本中删除一个页面。
void gtk_notebook_remove_page( GtkNotebook *notebook,
gint page_num );这个函数从notebook指定的笔记本中删除由page_num参数指定的页面。
获取当前的标签页
用这个函数找出笔记本的当前页面：
gint gtk_notebook_get_current_page( GtkNotebook *notebook );下面两个函数将笔记本的页面向前或向后移动。
前后切换标签页
对要操作的笔记本控件使用以下函数就可以了。注意：当笔记本正在最后一页时，调用 gtk_notebook_next_page() 函数，笔记本会跳到第一页。同样，如果笔记本在第一页，调用了函数 gtk_notebook_prev_page()，笔记本控件会跳到最后一页。
void gtk_notebook_next_page( GtkNoteBook *notebook );
void gtk_notebook_prev_page( GtkNoteBook *notebook );直接选择标签页
下面这个函数设置“活动”页面。比如你想笔记本的第5页被打开，你将使用这个函数。不使用这个函数时笔记本默认显示第一页。
void gtk_notebook_set_current_page( GtkNotebook *notebook,
gint page_num );显示或隐藏标签页
下面两个函数分别显示或隐藏笔记本的页标签以及它的边框。
void gtk_notebook_set_show_tabs( GtkNotebook *notebook,
gboolean show_tabs );
void gtk_notebook_set_show_border( GtkNotebook *notebook,
gboolean show_border );允许显示箭头按钮滚动标签页
如果页面较多，标签页在页面上排列不下时，可以用下面这个函数。它允许用两个箭头按钮来滚动标签页。
void gtk_notebook_set_scrollable( GtkNotebook *notebook,
gboolean scrollable );
show_tabs, show_border和scrollable参数可以为 TRUE 或 FALSE。示例
功能
这个小程序创建了一个含一个笔记本控件和6个按钮的窗口。笔记本包含11页，由三种方式添加进来：追加、插入、前插。点击按钮可以改变页标签的位置，显示/隐藏页标签和边框，删除一页，向前或向后移动标签页，以及退出程序。
源码
#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);
gtk_window_set_title (GTK_WINDOW (window), "www.softool.cn - notebook");
g_signal_connect (G_OBJECT (window), "delete_event",
G_CALLBACK (delete), NULL);
gtk_container_set_border_width (GTK_CONTAINER (window), 10);
//新建一个 table 控件：
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;
}