Prev

Up

Home

GTK+ Reference Manual

Next

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

GtkButtonBox

GtkButtonBox Базовый класс для GtkHButtonBox и GtkVButtonBox

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

#include <gtk/gtk.h> GtkButtonBox; #define GTK_BUTTONBOX_DEFAULT #define gtk_button_box_get_spacing (b) GtkButtonBoxStyle gtk_button_box_get_layout (GtkButtonBox *widget); void gtk_button_box_get_child_size (GtkButtonBox *widget, gint *min_width, gint *min_height); void gtk_button_box_get_child_ipadding (GtkButtonBox *widget, gint *ipad_x, gint *ipad_y); gboolean gtk_button_box_get_child_secondary (GtkButtonBox *widget, GtkWidget *child); #define gtk_button_box_set_spacing (b,s) void gtk_button_box_set_layout (GtkButtonBox *widget, GtkButtonBoxStyle layout_style); void gtk_button_box_set_child_size (GtkButtonBox *widget, gint min_width, gint min_height); void gtk_button_box_set_child_ipadding (GtkButtonBox *widget, gint ipad_x, gint ipad_y); void gtk_button_box_set_child_secondary (GtkButtonBox *widget, GtkWidget *child, gboolean is_secondary);

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

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkButtonBox +----GtkHButtonBox +----GtkVButtonBox

Реализуемые интерфейсы

GtkButtonBox реализует AtkImplementorIface.

Свойства

"layout-style" GtkButtonBoxStyle : Read / Write

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

"secondary" gboolean : Read / Write

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

"child-internal-pad-x" gint : Read "child-internal-pad-y" gint : Read "child-min-height" gint : Read "child-min-width" gint : Read

Описание

Первичная цель этого класса заключается в том, чтобы отслеживать различные свойства GtkHButtonBox и GtkVButtonBox виджетов.

gtk_button_box_get_child_size() определяет минимальную высоту и ширину виджетов в полученном контейнере кнопок. gtk_button_box_set_child_size() позволяет изменять эти свойства.

Внутреннее дополнение кнопок может быть определено и изменено с помощью gtk_button_box_get_child_ipadding() и gtk_button_box_set_child_ipadding() соответственно.

gtk_button_box_get_spacing() и gtk_button_box_set_spacing() определяет и изменяет интервал между кнопками соответственно.

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

Основная цель GtkButtonBox заставить все дочерние кнопки иметь одинаковый размер. Поэтому он игнорирует свойство однородности (homogeneous) которое он унаследовал от GtkBox, и всегда ведёт себя как если бы свойство однородности имело значение TRUE.

Детали

GtkButtonBox

typedef struct _GtkButtonBox GtkButtonBox;

Эта структура только для чтения; никакие
её члены не должны меняться непосредственно.





GTK_BUTTONBOX_DEFAULT


#define GTK_BUTTONBOX_DEFAULT -1

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





gtk_button_box_get_spacing()


#define gtk_button_box_get_spacing(b)   gtk_box_get_spacing (GTK_BOX (b))

Внимание


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


Определяет интервал между кнопками.




	
	
	

		
			
b :

				
		
			
GtkButtonBox 
			

				
	

	

		
			
Возвращает:

				
		
			
Текущий интервал между кнопками в
			widget. 
			

				
	






gtk_button_box_get_layout ()


GtkButtonBoxStyle gtk_button_box_get_layout (GtkButtonBox *widget);

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




	
	
	

		
			
widget :

				
		
			
GtkButtonBox. 
			

				
	

	

		
			
Возвращает:

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

				
	






gtk_button_box_get_child_size ()

void        gtk_button_box_get_child_size   (GtkButtonBox *widget,
                                             gint *min_width,
                                             gint *min_height);

Внимание


gtk_button_box_get_child_size
устарела и не должна использоваться во
вновь создаваемом коде. Вместо неё
используйте свойство стиля
"child-min-width/-height".


Определяет текущую ширину и высоту
всех дочерних виджетов в контейнере
кнопок. min_width и min_height
являются полями которые заполняются
этими значениями, соответственно. 




	
	
	

		
			
widget :

				
		
			
GtkButtonBox. 
			

				
	

	

		
			
min_width :

				
		
			
Ширина кнопок содержащихся в widget.
						

				
	

	

		
			
min_height :

				
		
			
Высота кнопок содержащихся в widget.
						

				
	






gtk_button_box_get_child_ipadding ()

void        gtk_button_box_get_child_ipadding
                                            (GtkButtonBox *widget,
                                             gint *ipad_x,
                                             gint *ipad_y);

Внимание


gtk_button_box_get_child_ipadding
устарела и не должна использоваться во
вновь создаваемом коде. Используйте
вместо неё свойство стиля
"child-internal-pad-x/-y".


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




	
	
	

		
			
widget :

				
		
			
GtkButtonBox. 
			

				
	

	

		
			
ipad_x :

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

				
	

	

		
			
ipad_y :

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

				
	






gtk_button_box_get_child_secondary ()

gboolean    gtk_button_box_get_child_secondary
                                            (GtkButtonBox *widget,
                                             GtkWidget *child);

Определяет должен ли child
появляться во вторичной группе дочерних
виджетов.



	
	
	

		
			
widget :

				
		
			
GtkButtonBox 
			

				
	

	

		
			
child :

				
		
			
Дочерний виджет для widget
						

				
	

	

		
			
Возвращает:

				
		
			
должен ли child появляться во
			вторичной группе дочерних виджетов.

				
	




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





gtk_button_box_set_spacing()


#define gtk_button_box_set_spacing(b,s) gtk_box_set_spacing (GTK_BOX (b), s)

Внимание


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


Устанавливает интервал между кнопок
в полученном контейнере кнопок. 




	
	
	

		
			
b :

				
		
			
GtkButtonBox. 
			

				
	

	

		
			
s :

				
		
			
Интервал в пикселах. 
			

				
	






gtk_button_box_set_layout ()

void        gtk_button_box_set_layout       (GtkButtonBox *widget,
                                             GtkButtonBoxStyle layout_style);

Изменяет способ выравнивания кнопок в
контейнере. 




	
	
	

		
			
widget :

				
		
			
GtkButtonBox. 
			

				
	

	

		
			
layout_style :

				
		
			
Новый стиль выравнивания. 
			

				
	






gtk_button_box_set_child_size ()

void        gtk_button_box_set_child_size   (GtkButtonBox *widget,
                                             gint min_width,
                                             gint min_height);

Внимание


gtk_button_box_set_child_size
устарела и не должна использоваться во
вновь создаваемом коде. Вместо неё
используйте свойство стиля
"child-min-width/-height".


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




	
	
	

		
			
widget :

				
		
			
GtkButtonBox. 
			

				
	

	

		
			
min_width :

				
		
			
Ширина по умолчанию для кнопок в
			widget. 
			

				
	

	

		
			
min_height :

				
		
			
Высота по умолчанию для кнопок в 
			widget. 
			

				
	






gtk_button_box_set_child_ipadding ()

void        gtk_button_box_set_child_ipadding
                                            (GtkButtonBox *widget,
                                             gint ipad_x,
                                             gint ipad_y);

Внимание


gtk_button_box_set_child_ipadding
устарела и не должна использоваться во
вновь создаваемом коде. Вместо неё
используйте свойство стиля
"child-internal-pad-x/-y".


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




	
	
	

		
			
widget :

				
		
			
GtkButtonBox. 
			

				
	

	

		
			
ipad_x :

				
		
			
Горизонтальное дополнение которое
			должно использоваться каждой кнопкой
			в widget. 
			

				
	

	

		
			
ipad_y :

				
		
			
Вертикальное дополнение которое
			должно использоваться каждой кнопкой
			в widget.

				
	






gtk_button_box_set_child_secondary ()

void        gtk_button_box_set_child_secondary
                                            (GtkButtonBox *widget,
                                             GtkWidget *child,
                                             gboolean is_secondary);

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



Эта группа появляется после других
дочерних виджетов если стиль
GTK_BUTTONBOX_START,
GTK_BUTTONBOX_SPREAD
или GTK_BUTTONBOX_EDGE,
и перед другими дочерними виджетами
если стиль GTK_BUTTONBOX_END.
Для горизонтальных контейнеров кнопок,
определение перед/после зависит от
направления виджета (смотрите
gtk_widget_set_direction()).
Если стиль GTK_BUTTONBOX_START
или GTK_BUTTONBOX_END,
то вторичные дочерние виджеты выравниваются
с другого конца контейнера кнопок
относительно основных кнопок. Для других
стилей, они появляются непосредственно
рядом с основными дочерними кнопками.



	
	
	

		
			
widget :

				
		
			
GtkButtonBox 
			

				
	

	

		
			
child :

				
		
			
Дочерний виджет для widget
						

				
	

	

		
			
is_secondary :

				
		
			
Если TRUE,
			child появится во вторичной
			группе контейнера кнопок. 
			

				
	




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


Свойство "layout-style"


  "layout-style"         GtkButtonBoxStyle     : Read / Write

Как выравнивать кнопки в контейнере.
Возможные значения default, spread, edge, start и
end.


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


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


Дочернее свойство "secondary"


  "secondary"            gboolean              : Read / Write

Если TRUE, появиться во вторичной группе
дочерних виджетов, подходит например
для кнопки help.


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


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


Свойство стиля "child-internal-pad-x"


  "child-internal-pad-x" gint                  : Read

Увеличение размера дочернего виджета
с обеих сторон.


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


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




Свойство стиля "child-internal-pad-y"


  "child-internal-pad-y" gint                  : Read

Уменьшение размера дочернего виджета
сверху и снизу.


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


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




Свойство стиля "child-min-height"


  "child-min-height"     gint                  : Read

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


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


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




Свойство стиля "child-min-width"


  "child-min-width"      gint                  : Read

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


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


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


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



	
	
	

		
			
GtkVButtonBox

				
		
			
Вертикальный подкласс GtkButtonBox.

				
	

	

		
			
GtkHButtonBox

				
		
			
Горизонтальный подкласс GtkButtonBox.