GTK+ 2.0 Tutorial
<<< Previous	Container Widgets	Next >>>

Вкладки (Notebooks)

Виджет вкладки (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;
}

<<< Previous	Home	Next >>>
Toolbar	Up	Menu Widget