The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Implemented Interfaces  |  Properties  |  Signals

GtkToolItem

GtkToolItem Основной класс виджетов добавляемых к GtkToolbar

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

#include <gtk/gtk.h>


            GtkToolItem;
GtkToolItem* gtk_tool_item_new              (void);
void        gtk_tool_item_set_homogeneous   (GtkToolItem *tool_item,
                                             gboolean homogeneous);

gboolean    gtk_tool_item_get_homogeneous   (GtkToolItem *tool_item);
void        gtk_tool_item_set_expand        (GtkToolItem *tool_item,
                                             gboolean expand);

gboolean    gtk_tool_item_get_expand        (GtkToolItem *tool_item);
void        gtk_tool_item_set_tooltip       (GtkToolItem *tool_item,
                                             GtkTooltips *tooltips,
                                             const gchar *tip_text,
                                             const gchar *tip_private);
void        gtk_tool_item_set_use_drag_window

                                            (GtkToolItem *toolitem,
                                             gboolean use_drag_window);
gboolean    gtk_tool_item_get_use_drag_window
                                            (GtkToolItem *toolitem);
void        gtk_tool_item_set_visible_horizontal

                                            (GtkToolItem *toolitem,
                                             gboolean visible_horizontal);
gboolean    gtk_tool_item_get_visible_horizontal
                                            (GtkToolItem *toolitem);
void        gtk_tool_item_set_visible_vertical

                                            (GtkToolItem *toolitem,
                                             gboolean visible_vertical);
gboolean    gtk_tool_item_get_visible_vertical
                                            (GtkToolItem *toolitem);
void        gtk_tool_item_set_is_important  (GtkToolItem *tool_item,
                                             gboolean is_important);

gboolean    gtk_tool_item_get_is_important  (GtkToolItem *tool_item);
GtkIconSize gtk_tool_item_get_icon_size     (GtkToolItem *tool_item);
GtkOrientation gtk_tool_item_get_orientation

                                            (GtkToolItem *tool_item);
GtkToolbarStyle gtk_tool_item_get_toolbar_style
                                            (GtkToolItem *tool_item);
GtkReliefStyle gtk_tool_item_get_relief_style

                                            (GtkToolItem *tool_item);
GtkWidget*  gtk_tool_item_retrieve_proxy_menu_item
                                            (GtkToolItem *tool_item);
GtkWidget*  gtk_tool_item_get_proxy_menu_item

                                            (GtkToolItem *tool_item,
                                             const gchar *menu_item_id);
void        gtk_tool_item_set_proxy_menu_item
                                            (GtkToolItem *tool_item,
                                             const gchar *menu_item_id,
                                             GtkWidget *menu_item);
void        gtk_tool_item_rebuild_menu      (GtkToolItem *tool_item);


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

  GObject
   +----GInitiallyUnowned
         +----GtkObject

               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkToolItem
                                       +----GtkToolButton
                                       +----GtkSeparatorToolItem

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

GtkToolItem осуществляет AtkImplementorIface.

Свойства

  "is-important"         gboolean              : Read / Write
  "visible-horizontal"   gboolean              : Read / Write
  "visible-vertical"     gboolean              : Read / Write

Сигналы

"create-menu-proxy"
            gboolean    user_function      (GtkToolItem *toolitem,
                                            gpointer     user_data)      : Run last
"set-tooltip"
            gboolean    user_function      (GtkToolItem *toolitem,
                                            GtkTooltips *tooltips,
                                            gchar       *tip_text,
                                            gchar       *tip_private,
                                            gpointer     user_data)        : Run last
"toolbar-reconfigured"
            void        user_function      (GtkToolItem *toolitem,
                                            gpointer     user_data)      : Run last

Описание

GtkToolItem является виджетом для добавления на панель инструментов. Для создания пункта панели инструментов содержащего что то ещё кроме кнопки, используйте gtk_tool_item_new(). Для добавления дочернего виджета к пункту меню используйте gtk_container_add().

Для пунктов панели инструментов которые содержат кнопки, смотрите GtkToolButton, GtkToggleToolButton и GtkRadioToolButton классы.

Смотрите класс GtkToolbar описывающий виджет панель инструментов.

Детали

GtkToolItem

typedef struct _GtkToolItem GtkToolItem;

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


gtk_tool_item_new ()

GtkToolItem* gtk_tool_item_new              (void);

Создаёт новый GtkToolItem

Возвращает :

новый GtkToolItem

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


gtk_tool_item_set_homogeneous ()

void        gtk_tool_item_set_homogeneous   (GtkToolItem *tool_item,
                                             gboolean homogeneous);

Устанавливает должен ли tool_item быть однородного размера с другими пунктами. Эффект в том что все однородные пункты получают размер самого большого пункта.

tool_item :

GtkToolItem:

homogeneous :

Должен ли tool_item иметь однородный размер с другими пунктами

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


gtk_tool_item_get_homogeneous ()

gboolean    gtk_tool_item_get_homogeneous   (GtkToolItem *tool_item);

Определяет имеет ли tool_item однородный размер с другими пунктами. Смотрите gtk_tool_item_set_homogeneous().

tool_item :

GtkToolItem:

Возвращает :

TRUE если пункт однородного размера с другими пунктами.

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


gtk_tool_item_set_expand ()

void        gtk_tool_item_set_expand        (GtkToolItem *tool_item,
                                             gboolean expand);

Устанавливает должен ли tool_item расширятся на всё свободное пространство если на панели его больше чем нужно для пункта. Это заставляет пункт увеличиваться при увеличении панели и уменьшаться при её уменьшении.

tool_item :

GtkToolItem:

expand :

Должен ли tool_item расширяться на всё доступное пространство.

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


gtk_tool_item_get_expand ()

gboolean    gtk_tool_item_get_expand        (GtkToolItem *tool_item);

Определяет расширяется ли tool_item на всё доступное пространство. Смотрите gtk_tool_item_set_expand().

tool_item :

GtkToolItem:

Возвращает :

TRUE если tool_item расширяется на всё доступное пространство.

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


gtk_tool_item_set_tooltip ()

void        gtk_tool_item_set_tooltip       (GtkToolItem *tool_item,
                                             GtkTooltips *tooltips,
                                             const gchar *tip_text,
                                             const gchar *tip_private);

Устанавливает объект GtkTooltips используемый для tool_item, текст отображаемый как подсказка для пункта и дополнительный текст подсказки. Смотрите gtk_tooltips_set_tip().

tool_item :

GtkToolItem:

tooltips :

Используемый объект GtkTooltips

tip_text :

Текст используемый как подсказка для tool_item

tip_private :

Текст используемый как дополнительная подсказка

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


gtk_tool_item_set_use_drag_window ()

void        gtk_tool_item_set_use_drag_window
                                            (GtkToolItem *toolitem,
                                             gboolean use_drag_window);

Устанавливает имеет ли toolitem окно для перемещения. Если TRUE инструментальный пункт может использоваться как источник для перемещения с помощью gtk_drag_source_set(). Когда toolitem имеет окно для перемещения оно будет перехватывать все события, даже те которые посланы дочернему виджету toolitem.

toolitem :

GtkToolItem

use_drag_window :

Имеет ли toolitem окно для перемещения.

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


gtk_tool_item_get_use_drag_window ()

gboolean    gtk_tool_item_get_use_drag_window
                                            (GtkToolItem *toolitem);

Определяет имеет ли toolitem окно для перемещения. Смотрите gtk_tool_item_set_use_drag_window().

toolitem :

GtkToolItem

Возвращает :

TRUE если toolitem использует окно для перемещения.

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


gtk_tool_item_set_visible_horizontal ()

void        gtk_tool_item_set_visible_horizontal
                                            (GtkToolItem *toolitem,
                                             gboolean visible_horizontal);

Устанавливает видим ли toolitem при горизонтальном расположении панели инструментов.

toolitem :

GtkToolItem

visible_horizontal :

Видим ли toolitem при горизонтальном режиме панели

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


gtk_tool_item_get_visible_horizontal ()

gboolean    gtk_tool_item_get_visible_horizontal
                                            (GtkToolItem *toolitem);

Определяет видим ли toolitem при горизонтальном режиме расположения панели.

toolitem :

GtkToolItem

Возвращает :

TRUE если toolitem видим при горизонтальном расположении панели.

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


gtk_tool_item_set_visible_vertical ()

void        gtk_tool_item_set_visible_vertical
                                            (GtkToolItem *toolitem,
                                             gboolean visible_vertical);

Устанавливает видим ли toolitem при вертикальном расположении панели. Некоторые инструментальные пункты, такие как поле для ввода текста, являются слишком широкими для размещения на вертикальной панели. Если visible_vertical равен FALSE toolitem не будет размещаться на вертикально расположенной панели инструментов.

toolitem :

GtkToolItem

visible_vertical :

Должен ли быть видим toolitem при вертикальном режиме

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


gtk_tool_item_get_visible_vertical ()

gboolean    gtk_tool_item_get_visible_vertical
                                            (GtkToolItem *toolitem);

Определяет видим ли toolitem при вертикальном расположении панели. Смотрите gtk_tool_item_set_visible_vertical().

toolitem :

GtkToolItem

Возвращает :

Видим ли toolitem при вертикальном расположении

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


gtk_tool_item_set_is_important ()

void        gtk_tool_item_set_is_important  (GtkToolItem *tool_item,
                                             gboolean is_important);

Устанавливает должен ли tool_item рассматриваться как важный. GtkToolButton класс использует это свойство для определения показывать или скрыть ярлык когда стиль панели инструментов установлен в GTK_TOOLBAR_BOTH_HORIZ. Как результат только инструментальные кнопки со свойством "is_important" имеют ярлыки, эффект известный как "priority text"

tool_item :

GtkToolItem

is_important :

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

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


gtk_tool_item_get_is_important ()

gboolean    gtk_tool_item_get_is_important  (GtkToolItem *tool_item);

Определяет рассматривается ли tool_item как важный. Смотрите gtk_tool_item_set_is_important()

tool_item :

GtkToolItem

Возвращает :

TRUE если tool_item рассматривается как важный.

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


gtk_tool_item_get_icon_size ()

GtkIconSize gtk_tool_item_get_icon_size     (GtkToolItem *tool_item);

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

tool_item :

GtkToolItem:

Возвращает :

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

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


gtk_tool_item_get_orientation ()

GtkOrientation gtk_tool_item_get_orientation
                                            (GtkToolItem *tool_item);

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

tool_item :

GtkToolItem:

Возвращает :

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

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


gtk_tool_item_get_toolbar_style ()

GtkToolbarStyle gtk_tool_item_get_toolbar_style
                                            (GtkToolItem *tool_item);

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

Возможные стили:

tool_item :

GtkToolItem:

Возвращает :

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

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


gtk_tool_item_get_relief_style ()

GtkReliefStyle gtk_tool_item_get_relief_style
                                            (GtkToolItem *tool_item);

Определяет стиль рельефа tool_item. Смотрите gtk_button_set_relief_style(). Обычно подкласс GtkToolItem должен вызывать эту функцию для обработки сигнала GtkToolItem::toolbar_reconfigured определяющего стиль рельефа кнопок.

tool_item :

GtkToolItem:

Возвращает :

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

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


gtk_tool_item_retrieve_proxy_menu_item ()

GtkWidget*  gtk_tool_item_retrieve_proxy_menu_item
                                            (GtkToolItem *tool_item);

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

tool_item :

GtkToolItem:

Возвращает :

GtkMenuItem который появиться в меню переполнения для tool_item.

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


gtk_tool_item_get_proxy_menu_item ()

GtkWidget*  gtk_tool_item_get_proxy_menu_item
                                            (GtkToolItem *tool_item,
                                             const gchar *menu_item_id);

Если menu_item_id соответствует строке помещаемой в gtk_tool_item_set_proxy_menu_item() возвращается соответствующий GtkMenuItem.

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

tool_item :

GtkToolItem:

menu_item_id :

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

Возвращает :

GtkMenuItem помещаемый в gtk_tool_item_set_proxy_menu_item(), если menu_item_ids соответствует.

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


gtk_tool_item_set_proxy_menu_item ()

void        gtk_tool_item_set_proxy_menu_item
                                            (GtkToolItem *tool_item,
                                             const gchar *menu_item_id,
                                             GtkWidget *menu_item);

Устанавливает GtkMenuItem используемый в меню переполнения панели. menu_item_id используется для идентификации вызывающего эту функцию и должен также использоваться с gtk_tool_item_get_proxy_menu_item().

tool_item :

GtkToolItem:

menu_item_id :

Строка используемая для идентификации menu_item

menu_item :

GtkMenuItem используемый в меню переполнения

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


gtk_tool_item_rebuild_menu ()

void        gtk_tool_item_rebuild_menu      (GtkToolItem *tool_item);

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

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

tool_item :

GtkToolItem

Начиная с версии 2.6

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

Свойство "is-important"

  "is-important"         gboolean              : Read / Write

Должен ли пункт панели рассматриваться как важный. Если TRUE, кнопки панели инструментов показывают текст в режиме GTK_TOOLBAR_BOTH_HORIZ.

Значение по умолчанию: FALSE


Свойство "visible-horizontal"

  "visible-horizontal"   gboolean              : Read / Write

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

Значение по умолчанию: TRUE


Свойство "visible-vertical"

  "visible-vertical"     gboolean              : Read / Write

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

Значение по умолчанию: TRUE

Детали сигналов

Сигнал "create-menu-proxy"

gboolean    user_function                  (GtkToolItem *toolitem,
                                            gpointer     user_data)      : Run last

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

Панель инструментов может кэшировать результат этого сигнала. Когда пункт меню изменяется он должен вызвать gtk_tool_item_rebuild_menu() для аннулирования кэша и убедиться в том что панель инструментов перестроила меню переполнения.

toolitem :

объект издающий сигнал

user_data :

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

Возвращает :

TRUE если сигнал был обработан, FALSE if not


Сигнал "set-tooltip"

gboolean    user_function                  (GtkToolItem *toolitem,
                                            GtkTooltips *tooltips,
                                            gchar       *tip_text,
                                            gchar       *tip_private,
                                            gpointer     user_data)        : Run last

This signal is emitted when the toolitem's tooltip changes. Application developers can use gtk_tool_item_set_tooltip() to set the item's tooltip.

toolitem :

объект издающий сигнал

tooltips :

the GtkTooltips

tip_text :

the tooltip text

tip_private :

the tooltip private text

user_data :

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

Возвращает :

TRUE если сигнал был обработан, FALSE если нет


Сигнал "toolbar-reconfigured"

void        user_function                  (GtkToolItem *toolitem,
                                            gpointer     user_data)      : Run last

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

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

toolitem :

объект издающий сигнал

user_data :

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

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

GtkToolbar

Виджет панели инструментов

GtkToolButton

Подкласс GtkToolItem отображающий кнопки на панели инструментов

GtkSeparatorToolItem

Подкласс GtkToolItem который разделяет группы пунктов на панели инструментов




Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру