GtkToolbar

			GTK+ Reference Manual
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
		
		
			Базовый класс виджетов добавляемых
			на панель инструментов.

`toolbar` :	GtkToolbar
`item` :	GtkToolItem дочерний для `toolbar`
Возвращает:	Позицию пункта на панели.

`toolbar` :	GtkToolbar
`n` :	Позиция на панели
Возвращает:	`n` GtkToolItem на `toolbar`, или `NULL` если нет `n` пункта.

`toolbar` :	GtkToolbar
`x` :	x координаты на панели
`y` :	y координаты на панели
Возвращает:	Позиция соответствующая точке (`x`, `y`) на панели.

`toolbar` :	GtkToolbar
`tool_item` :	GtkToolItem, или `NULL` для выключения подсвечивания
`index_` :	Позиция на `toolbar`

`toolbar` :	GtkToolbar.
`enable` :	`FALSE` для отключения подсказок, или `TRUE` для включения.

`toolbar` :	GtkToolbar
`item` :	GtkToolItem
`pos` :	Позиция нового пункта

`toolbar` :	GtkToolbar
`show_arrow` :	Показывается ли меню переполнения

`toolbar` :	GtkToolbar.
`orientation` :	новый GtkOrientation.

`toolbar` :	GtkToolbar.
`text` :	ярлык для вашей кнопки на панели.
`tooltip_text` :	подсказка которая появляется при наведении курсора на данный пункт панели.
`tooltip_private_text` :	используйте с GtkTipsQuery.
`icon` :	GtkWidget который используется как значок для кнопки.
`callback` :	функция которая исполняется при нажатии на кнопку.
`user_data` :	указатель на данные которые помещаются в функцию.
Возвращает:	новый пункт панели как GtkWidget.

`toolbar` :	GtkToolbar.
`text` :	ярлык для вашей кнопки на панели.
`tooltip_text` :	подсказка которая появляется при наведении курсора на данный пункт панели.
`tooltip_private_text` :	используйте с GtkTipsQuery.
`icon` :	GtkWidget который используется как значок для кнопки.
`callback` :	функция которая исполняется при нажатии на кнопку.
`user_data` :	указатель на данные которые помещаются в функцию.
Возвращает:	новый пункт панели как GtkWidget.

`toolbar` :	GtkToolbar
`position` :	Количество виджетов после которого будет вставлен интервал.

`toolbar` :	GtkToolbar.
`type` :	значение типа GtkToolbarChildType который определяет каким `widget` должен быть.
`widget` :	GtkWidget, или `NULL`.
`text` :	элемент ярлык.
`tooltip_text` :	элемент подсказка.
`tooltip_private_text` :	используемый контекст всплывающей подсказки об этом элементе панели.
`icon` :	GtkWidget который обеспечивает изображение для элементов функции.
`callback` :	функция которая исполняется при нажатии на кнопку.
`user_data` :	любые ваши данные помещаемые в функцию.
Возвращает:	новый элемент панели как GtkWidget.

`toolbar` :	GtkToolbar.
`widget` :	GtkWidget добавляемый на панель.
`tooltip_text` :	элемент подсказка.
`tooltip_private_text` :	используемый контекст всплывающей подсказки об этом элементе панели.

`toolbar` :	GtkToolbar.
`style` :	новый стиль для `toolbar`.

`toolbar` :	GtkToolbar
`stock_id` :	id заготовленного пункта который вы хотите вставить
`tooltip_text` :	Текст подсказки
`tooltip_private_text` :	Закрытый текст подсказки
`callback` :	Callback-функция вызываемая при нажатии на кнопку.
`user_data` :	Данные помещаемые в callback-функцию
`position` :	Позиция в которую будет вставлена кнопка. -1 вставляет в конец.
Возвращает:	Вставляемый виджет

`toolbar` :	GtkToolbar
`icon_size` :	GtkIconSize который будет иметь заготовленный значок в панели инструментов.

`toolbar` :	GtkToolbar которая издала сигнал
`focus_home` :	`TRUE` если первый пункт должен быть в фокусе
`user_data` :	Пользовательские данные устанавливаемые когда подключается обработчик сигнала.
Возвращает:	`TRUE` если сигнал был обработан, `FALSE` если нет

`toolbar` :	GtkToolbar которая издала сигнал
`dir` :	GtkDirection
`user_data` :	Пользовательские данные устанавливаемые когда подключается обработчик сигнала.
Возвращает:	`TRUE` если сигнал был обработан, `FALSE` если нет

`toolbar` :	Объект который издаёт сигнал
`orientation` :	новая GtkOrientation панели
`user_data` :	Пользовательские данные устанавливаемые когда подключается обработчик сигнала.

`toolbar` :	GtkToolbar который издаёт сигнал
`x` :	x координата точки появления меню
`y` :	y координата точки появления меню
`button` :	Кнопка мыши нажимаемая пользователем, или -1
`user_data` :	Пользовательские данные устанавливаемые когда подключается обработчик сигнала.
Возвращает:	`TRUE` если сигнал был обработан, `FALSE` если нет

`toolbar` :	GtkToolbar которая издаёт сигнал
`style` :	новый GtkToolbarStyle панели
`user_data` :	Пользовательские данные устанавливаемые когда подключается обработчик сигнала.