Wiki
Задать вопрос на форуме...

prev

up

home

gtk+ reference manual

next

top  |  description  |  object hierarchy  |  implemented interfaces  |  properties  |  child properties  |  style properties  |  signals

gtktoolbar

gtktoolbar — создаёт панель для кнопок и других виджетов

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

#include <gtk/gtk.h>


            gtktoolbar;
enum        gtktoolbarchildtype;
enum        gtktoolbarspacestyle;
            gtktoolbarchild;
gtkwidget*  gtk_toolbar_new                 (void);
void        gtk_toolbar_insert              (gtktoolbar *toolbar,
                                             gtktoolitem *item,
                                             gint pos);
gint        gtk_toolbar_get_item_index      (gtktoolbar *toolbar,
                                             gtktoolitem *item);
gint        gtk_toolbar_get_n_items         (gtktoolbar *toolbar);
gtktoolitem* gtk_toolbar_get_nth_item       (gtktoolbar *toolbar,
                                             gint n);
gint        gtk_toolbar_get_drop_index      (gtktoolbar *toolbar,
                                             gint x,
                                             gint y);
void        gtk_toolbar_set_drop_highlight_item
                                            (gtktoolbar *toolbar,
                                             gtktoolitem *tool_item,
                                             gint index_);
void        gtk_toolbar_set_show_arrow      (gtktoolbar *toolbar,
                                             gboolean show_arrow);
void        gtk_toolbar_set_orientation     (gtktoolbar *toolbar,
                                             gtkorientation orientation);
void        gtk_toolbar_set_tooltips        (gtktoolbar *toolbar,
                                             gboolean enable);
void        gtk_toolbar_unset_icon_size     (gtktoolbar *toolbar);
gboolean    gtk_toolbar_get_show_arrow      (gtktoolbar *toolbar);
gtkorientation gtk_toolbar_get_orientation  (gtktoolbar *toolbar);
gtktoolbarstyle gtk_toolbar_get_style       (gtktoolbar *toolbar);
gtkiconsize gtk_toolbar_get_icon_size       (gtktoolbar *toolbar);
gboolean    gtk_toolbar_get_tooltips        (gtktoolbar *toolbar);
gtkreliefstyle gtk_toolbar_get_relief_style (gtktoolbar *toolbar);
gtkwidget*  gtk_toolbar_append_item         (gtktoolbar *toolbar,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtkwidget *icon,
                                             gtksignalfunc callback,
                                             gpointer user_data);
gtkwidget*  gtk_toolbar_prepend_item        (gtktoolbar *toolbar,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtkwidget *icon,
                                             gtksignalfunc callback,
                                             gpointer user_data);
gtkwidget*  gtk_toolbar_insert_item         (gtktoolbar *toolbar,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtkwidget *icon,
                                             gtksignalfunc callback,
                                             gpointer user_data,
                                             gint position);
void        gtk_toolbar_append_space        (gtktoolbar *toolbar);
void        gtk_toolbar_prepend_space       (gtktoolbar *toolbar);
void        gtk_toolbar_insert_space        (gtktoolbar *toolbar,
                                             gint position);
gtkwidget*  gtk_toolbar_append_element      (gtktoolbar *toolbar,
                                             gtktoolbarchildtype type,
                                             gtkwidget *widget,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtkwidget *icon,
                                             gtksignalfunc callback,
                                             gpointer user_data);
gtkwidget*  gtk_toolbar_prepend_element     (gtktoolbar *toolbar,
                                             gtktoolbarchildtype type,
                                             gtkwidget *widget,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtkwidget *icon,
                                             gtksignalfunc callback,
                                             gpointer user_data);
gtkwidget*  gtk_toolbar_insert_element      (gtktoolbar *toolbar,
                                             gtktoolbarchildtype type,
                                             gtkwidget *widget,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtkwidget *icon,
                                             gtksignalfunc callback,
                                             gpointer user_data,
                                             gint position);
void        gtk_toolbar_append_widget       (gtktoolbar *toolbar,
                                             gtkwidget *widget,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text);
void        gtk_toolbar_prepend_widget      (gtktoolbar *toolbar,
                                             gtkwidget *widget,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text);
void        gtk_toolbar_insert_widget       (gtktoolbar *toolbar,
                                             gtkwidget *widget,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gint position);
void        gtk_toolbar_set_style           (gtktoolbar *toolbar,
                                             gtktoolbarstyle style);
gtkwidget*  gtk_toolbar_insert_stock        (gtktoolbar *toolbar,
                                             const gchar *stock_id,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtksignalfunc callback,
                                             gpointer user_data,
                                             gint position);
void        gtk_toolbar_set_icon_size       (gtktoolbar *toolbar,
                                             gtkiconsize icon_size);
void        gtk_toolbar_remove_space        (gtktoolbar *toolbar,
                                             gint position);
void        gtk_toolbar_unset_style         (gtktoolbar *toolbar);

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

  gobject
   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget
                     +----gtkcontainer
                           +----gtktoolbar

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

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

свойства

  "icon-size"            gtkiconsize           : read / write
  "icon-size-set"        gboolean              : read / write
  "orientation"          gtkorientation        : read / write
  "show-arrow"           gboolean              : read / write
  "toolbar-style"        gtktoolbarstyle       : read / write
  "tooltips"             gboolean              : read / write

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

  "expand"               gboolean              : read / write
  "homogeneous"          gboolean              : read / write

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

  "button-relief"        gtkreliefstyle        : read
  "internal-padding"     gint                  : read
  "max-child-expand"     gint                  : read
  "shadow-type"          gtkshadowtype         : read
  "space-size"           gint                  : read
  "space-style"          gtktoolbarspacestyle  : read

сигналы

"focus-home-or-end"
            gboolean    user_function      (gtktoolbar *toolbar,
                                            gboolean    focus_home,
                                            gpointer    user_data)       : run last / action
"move-focus"
            gboolean    user_function      (gtktoolbar       *toolbar,
                                            gtkdirectiontype *dir,
                                            gpointer          user_data)      : run last / action
"orientation-changed"
            void        user_function      (gtktoolbar    *toolbar,
                                            gtkorientation orientation,
                                            gpointer       user_data)        : run first
"popup-context-menu"
            gboolean    user_function      (gtktoolbar *toolbar,
                                            gint        x,
                                            gint        y,
                                            gint        button,
                                            gpointer    user_data)      : run last
"style-changed"
            void        user_function      (gtktoolbar     *toolbar,
                                            gtktoolbarstyle style,
                                            gpointer        user_data)      : run first

описание

панель инструментов создаётся с помощью вызова gtk_toolbar_new().

панель инструментов содержит образцы подкласса gtktoolitem. для добавления gtktoolitem к панели инструментов, используйте gtk_toolbar_insert(). для удаления пунктов из панели инструментов используйте gtk_container_remove(). для добавления кнопки к панели инструментов, добавляется образец gtktoolbutton.

пункты панели инструментов могут быть визуально сгруппированы добавлением образца gtkseparatortoolitem к панели инструментов. если gtkseparatortoolitem имеет "expand" свойство установленное в true и свойство "draw" установленное в false , то все последующие пункты помещаются в конец панели инструментов.

создание контекстного меню в панели инструментов может быть выполнено вызовом сигнала gtktoolbar::popup-context-menu.

детали

gtktoolbar

typedef struct {
  gint             num_children;
  glist           *children;
  gtkorientation   orientation;
  gtktoolbarstyle  style;
  gtkiconsize      icon_size;
  
  gtktooltips     *tooltips;
} gtktoolbar;

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

enum gtktoolbarchildtype

typedef enum
{
  gtk_toolbar_child_space,
  gtk_toolbar_child_button,
  gtk_toolbar_child_togglebutton,
  gtk_toolbar_child_radiobutton,
  gtk_toolbar_child_widget
} gtktoolbarchildtype;

внимание

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

gtktoolbarchildtype используется для установки типа нового элемента добавляемого к gtktoolbar.

gtk_toolbar_child_space

интервал в стиле gtktoolbarspacestyle.

gtk_toolbar_child_button

gtkbutton.

gtk_toolbar_child_togglebutton

gtktogglebutton.

gtk_toolbar_child_radiobutton

gtkradiobutton.

gtk_toolbar_child_widget

стандартный gtkwidget.

enum gtktoolbarspacestyle

typedef enum
{
  gtk_toolbar_space_empty,
  gtk_toolbar_space_line
} gtktoolbarspacestyle;

gtktoolbarchild

typedef struct {
  gtktoolbarchildtype type;
  gtkwidget *widget;
  gtkwidget *icon;
  gtkwidget *label;
} gtktoolbarchild;

внимание

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

gtk_toolbar_new ()

gtkwidget*  gtk_toolbar_new                 (void);

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

возвращает:

вновь созданную панель инструментов.

gtk_toolbar_insert ()

void        gtk_toolbar_insert              (gtktoolbar *toolbar,
                                             gtktoolitem *item,
                                             gint pos);

вставляет gtktoolitem в панель инструментов в позицию pos. если pos равно 0 пункт вставляется в начало панели. если pos отрицательное, пункт вставляется в конец панели.

toolbar :

gtktoolbar

item :

gtktoolitem

pos :

позиция нового пункта

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

gtk_toolbar_get_item_index ()

gint        gtk_toolbar_get_item_index      (gtktoolbar *toolbar,
                                             gtktoolitem *item);

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

toolbar :

gtktoolbar

item :

gtktoolitem дочерний для toolbar

возвращает:

позицию пункта на панели.

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

gtk_toolbar_get_n_items ()

gint        gtk_toolbar_get_n_items         (gtktoolbar *toolbar);

возвращает количество пунктов на панели.

toolbar :

gtktoolbar

возвращает:

количество пунктов

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

gtk_toolbar_get_nth_item ()

gtktoolitem* gtk_toolbar_get_nth_item       (gtktoolbar *toolbar,
                                             gint n);

возвращает n пункт на toolbar, или null если панель не содержит n пункт.

toolbar :

gtktoolbar

n :

позиция на панели

возвращает:

n gtktoolitem на toolbar, или null если нет n пункта.

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

gtk_toolbar_get_drop_index ()

gint        gtk_toolbar_get_drop_index      (gtktoolbar *toolbar,
                                             gint x,
                                             gint y);

возвращает соответствующую позицию для указанной точки на панели toolbar. это полезно при перемещении пунктов на панели: эта функция возвращает позицию куда должен быть перемещён пункт.

x и y являются координатами на toolbar.

toolbar :

gtktoolbar

x :

x координаты на панели

y :

y координаты на панели

возвращает:

позиция соответствующая точке (x, y) на панели.

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

gtk_toolbar_set_drop_highlight_item ()

void        gtk_toolbar_set_drop_highlight_item
                                            (gtktoolbar *toolbar,
                                             gtktoolitem *tool_item,
                                             gint index_);

подсвечивает toolbar если item был добавлен на toolbar в позицию указанную index_. если item равен null, подсвечивание выключено. в этом случае index_ игнорируется.

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

toolbar :

gtktoolbar

tool_item :

gtktoolitem, или null для выключения подсвечивания

index_ :

позиция на toolbar

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

gtk_toolbar_set_show_arrow ()

void        gtk_toolbar_set_show_arrow      (gtktoolbar *toolbar,
                                             gboolean show_arrow);

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

toolbar :

gtktoolbar

show_arrow :

показывается ли меню переполнения

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

gtk_toolbar_set_orientation ()

void        gtk_toolbar_set_orientation     (gtktoolbar *toolbar,
                                             gtkorientation orientation);

устанавливает горизонтальную или вертикальную ориентацию панели.

toolbar :

gtktoolbar.

orientation :

новый gtkorientation.

gtk_toolbar_set_tooltips ()

void        gtk_toolbar_set_tooltips        (gtktoolbar *toolbar,
                                             gboolean enable);

устанавливает включены ли подсказки на панели инструментов.

toolbar :

gtktoolbar.

enable :

false для отключения подсказок, или true для включения.

gtk_toolbar_unset_icon_size ()

void        gtk_toolbar_unset_icon_size     (gtktoolbar *toolbar);

внимание

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

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

toolbar :

gtktoolbar

gtk_toolbar_get_show_arrow ()

gboolean    gtk_toolbar_get_show_arrow      (gtktoolbar *toolbar);

определяет должна ли панель иметь меню переполнения. смотрите gtk_toolbar_set_show_arrow().

toolbar :

gtktoolbar

возвращает:

true если панель должна иметь меню переполнения.

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

gtk_toolbar_get_orientation ()

gtkorientation gtk_toolbar_get_orientation  (gtktoolbar *toolbar);

определяет текущую ориентацию панели. смотрите gtk_toolbar_set_orientation().

toolbar :

gtktoolbar

возвращает:

ориентацию панели

gtk_toolbar_get_style ()

gtktoolbarstyle gtk_toolbar_get_style       (gtktoolbar *toolbar);

определяет должна ли панель иметь текст, значки или и то и другое. смотрите gtk_toolbar_set_style().

toolbar :

gtktoolbar

возвращает:

текущий стиль toolbar

gtk_toolbar_get_icon_size ()

gtkiconsize gtk_toolbar_get_icon_size       (gtktoolbar *toolbar);

определяет размер значков для панели. смотрите gtk_toolbar_set_icon_size().

toolbar :

gtktoolbar

возвращает:

текущий размер значков.

gtk_toolbar_get_tooltips ()

gboolean    gtk_toolbar_get_tooltips        (gtktoolbar *toolbar);

определяет включены ли подсказки. смотрите gtk_toolbar_set_tooltips().

toolbar :

gtktoolbar

возвращает:

true если подсказки включены

gtk_toolbar_get_relief_style ()

gtkreliefstyle gtk_toolbar_get_relief_style (gtktoolbar *toolbar);

определяет стиль рельефа кнопок на toolbar. смотрите gtk_button_set_relief().

toolbar :

gtktoolbar

возвращает:

стиль рельефа кнопок toolbar.

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

gtk_toolbar_append_item ()

gtkwidget*  gtk_toolbar_append_item         (gtktoolbar *toolbar,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtkwidget *icon,
                                             gtksignalfunc callback,
                                             gpointer user_data);

внимание

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

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

callback должен указывать на функцию получающую gtkwidget и gpointer как аргумент. используйте gtk_signal_func() для отбора функции в gtksignalfunc.

toolbar :

gtktoolbar.

text :

ярлык для вашей кнопки на панели.

tooltip_text :

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

tooltip_private_text :

используйте с gtktipsquery.

icon :

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

callback :

функция которая исполняется при нажатии на кнопку.

user_data :

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

возвращает:

новый пункт панели как gtkwidget.

gtk_toolbar_prepend_item ()

gtkwidget*  gtk_toolbar_prepend_item        (gtktoolbar *toolbar,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtkwidget *icon,
                                             gtksignalfunc callback,
                                             gpointer user_data);

внимание

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

добавляет кнопку в начало (сверху или слева) данной панели.

callback должен указывать на функцию получающую gtkwidget и gpointer как аргумент. используйте gtk_signal_func() для отбора функции в gtksignalfunc.

toolbar :

gtktoolbar.

text :

ярлык для вашей кнопки на панели.

tooltip_text :

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

tooltip_private_text :

используйте с gtktipsquery.

icon :

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

callback :

функция которая исполняется при нажатии на кнопку.

user_data :

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

возвращает:

новый пункт панели как gtkwidget.

gtk_toolbar_insert_item ()

gtkwidget*  gtk_toolbar_insert_item         (gtktoolbar *toolbar,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtkwidget *icon,
                                             gtksignalfunc callback,
                                             gpointer user_data,
                                             gint position);

внимание

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

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

callback должен указывать на функцию получающую gtkwidget и gpointer как аргумент. используйте gtk_signal_func() для отбора функции в gtksignalfunc.

toolbar :

gtktoolbar.

text :

ярлык для вашей кнопки на панели.

tooltip_text :

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

tooltip_private_text :

используйте с gtktipsquery.

icon :

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

callback :

функция которая исполняется при нажатии на кнопку.

user_data :

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

position :

количество виджетов после которого будет вставлен этот пункт.

возвращает:

новый пункт панели как gtkwidget.

gtk_toolbar_append_space ()

void        gtk_toolbar_append_space        (gtktoolbar *toolbar);

внимание

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

добавляет новый интервал в конец панели.

toolbar :

gtktoolbar.

gtk_toolbar_prepend_space ()

void        gtk_toolbar_prepend_space       (gtktoolbar *toolbar);

внимание

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

добавляет новый интервал в начало панели.

toolbar :

gtktoolbar.

gtk_toolbar_insert_space ()

void        gtk_toolbar_insert_space        (gtktoolbar *toolbar,
                                             gint position);

внимание

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

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

toolbar :

gtktoolbar

position :

количество виджетов после которого будет вставлен интервал.

gtk_toolbar_append_element ()

gtkwidget*  gtk_toolbar_append_element      (gtktoolbar *toolbar,
                                             gtktoolbarchildtype type,
                                             gtkwidget *widget,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtkwidget *icon,
                                             gtksignalfunc callback,
                                             gpointer user_data);

внимание

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

добавляет новые элементы в конец панели.

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

callback должен указывать на функцию получающую gtkwidget и gpointer как аргумент. используйте gtk_signal_func() для отбора функции в gtksignalfunc.

toolbar :

gtktoolbar.

type :

значение типа gtktoolbarchildtype который определяет каким widget должен быть.

widget :

gtkwidget, или null.

text :

элемент ярлык.

tooltip_text :

элемент подсказка.

tooltip_private_text :

используемый контекст всплывающей подсказки об этом элементе панели.

icon :

gtkwidget который обеспечивает изображение для элементов функции.

callback :

функция которая исполняется при нажатии на кнопку.

user_data :

любые ваши данные помещаемые в функцию.

возвращает:

новый элемент панели как gtkwidget.

gtk_toolbar_prepend_element ()

gtkwidget*  gtk_toolbar_prepend_element     (gtktoolbar *toolbar,
                                             gtktoolbarchildtype type,
                                             gtkwidget *widget,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtkwidget *icon,
                                             gtksignalfunc callback,
                                             gpointer user_data);

внимание

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

добавляет новый элемент в начало данной панели.

если type == gtk_toolbar_child_widget, widget используется как новый элемент. if type == gtk_toolbar_child_radiobutton, widget используется как радио группа для нового элемента. во всех других случаях, widget должен быть null.

callback должен указывать на функцию получающую gtkwidget и gpointer как аргумент. используйте gtk_signal_func() для отбора функции в gtksignalfunc.

toolbar :

gtktoolbar.

type :

значение типа gtktoolbarchildtype который определяет каким widget должен быть.

widget :

gtkwidget, or null

text :

элемент ярлык.

tooltip_text :

элемент подсказка.

tooltip_private_text :

используемый контекст всплывающей подсказки об этом элементе панели.

icon :

gtkwidget который обеспечивает изображение для элементов функции.

callback :

функция которая исполняется при нажатии на кнопку.

user_data :

любые ваши данные помещаемые в функцию.

возвращает:

новый элемент панели как gtkwidget.

gtk_toolbar_insert_element ()

gtkwidget*  gtk_toolbar_insert_element      (gtktoolbar *toolbar,
                                             gtktoolbarchildtype type,
                                             gtkwidget *widget,
                                             const char *text,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtkwidget *icon,
                                             gtksignalfunc callback,
                                             gpointer user_data,
                                             gint position);

внимание

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

вставляет элемент в данную позицию панели.

if type == gtk_toolbar_child_widget, widget используется как новый элемент. если type == gtk_toolbar_child_radiobutton, widget используется как радио группа для нового элемента. во всех других случаях, widget должен быть null.

callback должен указывать на функцию получающую gtkwidget и gpointer как аргумент. используйте gtk_signal_func() для отбора функции в gtksignalfunc.

toolbar :

gtktoolbar.

type :

значение типа gtktoolbarchildtype который определяет каким widget должен быть.

widget :

gtkwidget, or null.

text :

элемент ярлык.

tooltip_text :

элемент подсказка.

tooltip_private_text :

используемый контекст всплывающей подсказки об этом элементе панели.

icon :

gtkwidget который обеспечивает изображение для элементов функции.

callback :

функция которая исполняется при нажатии на кнопку.

user_data :

любые ваши данные помещаемые в функцию.

position :

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

возвращает:

новый элемент панели как gtkwidget.

gtk_toolbar_append_widget ()

void        gtk_toolbar_append_widget       (gtktoolbar *toolbar,
                                             gtkwidget *widget,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text);

внимание

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

добавляет виджет в конец данной панели.

toolbar :

gtktoolbar.

widget :

gtkwidget добавляемый на панель.

tooltip_text :

элемент подсказка.

tooltip_private_text :

используемый контекст всплывающей подсказки об этом элементе панели.

gtk_toolbar_prepend_widget ()

void        gtk_toolbar_prepend_widget      (gtktoolbar *toolbar,
                                             gtkwidget *widget,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text);

внимание

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

добавляет виджет в начало данной панели.

toolbar :

gtktoolbar.

widget :

gtkwidget добавляемый на панель.

tooltip_text :

элемент подсказка.

tooltip_private_text :

используемый контекст всплывающей подсказки об этом элементе панели.

gtk_toolbar_insert_widget ()

void        gtk_toolbar_insert_widget       (gtktoolbar *toolbar,
                                             gtkwidget *widget,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gint position);

внимание

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

вставляет виджет в данную позицию панели.

toolbar :

gtktoolbar.

widget :

gtkwidget добавляемый на панель.

tooltip_text :

элемент подсказка.

tooltip_private_text :

используемый контекст всплывающей подсказки об этом элементе панели.

position :

количество виджетов после которого вставляется этот виджет.

gtk_toolbar_set_style ()

void        gtk_toolbar_set_style           (gtktoolbar *toolbar,
                                             gtktoolbarstyle style);

изменяет вид toolbar для отображения только значков, только текста, или всё вместе.

toolbar :

gtktoolbar.

style :

новый стиль для toolbar.

gtk_toolbar_insert_stock ()

gtkwidget*  gtk_toolbar_insert_stock        (gtktoolbar *toolbar,
                                             const gchar *stock_id,
                                             const char *tooltip_text,
                                             const char *tooltip_private_text,
                                             gtksignalfunc callback,
                                             gpointer user_data,
                                             gint position);

внимание

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

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

callback должен указывать на функцию получающую gtkwidget и gpointer как аргумент. используйте gtk_signal_func() для отбора функции в gtksignalfunc.

toolbar :

gtktoolbar

stock_id :

id заготовленного пункта который вы хотите вставить

tooltip_text :

текст подсказки

tooltip_private_text :

закрытый текст подсказки

callback :

callback-функция вызываемая при нажатии на кнопку.

user_data :

данные помещаемые в callback-функцию

position :

позиция в которую будет вставлена кнопка. -1 вставляет в конец.

возвращает:

вставляемый виджет

gtk_toolbar_set_icon_size ()

void        gtk_toolbar_set_icon_size       (gtktoolbar *toolbar,
                                             gtkiconsize icon_size);

внимание

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

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

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

toolbar :

gtktoolbar

icon_size :

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

gtk_toolbar_remove_space ()

void        gtk_toolbar_remove_space        (gtktoolbar *toolbar,
                                             gint position);

внимание

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

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

toolbar :

gtktoolbar.

position :

позиция удаляемого интервала.

gtk_toolbar_unset_style ()

void        gtk_toolbar_unset_style         (gtktoolbar *toolbar);

сбрасывает установки стиля панели установленные с помощью gtk_toolbar_set_style(), таким образом для определения стиля используются настройки пользователя.

toolbar :

gtktoolbar

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

свойство "icon-size"

  "icon-size"            gtkiconsize           : read / write

размер значков в панели обычно определяемый установками toolbar-icon-size. когда это свойство установлено, оно переписывает установки.

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

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

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

свойство "icon-size-set"

  "icon-size-set"        gboolean              : read / write

true если свойство icon-size было установлено.

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

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

свойство "orientation"

  "orientation"          gtkorientation        : read / write

ориентация панели инструментов.

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

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

  "show-arrow"           gboolean              : read / write

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

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

свойство "toolbar-style"

  "toolbar-style"        gtktoolbarstyle       : read / write

как изображать панель.

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

свойство "tooltips"

  "tooltips"             gboolean              : read / write

включены подсказки или нет.

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

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

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

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

  "expand"               gboolean              : read / write

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

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

дочернее свойство "homogeneous"

  "homogeneous"          gboolean              : read / write

должны ли пункты быть однородными по размеру.

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

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

свойство "button-relief"

  "button-relief"        gtkreliefstyle        : read

тип окантовки вокруг кнопок панели инструментов.

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

свойство стиля "internal-padding"

  "internal-padding"     gint                  : read

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

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

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

свойство стиля "max-child-expand"

  "max-child-expand"     gint                  : read

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

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

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

свойство стиля "shadow-type"

  "shadow-type"          gtkshadowtype         : read

стиль скосов вокруг панели.

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

свойство стиля "space-size"

  "space-size"           gint                  : read

размер распорки (spacers).

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

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

свойство стиля "space-style"

  "space-style"          gtktoolbarspacestyle  : read

является ли распорка вертикальной линией или просто пробелом.

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

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

сигнал "focus-home-or-end"

gboolean    user_function                  (gtktoolbar *toolbar,
                                            gboolean    focus_home,
                                            gpointer    user_data)       : run last / action

сигнал привязки клавиш используемый внутри gtk+. этот сигнал не должен использоваться в коде приложений.

toolbar :

gtktoolbar которая издала сигнал

focus_home :

true если первый пункт должен быть в фокусе

user_data :

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

возвращает:

true если сигнал был обработан, false если нет

сигнал "move-focus"

gboolean    user_function                  (gtktoolbar       *toolbar,
                                            gtkdirectiontype *dir,
                                            gpointer          user_data)      : run last / action

сигнал привязки клавиш используемый внутри gtk+. этот сигнал не должен использоваться в коде приложений.

toolbar :

gtktoolbar которая издала сигнал

dir :

gtkdirection

user_data :

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

возвращает:

true если сигнал был обработан, false если нет

сигнал "orientation-changed"

void        user_function                  (gtktoolbar    *toolbar,
                                            gtkorientation orientation,
                                            gpointer       user_data)        : run first

издается при смене ориентации панели.

toolbar :

объект который издаёт сигнал

orientation :

новая gtkorientation панели

user_data :

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

сигнал "popup-context-menu"

gboolean    user_function                  (gtktoolbar *toolbar,
                                            gint        x,
                                            gint        y,
                                            gint        button,
                                            gpointer    user_data)      : run last

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

программисты должны обрабатывать этот сигнал если они хотят отображать контекстное меню панели инструментов. меню должно появляться в полученных координатах x и y. параметр button означает кнопку мыши. если меню всплывает при нажатии комбинаций клавиш, button должен быть -1.

toolbar :

gtktoolbar который издаёт сигнал

x :

x координата точки появления меню

y :

y координата точки появления меню

button :

кнопка мыши нажимаемая пользователем, или -1

user_data :

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

возвращает:

true если сигнал был обработан, false если нет

сигнал "style-changed"

void        user_function                  (gtktoolbar     *toolbar,
                                            gtktoolbarstyle style,
                                            gpointer        user_data)      : run first

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

toolbar :

gtktoolbar которая издаёт сигнал

style :

новый gtktoolbarstyle панели

user_data :

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

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

gtktoolitem

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