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

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

Since: 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 в другой блокнот или виджет.

Обратите внимание, что два блокнота должны разделят общий идентификатор группы (см. 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