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

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

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

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

Свойства

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

Сигналы

Описание

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
			который разделяет группы пунктов на
			панели инструментов