| Каталог документации / Раздел "Программирование, языки" / Оглавление документа |
| |
|
|
GTK+ 2.0 Tutorial |
||
|---|---|---|
|
Container Widgets |
||
Виджет вкладки (NoteBook) - это набор страниц которые размещаются друг над другом и несут в себе различную информацию, только одна страница из набора может быть видима при просмотре. Этот виджет в последнее время стал очень популярным в GUI programming, с его помощью очень удобно показывать блоки однотипной информации разделяя их соответствующим образом.
GtkWidget *gtk_notebook_new( void ); |
Существует достаточно много функций для работы с этим виджетом. Рассмотрим каждую в отдельности ниже.
Сначала рассмотрим индикаторы страниц или "tabs". Индикаторы могут размещаться вверху, внизу, слева или справа.
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 );
|
Эти функции добавляют страницы к набору в конец (append), или в начало (prepend). child - это виджет который размещен в пределах добавляемой страницы, а tab_label - это ярлык добавленной страницы. Дочерний виджет должен быть создан отдельно и может располагаться в другом виджете контейнере, например в таблице.
Третья функция добавления страницы имеет теже параметры что и предыдущие две, а также позволяет определять расположение добавляемой страницы.
void gtk_notebook_insert_page( GtkNotebook *notebook,
GtkWidget *child,
GtkWidget *tab_label,
gint position );
|
Параметр position определяет позицию добавляемой страницы относительно первой из набора, которая имеет позицию ноль (zero).
Зная как можно добавлять страницы, рассмотрим как их можно удалять:
void gtk_notebook_remove_page( GtkNotebook *notebook,
gint page_num );
|
Эта функция удаляет страницу определённую аргументом page_num из набора notebook.
Функция определяющая текущую страницу в наборе:
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 ); |
Следующая функция определяет активную ("active") страницу. Если вы захотите например открыть какую нибудь страницу, то вам нужна будет эта функция. По умолчанию всегда открывается первая страница.
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.
Рассмотрим усовершенствованный пример из estgtk.c, который поставляется вместе с кодом GTK. Эта небольшая программа состоит из набора страниц и шести кнопок. Набор содержит 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)
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);
This forces the widget to redraw itself. */
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);
}
/* с какой страницы открывать набор (page 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),
G_OBJECT (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),
G_OBJECT (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),
(gpointer) 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),
(gpointer) 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),
(gpointer) 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;
}
|
|
Toolbar |
Menu Widget |
|
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |
