GtkNotebook

gtk_notebook_new ()

GtkWidget *
gtk_notebook_new (void);

Создаёт новый виджет GtkNotebook без страниц.

gtk_notebook_get_page ()

GtkNotebookPage *
gtk_notebook_get_page (GtkNotebook *notebook,
                       GtkWidget *child);

Возвращает GtkNotebookPage для child.

gtk_notebook_get_pages ()

GListModel *
gtk_notebook_get_pages (GtkNotebook *notebook);

Возвращает GListModel, содержащий страницы виджета, что позволяет поддерживать актуальный вид.

gtk_notebook_page_get_child ()

GtkWidget *
gtk_notebook_page_get_child (GtkNotebookPage *page);

Возвращает дочерний элемент виджета, которому принадлежит page.

gtk_notebook_append_page ()

int
gtk_notebook_append_page (GtkNotebook *notebook,
                          GtkWidget *child,
                          GtkWidget *tab_label);

Добавляет страницу к notebook.

gtk_notebook_append_page_menu ()

int
gtk_notebook_append_page_menu (GtkNotebook *notebook,
                               GtkWidget *child,
                               GtkWidget *tab_label,
                               GtkWidget *menu_label);

Добавляет страницу к notebook, указывая виджет для использования в контекстном меню.

gtk_notebook_prepend_page ()

int
gtk_notebook_prepend_page (GtkNotebook *notebook,
                           GtkWidget *child,
                           GtkWidget *tab_label);

Вставляет страницу в начало notebook.

gtk_notebook_prepend_page_menu ()

int
gtk_notebook_prepend_page_menu (GtkNotebook *notebook,
                                GtkWidget *child,
                                GtkWidget *tab_label,
                                GtkWidget *menu_label);

Вставляет страницу в начало notebook, указывая виджет для использования в контекстном меню.

gtk_notebook_insert_page ()

int
gtk_notebook_insert_page (GtkNotebook *notebook,
                          GtkWidget *child,
                          GtkWidget *tab_label,
                          int position);

Вставить страницу в notebook в заданной позиции.

gtk_notebook_insert_page_menu ()

int
gtk_notebook_insert_page_menu (GtkNotebook *notebook,
                               GtkWidget *child,
                               GtkWidget *tab_label,
                               GtkWidget *menu_label,
                               int position);

Вставляет страницу в notebook в заданной позиции, указывая виджет для использования в качестве метки в всплывающем меню.

gtk_notebook_remove_page ()

void
gtk_notebook_remove_page (GtkNotebook *notebook,
                          int page_num);

Удаляет страницу из блокнота по заданному индексу в блокноте.

gtk_notebook_detach_tab ()

void
gtk_notebook_detach_tab (GtkNotebook *notebook,
                         GtkWidget *child);

Удаляет дочерний элемент из блокнота.

Эта функция очень похожа на gtk_notebook_remove_page(), но дополнительно сообщает блокноту, что удаление происходит в рамках операции перетаскивания вкладки, которая не должна отменяться.

gtk_notebook_page_num ()

int
gtk_notebook_page_num (GtkNotebook *notebook,
                       GtkWidget *child);

Определяет индекс страницы, содержащей данный виджет дочернего элемента.

gtk_notebook_next_page ()

void
gtk_notebook_next_page (GtkNotebook *notebook);

Переключается на следующую страницу. Ничего не происходит, если текущая страница — последняя.

gtk_notebook_prev_page ()

void
gtk_notebook_prev_page (GtkNotebook *notebook);

Переключается на предыдущую страницу. Ничего не происходит, если текущая страница — первая.

gtk_notebook_reorder_child ()

void
gtk_notebook_reorder_child (GtkNotebook *notebook,
                            GtkWidget *child,
                            int position);

Изменяет порядок страницы, содержащей child, так, чтобы она отображалась в позиции position. Если position больше или равно количеству дочерних элементов в списке или отрицательно, child будет перемещена в конец списка.

gtk_notebook_set_tab_pos ()

void
gtk_notebook_set_tab_pos (GtkNotebook *notebook,
                          GtkPositionType pos);

Устанавливает край, на котором отображаются вкладки для переключения страниц в блокноте.

gtk_notebook_set_show_tabs ()

void
gtk_notebook_set_show_tabs (GtkNotebook *notebook,
                            gboolean show_tabs);

Устанавливает, показывать ли вкладки в блокноте.

gtk_notebook_set_show_border ()

void
gtk_notebook_set_show_border (GtkNotebook *notebook,
                              gboolean show_border);

Устанавливает, будет ли отрисовываться скос вокруг страниц записной книжки. Это оказывает визуальный эффект только в том случае, если вкладки не отображаются. Смотрите gtk_notebook_set_show_tabs().

gtk_notebook_set_scrollable ()

void
gtk_notebook_set_scrollable (GtkNotebook *notebook,
                             gboolean scrollable);

Устанавливает, будет ли область меток вкладок иметь стрелки прокрутки, если слишком много вкладок, чтобы поместиться в области.

gtk_notebook_popup_enable ()

void
gtk_notebook_popup_enable (GtkNotebook *notebook);

Включает всплывающее меню: если пользователь щелкает правой кнопкой мыши по меткам вкладок, появится меню со всеми страницами.

gtk_notebook_popup_disable ()

void
gtk_notebook_popup_disable (GtkNotebook *notebook);

Отключает всплывающее меню.

gtk_notebook_get_current_page ()

int
gtk_notebook_get_current_page (GtkNotebook *notebook);

Возвращает номер страницы текущей страницы.

gtk_notebook_get_menu_label ()

GtkWidget *
gtk_notebook_get_menu_label (GtkNotebook *notebook,
                             GtkWidget *child);

Извлекает виджет метки меню страницы, содержащей child .

gtk_notebook_get_nth_page ()

GtkWidget *
gtk_notebook_get_nth_page (GtkNotebook *notebook,
                           int page_num);

Возвращает дочерний виджет, содержащийся на странице номер page_num .

gtk_notebook_get_n_pages ()

int
gtk_notebook_get_n_pages (GtkNotebook *notebook);

Получает количество страниц в записной книжке.

gtk_notebook_get_tab_label ()

GtkWidget *
gtk_notebook_get_tab_label (GtkNotebook *notebook,
                            GtkWidget *child);

Возвращает виджет метки вкладки для страницы child . NULL возвращается, если child не находится в notebook или если для child не была специально установлена метка вкладки.

gtk_notebook_set_menu_label ()

void
gtk_notebook_set_menu_label (GtkNotebook *notebook,
                             GtkWidget *child,
                             GtkWidget *menu_label);

Изменяет метку меню для страницы, содержащей child .

gtk_notebook_set_menu_label_text ()

void
gtk_notebook_set_menu_label_text (GtkNotebook *notebook,
                                  GtkWidget *child,
                                  const char *menu_text);

Создает новую метку и устанавливает ее в качестве метки меню child .

gtk_notebook_set_tab_label ()

void
gtk_notebook_set_tab_label (GtkNotebook *notebook,
                            GtkWidget *child,
                            GtkWidget *tab_label);

Изменяет метку вкладки для child . Если NULL указано для tab_label , то страница будет иметь метку «страница N».

gtk_notebook_set_tab_label_text ()

void
gtk_notebook_set_tab_label_text (GtkNotebook *notebook,
                                 GtkWidget *child,
                                 const char *tab_text);

Создаёт новую метку и устанавливает её как метку вкладки для страницы, содержащей child.

gtk_notebook_set_tab_reorderable ()

void
gtk_notebook_set_tab_reorderable (GtkNotebook *notebook,
                                  GtkWidget *child,
                                  gboolean reorderable);

Устанавливает, можно ли переупорядочить вкладку с помощью перетаскивания.

gtk_notebook_set_tab_detachable ()

void
gtk_notebook_set_tab_detachable (GtkNotebook *notebook,
                                 GtkWidget *child,
                                 gboolean detachable);

Устанавливает, можно ли отсоединить вкладку от notebook и переместить её в другую закладку или виджет.

Обратите внимание, что 2 закладки должны принадлежать к одной группе (см. gtk_notebook_set_group_name()), чтобы разрешить автоматический обмен вкладками между ними.

Если вы хотите, чтобы виджет взаимодействовал с закладкой через перетаскивание (например, принимать перетаскиваемые вкладки из него), он должен быть установлен в качестве приемника и принимать целевой тип «GTK_NOTEBOOK_TAB». Закладка заполнит выборку значением GtkWidget**, указывающим на дочерний виджет, соответствующий перетаскиваемой вкладке.

Обратите внимание, что для удаления вкладки из исходной закладки в процессе приема перетаскивания следует использовать gtk_notebook_detach_tab() вместо gtk_notebook_remove_page(). В противном случае исходная закладка посчитает, что перетаскиваемая вкладка была удалена во время операции перетаскивания, и начнёт анимацию отмены перетаскивания.

<object class="GtkNotebook">
  <child>
    <object class="GtkLabel" id="notebook-content">
      <property name="label">Content</property>
    </object>
  </child>
  <child type="tab">
    <object class="GtkLabel" id="notebook-tab">
      <property name="label">Tab</property>
    </object>
  </child>
</object>

Если вы хотите, чтобы закладка принимала перетаскивания из других виджетов, вам придётся реализовать свою собственную логику перетаскивания.

gtk_notebook_get_menu_label_text ()

const char *
gtk_notebook_get_menu_label_text (GtkNotebook *notebook,
                                  GtkWidget *child);

Возвращает текст метки меню для страницы, содержащей child.

gtk_notebook_get_scrollable ()

gboolean
gtk_notebook_get_scrollable (GtkNotebook *notebook);

Возвращает, отображаются ли стрелки прокрутки для области меток вкладок. См. gtk_notebook_set_scrollable().

gtk_notebook_get_show_border ()

gboolean
gtk_notebook_get_show_border (GtkNotebook *notebook);

Возвращает, отображается ли граница вокруг страниц закладок. См. gtk_notebook_set_show_border().

gtk_notebook_get_show_tabs ()

gboolean
gtk_notebook_get_show_tabs (GtkNotebook *notebook);

Возвращает, отображаются ли вкладки закладки. См. gtk_notebook_set_show_tabs().

gtk_notebook_get_tab_label_text ()

const char *
gtk_notebook_get_tab_label_text (GtkNotebook *notebook,
                                 GtkWidget *child);

Возвращает текст метки вкладки для страницы, содержащей child.

gtk_notebook_get_tab_pos ()

GtkPositionType
gtk_notebook_get_tab_pos (GtkNotebook *notebook);

Возвращает край, на котором нарисованы вкладки для переключения страниц в закладке.

gtk_notebook_get_tab_reorderable ()

gboolean
gtk_notebook_get_tab_reorderable (GtkNotebook *notebook,
                                  GtkWidget *child);

Возвращает, можно ли переупорядочить вкладку с помощью перетаскивания.

gtk_notebook_get_tab_detachable ()

gboolean
gtk_notebook_get_tab_detachable (GtkNotebook *notebook,
                                 GtkWidget *child);

Возвращает, можно ли отсоединить содержимое вкладки от notebook.

gtk_notebook_set_current_page ()

void
gtk_notebook_set_current_page (GtkNotebook *notebook,
                               int page_num);

Переключает на страницу с номером page_num .

Обратите внимание, что по историческим причинам GtkNotebook отказывается переключаться на страницу, пока дочерний виджет не будет видим. Поэтому рекомендуется отобразить дочерние виджеты перед добавлением их в записную книжку.

gtk_notebook_set_group_name ()

void
gtk_notebook_set_group_name (GtkNotebook *notebook,
                             const char *group_name);

Устанавливает имя группы для notebook .

Записные книжки с одинаковыми именами смогут обмениваться вкладками через перетаскивание. Записная книжка с именем группы NULL не сможет обмениваться вкладками ни с какой другой записной книжкой.

gtk_notebook_get_group_name ()

const char *
gtk_notebook_get_group_name (GtkNotebook *notebook);

Возвращает текущее имя группы для notebook .

gtk_notebook_set_action_widget ()

void
gtk_notebook_set_action_widget (GtkNotebook *notebook,
                                GtkWidget *widget,
                                GtkPackType pack_type);

Устанавливает widget в качестве одного из виджетов действий. В зависимости от типа размещения виджет будет помещен перед или после вкладок. Вы можете использовать GtkBox, если вам нужно разместить более одного виджета на одной стороне.

gtk_notebook_get_action_widget ()

GtkWidget *
gtk_notebook_get_action_widget (GtkNotebook *notebook,
                                GtkPackType pack_type);

Получает один из виджетов действий. См. gtk_notebook_set_action_widget().