The OpenNET Project / Index page

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

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

Prev

Up

Home

GTK+ Reference Manual

Next

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

GtkToolButton

GtkToolButton GtkToolItem подкласс отображающий кнопки

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

#include <gtk/gtk.h>


            GtkToolButton;
GtkToolItem* gtk_tool_button_new            (GtkWidget *icon_widget,
                                             const gchar *label);

GtkToolItem* gtk_tool_button_new_from_stock (const gchar *stock_id);
void        gtk_tool_button_set_label       (GtkToolButton *button,
                                             const gchar *label);
const gchar* gtk_tool_button_get_label      (GtkToolButton *button);
void        gtk_tool_button_set_use_underline

                                            (GtkToolButton *button,
                                             gboolean use_underline);
gboolean    gtk_tool_button_get_use_underline
                                            (GtkToolButton *button);
void        gtk_tool_button_set_stock_id    (GtkToolButton *button,
                                             const gchar *stock_id);
const gchar* gtk_tool_button_get_stock_id   (GtkToolButton *button);
void        gtk_tool_button_set_icon_name   (GtkToolButton *button,
                                             const gchar *icon_name);
const gchar* gtk_tool_button_get_icon_name  (GtkToolButton *button);
void        gtk_tool_button_set_icon_widget (GtkToolButton *button,
                                             GtkWidget *icon_widget);

GtkWidget*  gtk_tool_button_get_icon_widget (GtkToolButton *button);
void        gtk_tool_button_set_label_widget
                                            (GtkToolButton *button,
                                             GtkWidget *label_widget);

GtkWidget*  gtk_tool_button_get_label_widget
                                            (GtkToolButton *button);

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

  GObject

   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin

                                 +----GtkToolItem
                                       +----GtkToolButton
                                             +----GtkMenuToolButton
                                             +----GtkToggleToolButton

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

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

Свойства

  "icon-name"            gchararray            : Read / Write
  "icon-widget"          GtkWidget             : Read / Write
  "label"                gchararray            : Read / Write
  "label-widget"         GtkWidget             : Read / Write
  "stock-id"             gchararray            : Read / Write
  "use-underline"        gboolean              : Read / Write

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

  "icon-spacing"         gint                  : Read / Write

Сигналы

"clicked"   void        user_function      (GtkToolButton *toolbutton,
                                            gpointer       user_data)       : Run first / Action

Описание

GtkToolButtons является GtkToolItems содержащим кнопки.

Используйте gtk_tool_button_new() для создания нового GtkToolButton. Используйте gtk_tool_button_new_with_stock() для создания нового GtkToolButton содержащего заготовленный пункт.

Ярлык GtkToolButton определяется с помощью свойств "label_widget", "label", и "stock_id". Если "label_widget" не-NULL, то когда этот виджет используется как ярлык. Или, если "label" не-NULL, то когда эта строка используется как ярлык. Или, если "stock_id" не-NULL, ярлык определяется заготовленным пунктом. Иначе, кнопка не имеет ярлыка.

Значок GtkToolButton определяется свойствами "icon_widget" и "stock_id". Если "icon_widget" не-NULL, то когда этот виджет используется как значок. Или, если "stock_id" не-NULL, значок определяется заготовленным пунктом. Иначе, кнопка не имеет значка.

Детали

GtkToolButton

typedef struct _GtkToolButton GtkToolButton;

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


gtk_tool_button_new ()

GtkToolItem* gtk_tool_button_new            (GtkWidget *icon_widget,
                                             const gchar *label);

Создаёт новый GtkToolButton используя icon_widget как значок, а label как ярлык.

icon_widget :

Виджет который используется как значок, или NULL

label :

Строка используется как ярлык, или NULL

Возвращает :

Новый GtkToolButton

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


gtk_tool_button_new_from_stock ()

GtkToolItem* gtk_tool_button_new_from_stock (const gchar *stock_id);

Создаёт новый GtkToolButton содержащий изображение и текст из заготовленного пункта. Некоторые id заготовок имеют макрокоманды препроцессора такие как GTK_STOCK_OK и GTK_STOCK_APPLY.

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

stock_id :

Имя заготовленного пункта

Возвращает :

Новый GtkToolButton

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


gtk_tool_button_set_label ()

void        gtk_tool_button_set_label       (GtkToolButton *button,
                                             const gchar *label);

Устанавливает label как ярлык используемый для инструментальной кнопки. Свойство "label" имеет эффект только если не перекрывается не-NULL свойством "label_widget". Если оба свойства "label_widget" и "label" являются NULL, ярлык определяется свойством "stock_id". Если "stock_id" свойство тоже NULL, button не имеет ярлыка.

button :

GtkToolButton

label :

Строка используемая как ярлык, или NULL.

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


gtk_tool_button_get_label ()

const gchar* gtk_tool_button_get_label      (GtkToolButton *button);

Возвращает ярлык используемый инструментальной кнопкой, или NULL если инструментальная кнопка не имеет ярлыка. Или используется ярлык из заготовленного пункта. Возвращаемой строкой владеет GTK+ и её не нужно освобождать или модифицировать.

button :

GtkToolButton

Возвращает :

Ярлык, или NULL

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


gtk_tool_button_set_use_underline ()

void        gtk_tool_button_set_use_underline
                                            (GtkToolButton *button,
                                             gboolean use_underline);

Если установлено, подчеркивание в свойстве label указывает что следующий символ должен использоваться как мнемонический акселератор в меню переполнения. Например, если свойство label "_Open" и use_underline равно TRUE, ярлык на инструментальной кнопке будет "Open" а пункт в меню переполнения будет иметь подчеркнутую 'O'.

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

button :

GtkToolButton

use_underline :

Имеет ли ярлык кнопки форму "_Open"

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


gtk_tool_button_get_use_underline ()

gboolean    gtk_tool_button_get_use_underline
                                            (GtkToolButton *button);

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

button :

GtkToolButton

Возвращает :

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

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


gtk_tool_button_set_stock_id ()

void        gtk_tool_button_set_stock_id    (GtkToolButton *button,
                                             const gchar *stock_id);

Устанавливает имя заготовленного пункта. Смотрите gtk_tool_button_new_from_stock(). Свойство stock_id имеет эффект только если не перекрывается не-NULL свойствами "label" и "icon_widget".

button :

GtkToolButton

stock_id :

Имя заготовленного пункта, или NULL

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


gtk_tool_button_get_stock_id ()

const gchar* gtk_tool_button_get_stock_id   (GtkToolButton *button);

Возвращает имя заготовленного пункта. Смотрите gtk_tool_button_set_stock_id(). Возвращаемой строкой владеет GTK+ и её не нужно освобождать или модифицировать.

button :

GtkToolButton

Возвращает :

Имя заготовленного пункта для button.

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


gtk_tool_button_set_icon_name ()

void        gtk_tool_button_set_icon_name   (GtkToolButton *button,
                                             const gchar *icon_name);

Устанавливает значок для инструментальной кнопки из именованной темы значков. Смотрите документацию по GtkIconTheme. Свойство "icon_name" имеет эффект только если не перекрывается не-NULL свойствами "label", "icon_widget" и "stock_id".

button :

GtkToolButton

icon_name :

Имя тематического значка

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


gtk_tool_button_get_icon_name ()

const gchar* gtk_tool_button_get_icon_name  (GtkToolButton *button);

Возвращает имя именованного значка для инструментальной кнопки, смотрите gtk_tool_button_set_icon_name().

button :

GtkToolButton

Возвращает :

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

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


gtk_tool_button_set_icon_widget ()

void        gtk_tool_button_set_icon_widget (GtkToolButton *button,
                                             GtkWidget *icon_widget);

Устанавливает icon как виджет используемый как значок на button. Если icon_widget равен NULL значок определяется свойством "stock_id". Если свойство "stock_id" также равно NULL, button не имеет значка.

button :

GtkToolButton

icon_widget :

Виджет используемый как значок, или NULL

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


gtk_tool_button_get_icon_widget ()

GtkWidget*  gtk_tool_button_get_icon_widget (GtkToolButton *button);

Возвращает виджет используемый как значок на button. Смотрите gtk_tool_button_set_icon_widget().

button :

GtkToolButton

Возвращает :

Виджет используемый как значок на button, или NULL.

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


gtk_tool_button_set_label_widget ()

void        gtk_tool_button_set_label_widget
                                            (GtkToolButton *button,
                                             GtkWidget *label_widget);

Устанавливает label_widget как виджет используемый в качестве ярлыка для button. Если label_widget равен NULL свойство "label" используется как ярлык. Если "label" тоже NULL, ярлык определяется с помощью свойства "stock_id". Если и "stock_id" равен NULL, button не имеет ярлыка.

button :

GtkToolButton

label_widget :

Виджет используемый как ярлык, или NULL

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


gtk_tool_button_get_label_widget ()

GtkWidget*  gtk_tool_button_get_label_widget
                                            (GtkToolButton *button);

Возвращает виджет используемый как ярлык на button. Смотрите gtk_tool_button_set_label_widget().

button :

GtkToolButton

Возвращает :

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

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

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

Свойство "icon-name"

  "icon-name"            gchararray            : Read / Write

Имя тематического значка отображаемого на пункте. Это свойство имеет эффект если не перекрывается свойствами "label", "icon_widget" или "stock_id".

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

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


Свойство "icon-widget"

  "icon-widget"          GtkWidget             : Read / Write

Виджет значок отображаемый в пункте.


Свойство "label"

  "label"                gchararray            : Read / Write

Текст показываемый в пункте.

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


Свойство "label-widget"

  "label-widget"         GtkWidget             : Read / Write

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


Свойство "stock-id"

  "stock-id"             gchararray            : Read / Write

Заготовленный значок отображаемый на пункте.

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


Свойство "use-underline"

  "use-underline"        gboolean              : Read / Write

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

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

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

Свойство стиля "icon-spacing"

  "icon-spacing"         gint                  : Read / Write

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

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

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

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

Сигнал "clicked"

void        user_function                  (GtkToolButton *toolbutton,
                                            gpointer       user_data)       : Run first / Action

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

toolbutton :

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

user_data :

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

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

GtkToolbar

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

GtkMenuToolButton

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

GtkToggleToolButton

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

GtkRadioToolButton

Подкласс GtkToolButton который отображает радио-кнопку на панели инструментов

GtkSeparatorToolItem

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






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

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