gtknotebook

			gtk+ reference manual
top \| description \| object hierarchy \| properties \| child properties \| style properties \| signals

gtknotebook — контейнер содержащий переключающиеся вкладки

краткое описание

#include <gtk/gtk.h>


            gtknotebook;
            gtknotebookpage;
gtkwidget*  gtk_notebook_new                (void);
gint        gtk_notebook_append_page        (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label);
gint        gtk_notebook_append_page_menu   (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label,
                                             gtkwidget *menu_label);
gint        gtk_notebook_prepend_page       (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label);
gint        gtk_notebook_prepend_page_menu  (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label,
                                             gtkwidget *menu_label);
gint        gtk_notebook_insert_page        (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label,
                                             gint position);
gint        gtk_notebook_insert_page_menu   (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label,
                                             gtkwidget *menu_label,
                                             gint position);
void        gtk_notebook_remove_page        (gtknotebook *notebook,
                                             gint page_num);
#define     gtk_notebook_current_page
gint        gtk_notebook_page_num           (gtknotebook *notebook,
                                             gtkwidget *child);
#define     gtk_notebook_set_page
void        gtk_notebook_next_page          (gtknotebook *notebook);
void        gtk_notebook_prev_page          (gtknotebook *notebook);
void        gtk_notebook_reorder_child      (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gint position);
void        gtk_notebook_set_tab_pos        (gtknotebook *notebook,
                                             gtkpositiontype pos);
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);
void        gtk_notebook_set_tab_border     (gtknotebook *notebook,
                                             guint border_width);
void        gtk_notebook_popup_enable       (gtknotebook *notebook);
void        gtk_notebook_popup_disable      (gtknotebook *notebook);
gint        gtk_notebook_get_current_page   (gtknotebook *notebook);
gtkwidget*  gtk_notebook_get_menu_label     (gtknotebook *notebook,
                                             gtkwidget *child);
gtkwidget*  gtk_notebook_get_nth_page       (gtknotebook *notebook,
                                             gint page_num);
gint        gtk_notebook_get_n_pages        (gtknotebook *notebook);
gtkwidget*  gtk_notebook_get_tab_label      (gtknotebook *notebook,
                                             gtkwidget *child);
void        gtk_notebook_query_tab_label_packing
                                            (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gboolean *expand,
                                             gboolean *fill,
                                             gtkpacktype *pack_type);
void        gtk_notebook_set_homogeneous_tabs
                                            (gtknotebook *notebook,
                                             gboolean homogeneous);
void        gtk_notebook_set_menu_label     (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *menu_label);
void        gtk_notebook_set_menu_label_text
                                            (gtknotebook *notebook,
                                             gtkwidget *child,
                                             const gchar *menu_text);
void        gtk_notebook_set_tab_hborder    (gtknotebook *notebook,
                                             guint tab_hborder);
void        gtk_notebook_set_tab_label      (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label);
void        gtk_notebook_set_tab_label_packing
                                            (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gboolean expand,
                                             gboolean fill,
                                             gtkpacktype pack_type);
void        gtk_notebook_set_tab_label_text (gtknotebook *notebook,
                                             gtkwidget *child,
                                             const gchar *tab_text);
void        gtk_notebook_set_tab_vborder    (gtknotebook *notebook,
                                             guint tab_vborder);
void        gtk_notebook_set_tab_reorderable
                                            (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gboolean reorderable);
void        gtk_notebook_set_tab_detachable (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gboolean detachable);
const gchar* gtk_notebook_get_menu_label_text
                                            (gtknotebook *notebook,
                                             gtkwidget *child);
gboolean    gtk_notebook_get_scrollable     (gtknotebook *notebook);
gboolean    gtk_notebook_get_show_border    (gtknotebook *notebook);
gboolean    gtk_notebook_get_show_tabs      (gtknotebook *notebook);
const gchar* gtk_notebook_get_tab_label_text
                                            (gtknotebook *notebook,
                                             gtkwidget *child);
gtkpositiontype gtk_notebook_get_tab_pos    (gtknotebook *notebook);
gboolean    gtk_notebook_get_tab_reorderable
                                            (gtknotebook *notebook,
                                             gtkwidget *child);
gboolean    gtk_notebook_get_tab_detachable (gtknotebook *notebook,
                                             gtkwidget *child);
void        gtk_notebook_set_current_page   (gtknotebook *notebook,
                                             gint page_num);
void        gtk_notebook_set_group_id       (gtknotebook *notebook,
                                             gint group_id);
gint        gtk_notebook_get_group_id       (gtknotebook *notebook);
gtknotebook* (*gtknotebookwindowcreationfunc)
                                            (gtknotebook *source,
                                             gtkwidget *page,
                                             gint x,
                                             gint y,
                                             gpointer data);
void        gtk_notebook_set_window_creation_hook
                                            (gtknotebookwindowcreationfunc func,
                                             gpointer data);

иерархия объектов

  gobject
   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget
                     +----gtkcontainer
                           +----gtknotebook

осуществляемые интерфейсы

gtknotebook осуществляет atkimplementoriface.

свойства

  "enable-popup"         gboolean              : read / write
  "group-id"             gint                  : read / write
  "homogeneous"          gboolean              : read / write
  "page"                 gint                  : read / write
  "scrollable"           gboolean              : read / write
  "show-border"          gboolean              : read / write
  "show-tabs"            gboolean              : read / write
  "tab-border"           guint                 : write
  "tab-hborder"          guint                 : read / write
  "tab-pos"              gtkpositiontype       : read / write
  "tab-vborder"          guint                 : read / write

дочерние свойства

  "detachable"           gboolean              : read / write
  "menu-label"           gchararray            : read / write
  "position"             gint                  : read / write
  "reorderable"          gboolean              : read / write
  "tab-expand"           gboolean              : read / write
  "tab-fill"             gboolean              : read / write
  "tab-label"            gchararray            : read / write
  "tab-pack"             gtkpacktype           : read / write

свойства стиля

  "arrow-spacing"        gint                  : read
  "has-backward-stepper" gboolean              : read
  "has-forward-stepper"  gboolean              : read
  "has-secondary-backward-stepper" gboolean              : read
  "has-secondary-forward-stepper" gboolean              : read
  "tab-curvature"        gint                  : read
  "tab-overlap"          gint                  : read

сигналы

"change-current-page"
            void        user_function      (gtknotebook *notebook,
                                            gint         arg1,
                                            gpointer     user_data)      : run last / action
"focus-tab" gboolean    user_function      (gtknotebook    *notebook,
                                            gtknotebooktab *arg1,
                                            gpointer        user_data)      : run last / action
"move-focus-out"
            void        user_function      (gtknotebook      *notebook,
                                            gtkdirectiontype *arg1,
                                            gpointer          user_data)      : run last / action
"page-added"
            void        user_function      (gtknotebook *notebook,
                                            gtkwidget   *child,
                                            guint        page_num,
                                            gpointer     user_data)      : run last
"page-removed"
            void        user_function      (gtknotebook *notebook,
                                            gtkwidget   *child,
                                            guint        page_num,
                                            gpointer     user_data)      : run last
"page-reordered"
            void        user_function      (gtknotebook *notebook,
                                            gtkwidget   *child,
                                            guint        page_num,
                                            gpointer     user_data)      : run last
"reorder-tab"
            void        user_function      (gtknotebook      *notebook,
                                            gtkdirectiontype *arg1,
                                            gboolean          arg2,
                                            gpointer          user_data)      : run last / action
"select-page"
            gboolean    user_function      (gtknotebook *notebook,
                                            gboolean     arg1,
                                            gpointer     user_data)      : run last / action
"switch-page"
            void        user_function      (gtknotebook     *notebook,
                                            gtknotebookpage *page,
                                            guint            page_num,
                                            gpointer         user_data)      : run last

описание

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

есть много вариантов конфигурации для gtknotebook. помимо прочего, вы можете выбирать с какой стороны должны появляться вкладки (смотрите gtk_notebook_set_tab_pos()), нужно ли организовывать прокручивание вкладок если их слишком много (смотрите gtk_notebook_set_scrollable), и нужно ли всплывающее меню, позволяющее пользователям переключать страницы. (смотрите gtk_notebook_enable_popup(), gtk_noteobook_disable_popup())

детали

gtknotebook

typedef struct _gtknotebook gtknotebook;

gtknotebookpage

typedef struct _gtknotebookpage gtknotebookpage;

gtknotebookpage это непрозрачные детали осуществляемые gtknotebook.

gtk_notebook_new ()

gtkwidget*  gtk_notebook_new                (void);

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

возвращает:

вновь созданный gtknotebook

gtk_notebook_append_page ()

gint        gtk_notebook_append_page        (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label);

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

`notebook` :	gtknotebook
`child` :	gtkwidget используемый как содержимое страницы.
`tab_label` :	gtkwidget используемый как метка для страницы, или null при использовании значения по умолчанию 'page n'.
возвращает:	перечень добавленных в конец контейнера страниц (начинается с 0), или -1 если функция невыполнена.

gtk_notebook_append_page_menu ()

gint        gtk_notebook_append_page_menu   (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label,
                                             gtkwidget *menu_label);

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

`notebook` :	gtknotebook
`child` :	gtkwidget используемый как содержимое страницы.
`tab_label` :	gtkwidget используемый как метка для страницы, или null при использовании значения по умолчанию 'page n'.
`menu_label` :	виджет используемый как метка для меню переключателя страниц, если это возможно. если `null`, и `tab_label` это gtklabel или `null`, то когда ярлык меню будет вновь создан с тем же самым текстом как `tab_label`; если `tab_label` не является gtklabel, должен быть определён `menu_label`, если меню переключателя страниц должно использоваться.
возвращает:	перечень добавленных в конец контейнера страниц (начинается с 0), или -1 если функция невыполнена.

gtk_notebook_prepend_page ()

gint        gtk_notebook_prepend_page       (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label);

добавляет страницы в начало notebook.

`notebook` :	gtknotebook
`child` :	gtkwidget используемый как содержимое страницы.
`tab_label` :	gtkwidget используемый как метка для страницы, или null при использовании значения по умолчанию 'page n'.
возвращает:	перечень добавленных в начало контейнера страниц (начинается с 0), или -1 если функция невыполнена.

gtk_notebook_prepend_page_menu ()

gint        gtk_notebook_prepend_page_menu  (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label,
                                             gtkwidget *menu_label);

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

`notebook` :	gtknotebook
`child` :	gtkwidget используемый как содержимое страницы.
`tab_label` :	gtkwidget используемый как метка для страницы, или null при использовании значения по умолчанию 'page n'.
`menu_label` :	виджет используемый как метка для меню переключателя страниц, если это возможно. если null, и tab_label это gtklabel или null, то когда ярлык меню будет вновь создан с тем же самым текстом как tab_label; если tab_label не является gtklabel, должен быть определён menu_label, если меню переключателя страниц должно использоваться.
возвращает:	перечень добавленных в начало контейнера страниц (начинается с 0), или -1 если функция невыполнена.

gtk_notebook_insert_page ()

gint        gtk_notebook_insert_page        (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label,
                                             gint position);

вставляет страницы в notebook в полученной позиции.

`notebook` :	gtknotebook
`child` :	gtkwidget используемый как содержимое страницы.
`tab_label` :	gtkwidget используемый как метка для страницы, или null при использовании значения по умолчанию 'page n'.
`position` :	перечень вставляемых страниц (начинается с 0), или -1 для добавления страниц после всех остальных.
возвращает:	перечень вставленных страниц (начинается с 0) в контейнер, или -1 если функция не выполнена

gtk_notebook_insert_page_menu ()

gint        gtk_notebook_insert_page_menu   (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label,
                                             gtkwidget *menu_label,
                                             gint position);

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

`notebook` :	gtknotebook
`child` :	gtkwidget используемый как содержимое страницы.
`tab_label` :	gtkwidget используемый как метка для страницы, или null при использовании значения по умолчанию 'page n'.
`menu_label` :	виджет используемый как метка для меню переключателя страниц, если это возможно. если null, и tab_label это gtklabel или null, то когда ярлык меню будет вновь создан с тем же самым текстом как tab_label; если tab_label не является gtklabel, должен быть определён menu_label, если меню переключателя страниц должно использоваться.
`position` :	перечень вставляемых страниц (начинается с 0), или -1 для добавления страниц после всех остальных.
возвращает:	перечень вставленных страниц (начинается с 0) в контейнер, или -1 если функция не выполнена

gtk_notebook_remove_page ()

void        gtk_notebook_remove_page        (gtknotebook *notebook,
                                             gint page_num);

удаляет страницу из контейнера вкладок согласно полученного индекса.

`notebook` :	gtknotebook.
`page_num` :	индекс страниц контейнера вкладок, начинается с 0. если -1, удаляется последняя страница.

gtk_notebook_current_page

#define gtk_notebook_current_page               gtk_notebook_get_current_page

внимание

gtk_notebook_current_page устарела и не нужно её использовать во вновь создаваемом коде.

устаревшая макрокоманда. вместо неё используйте gtk_notebook_get_current_page().

gtk_notebook_page_num ()

gint        gtk_notebook_page_num           (gtknotebook *notebook,
                                             gtkwidget *child);

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

`notebook` :	gtknotebook
`child` :	gtkwidget
возвращает:	указатель страницы содержащей `child`, или -1 если `child` нет в контейнере вкладок.

gtk_notebook_set_page

#define gtk_notebook_set_page                   gtk_notebook_set_current_page

внимание

gtk_notebook_set_page устарела и не нужно её использовать во вновь создаваемом коде.

устаревшая макрокоманда для совместимости. вместо неё используйте gtk_notebook_set_current_page().

gtk_notebook_next_page ()

void        gtk_notebook_next_page          (gtknotebook *notebook);

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

notebook :

gtknotebook

gtk_notebook_prev_page ()

void        gtk_notebook_prev_page          (gtknotebook *notebook);

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

notebook :

gtknotebook

gtk_notebook_reorder_child ()

void        gtk_notebook_reorder_child      (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gint position);

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

`notebook` :	gtknotebook
`child` :	перемещаемый дочерний виджет
`position` :	новая позиция, или -1 для перемещения в конец

gtk_notebook_set_tab_pos ()

void        gtk_notebook_set_tab_pos        (gtknotebook *notebook,
                                             gtkpositiontype pos);

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

`notebook` :	gtknotebook.
`pos` :	сторона для отрисовки вкладок.

gtk_notebook_set_show_tabs ()

void        gtk_notebook_set_show_tabs      (gtknotebook *notebook,
                                             gboolean show_tabs);

устанавливает отображаются ли вкладки в контейнере или нет.

`notebook` :	gtknotebook
`show_tabs` :	`true` если вкладки должны отображаться.

gtk_notebook_set_show_border ()

void        gtk_notebook_set_show_border    (gtknotebook *notebook,
                                             gboolean show_border);

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

`notebook` :	gtknotebook
`show_border` :	`true` если скос должен быть отображен возле вкладок контейнера.

gtk_notebook_set_scrollable ()

void        gtk_notebook_set_scrollable     (gtknotebook *notebook,
                                             gboolean scrollable);

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

`notebook` :	gtknotebook
`scrollable` :	`true` если нужно добавить стрелки для прокручивания

gtk_notebook_set_tab_border ()

void        gtk_notebook_set_tab_border     (gtknotebook *notebook,
                                             guint border_width);

внимание

gtk_notebook_set_tab_border устарела и не нужно её использовать во вновь создаваемом коде.

устанавливает ширину окантовки вокруг меток вкладок в контейнере. это эквивалентно вызову gtk_notebook_set_tab_hborder (notebook, border_width) после gtk_notebook_set_tab_vborder (notebook, border_width).

`notebook` :	gtknotebook
`border_width` :	ширина окантовки вокруг меток вкладок.

gtk_notebook_popup_enable ()

void        gtk_notebook_popup_enable       (gtknotebook *notebook);

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

notebook :

gtknotebook

gtk_notebook_popup_disable ()

void        gtk_notebook_popup_disable      (gtknotebook *notebook);

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

notebook :

gtknotebook

gtk_notebook_get_current_page ()

gint        gtk_notebook_get_current_page   (gtknotebook *notebook);

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

`notebook` :	gtknotebook
возвращает:	индекс текущемй страницы в контейнере вкладок (начиная с 0). если контейнер вкладок не имеет страниц, то возвращается -1.

gtk_notebook_get_menu_label ()

gtkwidget*  gtk_notebook_get_menu_label     (gtknotebook *notebook,
                                             gtkwidget *child);

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

`notebook` :	gtknotebook
`child` :	виджет содержащийся в странице контейнера `notebook`
возвращает:	ярлык меню, или `null` если страница контейнера вкладок не имеет метки меню кроме установленного по умолчанию (метка вкладки).

gtk_notebook_get_nth_page ()

gtkwidget*  gtk_notebook_get_nth_page       (gtknotebook *notebook,
                                             gint page_num);

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

`notebook` :	gtknotebook
`page_num` :	указатель страницы в контейнере вкладок, или -1 для последней страницы.
возвращает:	дочерний виджет, или `null` если `page_num` выходит за пределы.

gtk_notebook_get_n_pages ()

gint        gtk_notebook_get_n_pages        (gtknotebook *notebook);

выдаёт количество страниц в контейнере вкладок.

`notebook` :	gtknotebook
возвращает:	количество страниц в контейнере вкладок.

начиная с версии 2.2

gtk_notebook_get_tab_label ()

gtkwidget*  gtk_notebook_get_tab_label      (gtknotebook *notebook,
                                             gtkwidget *child);

возвращает ярлык вкладки для страницы child. null возвращается если child нет в notebook или если ярлык вкладки не определён для child.

`notebook` :	gtknotebook
`child` :	страница
возвращает:	ярлык вкладки

gtk_notebook_query_tab_label_packing ()

void        gtk_notebook_query_tab_label_packing
                                            (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gboolean *expand,
                                             gboolean *fill,
                                             gtkpacktype *pack_type);

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

`notebook` :	gtknotebook
`child` :	страница
`expand` :	расположение для хранения значения расширения (или null)
`fill` :	расположение для хранения значения заполнения (или null)
`pack_type` :	расположение для хранения pack_type (или null)

gtk_notebook_set_homogeneous_tabs ()

void        gtk_notebook_set_homogeneous_tabs
                                            (gtknotebook *notebook,
                                             gboolean homogeneous);

внимание

gtk_notebook_set_homogeneous_tabs устарела и не нужно её использовать во вновь создаваемом коде.

устанавливает должны ли все вкладки иметь одинаковый размер или нет.

`notebook` :	gtknotebook
`homogeneous` :	`true` если все вкладки должны быть одинакового размера.

gtk_notebook_set_menu_label ()

void        gtk_notebook_set_menu_label     (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *menu_label);

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

`notebook` :	gtknotebook
`child` :	дочерний виджет
`menu_label` :	ярлык меню, или null для значения по умолчанию

gtk_notebook_set_menu_label_text ()

void        gtk_notebook_set_menu_label_text
                                            (gtknotebook *notebook,
                                             gtkwidget *child,
                                             const gchar *menu_text);

создаёт новый ярлык и устанавливает его как ярлык меню для child.

`notebook` :	gtknotebook
`child` :	дочерний виджет
`menu_text` :	текст метки

gtk_notebook_set_tab_hborder ()

void        gtk_notebook_set_tab_hborder    (gtknotebook *notebook,
                                             guint tab_hborder);

внимание

gtk_notebook_set_tab_hborder устарела и не нужно её использовать во вновь создаваемом коде.

устанавливает ширину горизонтальной границы метки вкладок.

`notebook` :	gtknotebook
`tab_hborder` :	ширина горизонтальной границы метки вкладки.

gtk_notebook_set_tab_label ()

void        gtk_notebook_set_tab_label      (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gtkwidget *tab_label);

изменяет метку вкладки для child. если null установлен для tab_label, то когда страница будет иметь ярлык 'page n'.

`notebook` :	gtknotebook
`child` :	страница
`tab_label` :	используемый виджет ярлыка вкладки, или `null` для ярлыка вкладки по умолчанию.

gtk_notebook_set_tab_label_packing ()

void        gtk_notebook_set_tab_label_packing
                                            (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gboolean expand,
                                             gboolean fill,
                                             gtkpacktype pack_type);

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

`notebook` :	gtknotebook
`child` :	дочерний виджет
`expand` :	расширяются ли вкладки или нет
`fill` :	должны ли вкладки заполнять распределённую область или нет
`pack_type` :	позиция вкладки

gtk_notebook_set_tab_label_text ()

void        gtk_notebook_set_tab_label_text (gtknotebook *notebook,
                                             gtkwidget *child,
                                             const gchar *tab_text);

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

`notebook` :	gtknotebook
`child` :	страница
`tab_text` :	текст ярлыка

gtk_notebook_set_tab_vborder ()

void        gtk_notebook_set_tab_vborder    (gtknotebook *notebook,
                                             guint tab_vborder);

внимание

gtk_notebook_set_tab_vborder устарела и не нужно её использовать во вновь создаваемом коде.

устанавливает ширину вертикальной границы ярлыка метки.

`notebook` :	gtknotebook
`tab_vborder` :	ширина вертикальной границы ярлыка вкладки.

gtk_notebook_set_tab_reorderable ()

void        gtk_notebook_set_tab_reorderable
                                            (gtknotebook *notebook,
                                             gtkwidget *child,
                                             gboolean reorderable);

устанавливает может ли вкладка изменять расположение через перетаскивание (drag and drop) или нет.

`notebook` :	gtknotebook
child :	дочерний gtkwidget
`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_id()) позволяющий автоматический обмен вкладками между ними.

если вы хотите чтобы виджет взаимодействовал с контейнером вкладок через dnd (то есть: методом перетаскивания мышкой) он должен быть установлен как адресат перетаскивания и принять цель "gtk_notebook_tab". контейнер вкладок будет заполнять выбранные указатели gtkwidget** для дочерних виджетов которые соответствуют перетаскиваемым вкладкам.

 static void
 on_drop_zone_drag_data_received (gtkwidget        *widget,
                                  gdkdragcontext   *context,
                                  gint              x,
                                  gint              y,
                                  gtkselectiondata *selection_data,
                                  guint             info,
                                  guint             time,
                                  gpointer          user_data)
 {
   gtkwidget *notebook;
   gtkwidget **child;
   
   notebook = gtk_drag_get_source_widget (context);
   child = (void*) selection_data->data;
   
   process_widget (*child);
   gtk_container_remove (gtk_container (notebook), *child);
 }

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

notebook :	gtknotebook
`child` :	дочерний gtkwidget
detachable :	отделяемая вкладка или нет

начиная с версии 2.10

gtk_notebook_get_menu_label_text ()

const gchar* gtk_notebook_get_menu_label_text
                                            (gtknotebook *notebook,
                                             gtkwidget *child);

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

`notebook` :	gtknotebook
`child` :	дочерний виджет of a page of the notebook.
возвращает:	значение: текст ярлыка вкладки, или `null` если виджет не имеет ярлыка метки, кроме установленного по умолчанию, или ярлык метки не является gtklabel. строкой владеет виджет и она не должна высвобождаться.

gtk_notebook_get_scrollable ()

gboolean    gtk_notebook_get_scrollable     (gtknotebook *notebook);

определяет имеет ли область вкладок с ярлыками стрелки для прокручивания. смотрите gtk_notebook_set_scrollable().

`notebook` :	gtknotebook
возвращает:	`true` если стрелки для прокручивания отображаются

gtk_notebook_get_show_border ()

gboolean    gtk_notebook_get_show_border    (gtknotebook *notebook);

определяет имеется ли скос возле страниц контейнера вкладок. смотрите gtk_notebook_set_show_border().

`notebook` :	gtknotebook
возвращает:	`true` если скос отрисовывается

gtk_notebook_get_show_tabs ()

gboolean    gtk_notebook_get_show_tabs      (gtknotebook *notebook);

определяет отображаются ли вкладки контейнера. смотрите gtk_notebook_set_show_tabs().

`notebook` :	gtknotebook
возвращает:	`true` если вкладки отображаются

gtk_notebook_get_tab_label_text ()

const gchar* gtk_notebook_get_tab_label_text
                                            (gtknotebook *notebook,
                                             gtkwidget *child);

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

`notebook` :	gtknotebook
`child` :	виджет содержащийся в странице `notebook`
возвращает:	значение: текст ярлыка вкладки, или `null` если ярлык вкладки не является gtklabel. строкой владеет виджет и она не должна высвобождаться.

gtk_notebook_get_tab_pos ()

gtkpositiontype gtk_notebook_get_tab_pos    (gtknotebook *notebook);

определяет сторону с которой рисуются вкладки для переключения страниц в контейнере вкладок.

`notebook` :	gtknotebook
возвращает:	сторону на которой отрисовываются вкладки

gtk_notebook_get_tab_reorderable ()

gboolean    gtk_notebook_get_tab_reorderable
                                            (gtknotebook *notebook,
                                             gtkwidget *child);

определяет может ли вкладка менять положение через перетаскивание (drag and drop) или нет.

notebook :	gtknotebook
child :	дочерний gtkwidget
returns :	`true` если вкладка может менять положение.

начиная с версии 2.10

gtk_notebook_get_tab_detachable ()

gboolean    gtk_notebook_get_tab_detachable (gtknotebook *notebook,
                                             gtkwidget *child);

определяет может ли содержимое вкладки отделяться от notebook.

`notebook` :	gtknotebook
`child` :	дочерний gtkwidget
returns :	true если вкладка отделяемая.

начиная с версии 2.10

gtk_notebook_set_current_page ()

void        gtk_notebook_set_current_page   (gtknotebook *notebook,
                                             gint page_num);

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

`notebook` :	gtknotebook
`page_num` :	указатель страницы для переключения, начиная с 0. если отрицательное, то будет использована последняя страница. если больше чем количество страниц в контейнере вкладок, то ничего не произойдет.

gtk_notebook_set_group_id ()

void        gtk_notebook_set_group_id       (gtknotebook *notebook,
                                             gint group_id);

устанавливает идентификатор группы для notebook, контейнеры вкладок одной и той же группы могут обмениваться вкладками через drag and drop. контейнер вкладок с идентификатором -1 не может обмениваться вкладками ни с какими другими контейнерами.

`notebook` :	gtknotebook
`group_id` :	идентификатор группы, или -1 для его сброса

начиная с версии 2.10

gtk_notebook_get_group_id ()

gint        gtk_notebook_get_group_id       (gtknotebook *notebook);

получает текущий идентификатор группы для notebook.

`notebook` :	gtknotebook
returns :	идентификатор группы, или -1 если не был установлен

начиная с версии 2.10

gtknotebookwindowcreationfunc ()

gtknotebook* (*gtknotebookwindowcreationfunc)
                                            (gtknotebook *source,
                                             gtkwidget *page,
                                             gint x,
                                             gint y,
                                             gpointer data);

функция используемая gtknotebook когда отделяемая вкладка перетаскивается в основное окно, это используется для создания окна содержащего контейнер вкладок куда были добавлены вкладки. эта функция так же отвечает за перемещение/изменение размера окна и добавление необходимых свойств к контейнеру вкладок (то есть: group-id). если функция возвращает null, то перетаскивание будет отменено.

source :	исходный gtknotebook операции перетаскивания
page :	дочерний gtkwidget затрагиваемый операцией
`x` :	x координаты перетаскивания
y :	y координаты перетаскивания
data :	пользовательские данные
возвращает :	создаваемый gtknotebook куда добавляются вкладки, или null для прекращения перетаскивания

gtk_notebook_set_window_creation_hook ()

void        gtk_notebook_set_window_creation_hook
                                            (gtknotebookwindowcreationfunc func,
                                             gpointer data);

устанавливает глобальную функцию используемую при создании окна когда отделённая вкладка перетаскивается в пустую область.

func :	gtknotebookwindowcreationfunc, или null
`data` :	пользовательские данные для func.

начиная с версии 2.10

детали свойств

свойство "`enable-popup`"

  "enable-popup"         gboolean              : read / write

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

значение по умолчанию: false

свойство "`homogeneous`"

  "homogeneous"          gboolean              : read / write

должны ли вкладки иметь одинаковый размер.

значение по умолчанию: false

свойство "`page`"

  "page"                 gint                  : read / write

указатель текущемй страницы.

допустимые значения: >= 0

значение по умолчанию: 0

свойство "`scrollable`"

  "scrollable"           gboolean              : read / write

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

значение по умолчанию: false

свойство "`show-border`"

  "show-border"          gboolean              : read / write

должна ли отображаться окантовка или нет.

значение по умолчанию: true

свойство "`show-tabs`"

  "show-tabs"            gboolean              : read / write

должны ли отображаться вкладки или нет.

значение по умолчанию: true

свойство "`tab-border`"

  "tab-border"           guint                 : write

ширина окантовки вокруг ярлыка вкладки.

значение по умолчанию: 2

свойство "`tab-hborder`"

  "tab-hborder"          guint                 : read / write

ширина горизонтальной границы ярлыка вкладки.

значение по умолчанию: 2

свойство "`tab-pos`"

  "tab-pos"              gtkpositiontype       : read / write

с какой стороны контейнер вкладок содержит вкладки.

значение по умолчанию: gtk_pos_top

свойство "`tab-vborder`"

  "tab-vborder"          guint                 : read / write

ширина вертикальной границы ярлыка вкладки.

значение по умолчанию: 2

детали дочерних свойств

дочернее свойство "`menu-label`"

  "menu-label"           gchararray            : read / write

строка отображаемая в элементе дочернего меню.

значение по умолчанию: null

дочернее свойство "`position`"

  "position"             gint                  : read / write

указатель дочернего виджета в родителе.

допустимые значения: >= -1

значение по умолчанию: 0

дочернее свойство "`tab-expand`"

  "tab-expand"           gboolean              : read / write

должны ли дочерние вкладки расширяться или нет.

значение по умолчанию: true

дочернее свойство "`tab-fill`"

  "tab-fill"             gboolean              : read / write

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

значение по умолчанию: true

дочернее свойство "`tab-label`"

  "tab-label"            gchararray            : read / write

строка отображаемая на ярлыке дочерней вкладки.

значение по умолчанию: null

дочернее свойство "`tab-pack`"

  "tab-pack"             gtkpacktype           : read / write

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

значение по умолчанию: gtk_pack_start

детали свойств стиля

свойство стиля "`arrow-spacing`"

  "arrow-spacing"        gint                  : read

свойство "arrow-size" определяет свободное пространство между стрелками прокрутки и вкладками.

допустимые значения: >= 0

значение по умолчанию: 0

начиная с версии 2.10

свойство стиля "`has-backward-stepper`"

  "has-backward-stepper" gboolean              : read

свойство "has-backward-stepper" определяет отображается ли обратная кнопка стрелка - «назад».

значение по умолчанию: true

начиная с версии 2.4

свойство стиля "`has-forward-stepper`"

  "has-forward-stepper"  gboolean              : read

свойство "has-forward-stepper" определяет отображается ли стандартная кнопка стрелка - «вперёд».

значение по умолчанию: true

начиная с версии 2.4

свойство стиля "`has-secondary-backward-stepper`"

  "has-secondary-backward-stepper" gboolean              : read

свойство "has-secondary-backward-stepper" определяет отображается ли вторичная кнопка стрелка «назад» в противоположном конце области вкладок.

значение по умолчанию: false

начиная с версии 2.4

свойство стиля "`has-secondary-forward-stepper`"

  "has-secondary-forward-stepper" gboolean              : read

свойство "has-secondary-forward-stepper" определяет отображается ли вторичная кнопка стрелка «вперёд» в противоположном конце области вкладок.

значение по умолчанию: false

начиная с версии 2.4

свойство стиля "`tab-curvature`"

  "tab-curvature"        gint                  : read

свойство "tab-curvature" определяет размер искривления вкладок.

допустимые значения: >= 0

значение по умолчанию: 1

начиная с версии 2.10

свойство стиля "`tab-overlap`"

  "tab-overlap"          gint                  : read

свойство "tab-overlap" определяет размер области наложения вкладок.

значение по умолчанию: 2

начиная с версии 2.10

детали сигнала

сигнал "change-current-page"

void        user_function                  (gtknotebook *notebook,
                                            gint         arg1,
                                            gpointer     user_data)      : run last / action

`notebook` :	объект получающий сигнал.
`arg1` :
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика сигнала

сигнал "focus-tab"

gboolean    user_function                  (gtknotebook   *notebook,
                                            gtknotebooktab arg1,
                                            gpointer       user_data)      : run last / action

`notebook` :	объект получающий сигнал.
`arg1` :
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика сигнала
возвращает:

сигнал "move-focus-out"

void        user_function                  (gtknotebook     *notebook,
                                            gtkdirectiontype arg1,
                                            gpointer         user_data)      : run last / action

`notebook` :	объект получающий сигнал.
`arg1` :
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика сигнала

сигнал "page-added"

void        user_function                  (gtknotebook *notebook,
                                            gtkwidget   *child,
                                            guint        page_num,
                                            gpointer     user_data)      : run last

сигнал ::page-added издаётся в контейнере вкладок сразу после добавления страницы к контейнеру.

`notebook` :	gtknotebook
child :	затрагиваемый дочерний gtkwidget
page_num :	новый номер страницы для `child`
user_data :	пользовательские данные устанавливаемые при подключении обработчика сигнала

начиная с версии 2.10

сигнал "page-removed"

void        user_function                  (gtknotebook *notebook,
                                            gtkwidget   *child,
                                            guint        page_num,
                                            gpointer     user_data)      : run last

сигнал ::page-removed издаётся в контейнере вкладок сразу после удаления страницы из контейнера.

`notebook` :	gtknotebook
child :	затронутый дочерний gtkwidget
`page_num` :	child номер страницы
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика сигнала

начиная с версии 2.10

сигнал "page-reordered"

void        user_function                  (gtknotebook *notebook,
                                            gtkwidget   *child,
                                            guint        page_num,
                                            gpointer     user_data)      : run last

сигнал ::page-reordered издаётся сразу после изменения порядка вкладок в контейнере.

notebook :	gtknotebook
`child` :	затронутый дочерний gtkwidget
`page_num` :	новый номер страницы для child
user_data :	пользовательские данные устанавливаемые при подключении обработчика сигнала

начиная с версии 2.10

сигнал "select-page"

gboolean    user_function                  (gtknotebook *notebook,
                                            gboolean     arg1,
                                            gpointer     user_data)      : run last / action

`notebook` :	объект получающий сигнал.
`arg1` :
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика сигнала
возвращает:

сигнал "switch-page"

void        user_function                  (gtknotebook     *notebook,
                                            gtknotebookpage *page,
                                            guint            page_num,
                                            gpointer         user_data)      : run last

издаётся когда пользователь или функция переключили текущую страницу.

`notebook` :	объект получающий сигнал.
`page` :	новая текущая страница
`page_num` :	указатель страницы
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика сигнала

смотрите также

gtkcontainer

для функций которые применяют каждый gtkcontainer (как gtklist).

gtknotebook

краткое описание

иерархия объектов

осуществляемые интерфейсы

свойства

дочерние свойства

свойства стиля

сигналы

описание

детали

gtknotebook

gtknotebookpage

gtk_notebook_new ()

gtk_notebook_append_page ()

gtk_notebook_append_page_menu ()

gtk_notebook_prepend_page ()

gtk_notebook_prepend_page_menu ()

gtk_notebook_insert_page ()

gtk_notebook_insert_page_menu ()

gtk_notebook_remove_page ()

gtk_notebook_current_page

внимание

gtk_notebook_page_num ()

gtk_notebook_set_page

внимание

gtk_notebook_next_page ()

gtk_notebook_prev_page ()

gtk_notebook_reorder_child ()

gtk_notebook_set_tab_pos ()

gtk_notebook_set_show_tabs ()

gtk_notebook_set_show_border ()

gtk_notebook_set_scrollable ()

gtk_notebook_set_tab_border ()

внимание

gtk_notebook_popup_enable ()

gtk_notebook_popup_disable ()

gtk_notebook_get_current_page ()

gtk_notebook_get_menu_label ()

gtk_notebook_get_nth_page ()

gtk_notebook_get_n_pages ()

gtk_notebook_get_tab_label ()

gtk_notebook_query_tab_label_packing ()

gtk_notebook_set_homogeneous_tabs ()

внимание

gtk_notebook_set_menu_label ()

gtk_notebook_set_menu_label_text ()

gtk_notebook_set_tab_hborder ()

внимание

gtk_notebook_set_tab_label ()

gtk_notebook_set_tab_label_packing ()

gtk_notebook_set_tab_label_text ()

gtk_notebook_set_tab_vborder ()

внимание

gtk_notebook_set_tab_reorderable ()

gtk_notebook_set_tab_detachable ()

gtk_notebook_get_menu_label_text ()

gtk_notebook_get_scrollable ()

gtk_notebook_get_show_border ()

gtk_notebook_get_show_tabs ()

gtk_notebook_get_tab_label_text ()

gtk_notebook_get_tab_pos ()

gtk_notebook_get_tab_reorderable ()

gtk_notebook_get_tab_detachable ()

gtk_notebook_set_current_page ()

gtk_notebook_set_group_id ()

gtk_notebook_get_group_id ()

gtknotebookwindowcreationfunc ()

gtk_notebook_set_window_creation_hook ()

детали свойств

свойство "enable-popup"

свойство "homogeneous"

свойство "page"

свойство "scrollable"

свойство "show-border"

свойство "show-tabs"

свойство "tab-border"

свойство "tab-hborder"

свойство "tab-pos"

свойство "tab-vborder"

детали дочерних свойств

свойство "`enable-popup`"

свойство "`homogeneous`"

свойство "`page`"

свойство "`scrollable`"

свойство "`show-border`"

свойство "`show-tabs`"

свойство "`tab-border`"

свойство "`tab-hborder`"

свойство "`tab-pos`"

свойство "`tab-vborder`"

дочернее свойство "`menu-label`"

дочернее свойство "`position`"

дочернее свойство "`tab-expand`"

дочернее свойство "`tab-fill`"

дочернее свойство "`tab-label`"

дочернее свойство "`tab-pack`"

свойство стиля "`arrow-spacing`"

свойство стиля "`has-backward-stepper`"

свойство стиля "`has-forward-stepper`"

свойство стиля "`has-secondary-backward-stepper`"

свойство стиля "`has-secondary-forward-stepper`"

свойство стиля "`tab-curvature`"

свойство стиля "`tab-overlap`"