笔记本控件,可以让用户标签式地切换多个界面。当我们需要多窗口切换时,使用笔记本控件是一个明智的选择。

GTK常用控件之笔记本控件( GtkNotebook )_一步一步学习GTK+


笔记本控件的创建:

GtkWidget *gtk_notebook_new(void);

返回值:笔记本控件指针


设置页标签的位置:

void gtk_notebook_set_tab_pos( GtkNotebook *notebook, 

GtkPositionType pos );

notebook:笔记本控件

pos取值如下:

GTK_POS_LEFT:   左
GTK_POS_RIGHT:  右
GTK_POS_TOP:    上
GTK_POS_BOTTOM: 下



追加页面:


gint gtk_notebook_append_page(



GtkNotebook *notebook, 

GtkWidget *child, 

GtkWidget *tab_label );



notebook: 容纳别的控件的笔记本
child:       放在笔记本页面里的子控件
tab_label:要添加页面的标题名


返回值:成功返回值页面值(从0开始),失败返回-1




在指定位置添加页面(从0开始):


gint gtk_notebook_insert_page(


GtkNotebook *notebook,

GtkWidget *child, 

GtkWidget *tab_label,

gint position );



notebook: 容纳别的控件的笔记本
child:       放在笔记本页面里的子控件
tab_label:要添加页面的标题名



position:页面的位置,从0开始,如果-1代表添加到最后



返回值:成功返回值页面值(从0开始),失败返回-1






设置起始页,从0开始算,相当于设置第几个页面显示:


void gtk_notebook_set_current_page(

GtkNotebook *notebook, 

gint page_num );



notebook:要设置的笔记本控件


page_num:页面数




常用信号:"switch-page"


当切换页面时,会触发"switch-page"信号




例子代码如下:


#include <gtk/gtk.h>

// "switch-page"信号处理函数,page_num指第几个页面,从0开始
void deal_switch_pape(GtkNotebook *notebook, gpointer page,
guint page_num, gpointer user_data)
{
printf("我是第%d个页面\n", page_num+1);
}

int main( int argc, char *argv[] )
{
gtk_init (&argc, &argv); // 初始化

GtkWidget *window = gtk_window_new(GTK_WINDOW_TOPLEVEL); // 创建主窗口
gtk_widget_set_size_request(window, 400, 300); //设置窗口大小

GtkWidget *notebook = gtk_notebook_new(); // 创建笔记本控件
gtk_container_add(GTK_CONTAINER(window), notebook); // 笔记本放进窗口

// 页标签的位置,可以有四种位置:上、下、左或右。
gtk_notebook_set_tab_pos(GTK_NOTEBOOK (notebook), GTK_POS_TOP); //上面


// 第一个页面
GtkWidget *label = gtk_label_new("Page one"); //创建标签
GtkWidget *box = gtk_hbox_new(TRUE, 5); // 创建布局
GtkWidget *button_one = gtk_button_new_with_label("我是第一个页面");
GtkWidget *button_two = gtk_button_new_with_label("我是第一个页面的按钮");
gtk_container_add(GTK_CONTAINER(box), button_one);
gtk_container_add(GTK_CONTAINER(box), button_two);

/* gtk_notebook_append_page( GtkNotebook *notebook, GtkWidget *child,
* GtkWidget *tab_label );
* 插入页面到笔记本的后端(append)或前端(prepend)来添加页面。
* child是放在笔记本页面里的子控件,它必须另外创建,一般是容器
* tab_label是要添加的页面的标签。
*/
gtk_notebook_append_page(GTK_NOTEBOOK(notebook), box, label);

// 第二个页面
label = gtk_label_new("Page two"); //创建标签
box = gtk_hbox_new(TRUE, 5); // 创建布局
button_one = gtk_button_new_with_label("我是第二个页面");
button_two = gtk_button_new_with_label("我是第二个页面的按钮");
gtk_container_add(GTK_CONTAINER(box), button_one);
gtk_container_add(GTK_CONTAINER(box), button_two);
gtk_notebook_append_page(GTK_NOTEBOOK(notebook), box, label);

// 第三个页面,在指定位置添加页面,从0开始
button_one = gtk_button_new_with_label("我是通过insert_page实现的,第三个页面");
label = gtk_label_new("Page three");
gtk_notebook_insert_page(GTK_NOTEBOOK(notebook), button_one, label, 2);

// 处理信号,当切换页面时,会触发"switch-page"信号
g_signal_connect(notebook, "switch-page",
G_CALLBACK(deal_switch_pape), NULL);

gtk_widget_show_all(window); //显示所有控件

// 设置起始页(第2页),从0开始算,相当于设置第2个页面显示
gtk_notebook_set_current_page(GTK_NOTEBOOK(notebook), 1);

gtk_main(); // 主事件循环

return 0;
}



程序运行效果图如下:


GTK常用控件之笔记本控件( GtkNotebook )_GTK入门学习_02