GtkNotebook

gtk_notebook_new ()

GtkWidget *
gtk_notebook_new (void);

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

gtk_notebook_append_page ()

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

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

gtk_notebook_append_page_menu ()

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

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

gtk_notebook_prepend_page ()

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

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

gtk_notebook_prepend_page_menu ()

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

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

gtk_notebook_insert_page ()

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

Вставляет страницу в notebook в указанную позицию.

gtk_notebook_insert_page_menu ()

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

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

gtk_notebook_remove_page ()

void
gtk_notebook_remove_page (GtkNotebook *notebook,
                          gint page_num);

Удаляет страницу из записной книжки по её индексу в записной книжке.

gtk_notebook_detach_tab ()

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

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

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

Since: 3.16

gtk_notebook_page_num ()

gint
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,
                            gint 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 ()

gint
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,
                           gint page_num);

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

gtk_notebook_get_n_pages ()

gint
gtk_notebook_get_n_pages (GtkNotebook *notebook);

Возвращает количество страниц в книжной вкладке.

С: 2.2

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 gchar *menu_text);

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

gtk_notebook_set_tab_label ()

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

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

gtk_notebook_set_tab_label_text ()

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

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

gtk_notebook_set_tab_reorderable ()

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

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

С: 2.10

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_container_remove(), если вы хотите удалить вкладку из исходного записного блока в процессе приема перетаскивания. В противном случае исходный записной блок посчитает, что перетаскиваемая вкладка была удалена из-под текущей операции перетаскивания и инициирует анимацию отмены перетаскивания.

<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>

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

С: 2.10

gtk_notebook_get_menu_label_text ()

const gchar *
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 gchar *
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);

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

С: 2.10

gtk_notebook_get_tab_detachable ()

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

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

С версии: 2.10

gtk_notebook_get_tab_hborder ()

guint16
gtk_notebook_get_tab_hborder (GtkNotebook *notebook);

Возвращает горизонтальную ширину границы вкладки.

С версии: 2.22

gtk_notebook_get_tab_vborder ()

guint16
gtk_notebook_get_tab_vborder (GtkNotebook *notebook);

Возвращает вертикальную ширину границы вкладки.

С версии: 2.22

gtk_notebook_set_current_page ()

void
gtk_notebook_set_current_page (GtkNotebook *notebook,
                               gint page_num);

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

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

gtk_notebook_set_group_name ()

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

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

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

С версии: 2.24

gtk_notebook_get_group_name ()

const gchar *
gtk_notebook_get_group_name (GtkNotebook *notebook);

Получает текущее имя группы для notebook.

С версии: 2.24

gtk_notebook_set_action_widget ()

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

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

Обратите внимание, что виджеты действий являются «внутренними» дочерними элементами записной книжки и, следовательно, не включены в список, возвращаемый gtk_container_foreach().

С версии: 2.20

gtk_notebook_get_action_widget ()

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

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

С версии: 2.20