Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties

GtkAlignment

GtkAlignment Виджет управляющий размером и выравниванием своего дочернего виджета

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

#include <gtk/gtk.h> GtkAlignment; GtkWidget* gtk_alignment_new (gfloat xalign, gfloat yalign, gfloat xscale, gfloat yscale); void gtk_alignment_set (GtkAlignment *alignment, gfloat xalign, gfloat yalign, gfloat xscale, gfloat yscale); void gtk_alignment_get_padding (GtkAlignment *alignment, guint *padding_top, guint *padding_bottom, guint *padding_left, guint *padding_right); void gtk_alignment_set_padding (GtkAlignment *alignment, guint padding_top, guint padding_bottom, guint padding_left, guint padding_right);

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

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkAlignment

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

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

Свойства

"bottom-padding" guint : Read / Write "left-padding" guint : Read / Write "right-padding" guint : Read / Write "top-padding" guint : Read / Write "xalign" gfloat : Read / Write "xscale" gfloat : Read / Write "yalign" gfloat : Read / Write "yscale" gfloat : Read / Write

Описание

Виджет GtkAlignment контролирует размер и выравнивание своего дочернего виджета. Он имеет четыре настройки: xscale, yscale, xalign, и yalign.

Настройки масштаба применяются для определения того, насколько дочерний виджет может расширяться в рамках распределённого пространства GtkAlignment. Диапазон значений от 0 (дочерний виджет вообще не расширяется) до 1 (дочерний виджет заполняет всё доступное пространство).

Настройки выравнивания используются для размещения дочернего виджета в пределах доступного пространства. Диапазон значений от 0 (вверху или слева) до 1 (внизу или справа). Естественно, если настройки масштабирования установлены в значение равное 1, настройки выравнивания не имеют никакого эффекта.

Детали

GtkAlignment

typedef struct _GtkAlignment GtkAlignment;

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





gtk_alignment_new ()

GtkWidget*  gtk_alignment_new               (gfloat xalign,
                                             gfloat yalign,
                                             gfloat xscale,
                                             gfloat yscale);

Создаёт новый GtkAlignment. 




	
	
	

		
			
xalign :

				
		
			
Горизонтальное выравнивание дочернего
			виджета от 0 (левое) до 1 (правое) 
			

				
	

	

		
			
yalign :

				
		
			
Вертикальное выравнивание дочернего
			виджета от 0 (верх) до 1 (низ). 
			

				
	

	

		
			
xscale :

				
		
			
Количество свободного, горизонтального
			пространства которое заполняет
			дочерний виджет, от 0 до 1. Значение 0
			запрещает дочернему виджету расширяться.
			Значение 1 указывает на полное заполнение
			пространства распределяемого
			GtkAlignment. 
			

				
	

	

		
			
yscale :

				
		
			
Количество свободного пространства
			заполняемого дочерним виджетом
			вертикально, от 0 до 1. Значения аналогичны
			xscale. 
			

				
	

	

		
			
Возвращает :

				
		
			
новый GtkAlignment. 
			

				
	






gtk_alignment_set ()

void        gtk_alignment_set               (GtkAlignment *alignment,
                                             gfloat xalign,
                                             gfloat yalign,
                                             gfloat xscale,
                                             gfloat yscale);

Устанавливает GtkAlignment значения.




	
	
	

		
			
alignment :

				
		
			
 GtkAlignment. 
			

				
	

	

		
			
xalign :

				
		
			
Горизонтальное выравнивание дочернего
			виджета от 0 (левое) до 1 (правое) 
			

				
	

	

		
			
yalign :

				
		
			
Вертикальное выравнивание дочернего
			виджета от 0 (верх) до 1 (низ). 
			

				
	

	

		
			
xscale :

				
		
			
Количество свободного, горизонтального
			пространства которое заполняет
			дочерний виджет, от 0 до 1. Значение 0
			запрещает дочернему виджету расширяться.
			Значение 1 указывает на полное заполнение
			пространства распределяемого
			GtkAlignment. 
			

				
	

	

		
			
yscale :

				
		
			
Количество свободного пространства
			заполняемого дочерним виджетом
			вертикально, от 0 до 1. Значения аналогичны
			xscale. 
			

				
	






gtk_alignment_get_padding ()

void        gtk_alignment_get_padding       (GtkAlignment *alignment,
                                             guint *padding_top,
                                             guint *padding_bottom,
                                             guint *padding_left,
                                             guint *padding_right);

Получает дополнение с разных сторон
виджета. Смотрите gtk_alignment_set_padding().



	
	
	

		
			
alignment :

				
		
			
 GtkAlignment 
			

				
	

	

		
			
padding_top :

				
		
			
Значение дополнения сверху от
			виджета, или NULL
						

				
	

	

		
			
padding_bottom :

				
		
			
Значение дополнения снизу от виджета,
			или NULL
						

				
	

	

		
			
padding_left :

				
		
			
Значение дополнения слева от виджета,
			или NULL
						

				
	

	

		
			
padding_right :

				
		
			
Значение дополнения справа от
			виджета, или NULL
						

				
	




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





gtk_alignment_set_padding ()

void        gtk_alignment_set_padding       (GtkAlignment *alignment,
                                             guint padding_top,
                                             guint padding_bottom,
                                             guint padding_left,
                                             guint padding_right);

Устанавливает дополнение с разных
сторон виджета. Дополнение добавляет
свободное пространство с разных сторон
виджета. Например, используя дополнение
можно выравнивать виджет к противоположной
стороне от дополнения.



	
	
	

		
			
alignment :

				
		
			
 GtkAlignment 
			

				
	

	

		
			
padding_top :

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

				
	

	

		
			
padding_bottom :

				
		
			
дополнение снизу от виджета 
			

				
	

	

		
			
padding_left :

				
		
			
дополнение слева от виджета

				
	

	

		
			
padding_right :

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

				
	




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



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


Свойство "bottom-padding"


  "bottom-padding"       guint                 : Read / Write

Дополнение вставляемое снизу от виджета.


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


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


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





Свойство "left-padding"


  "left-padding"         guint                 : Read / Write

Дополнение вставляемое слева от виджета.


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


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


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





Свойство "right-padding"


  "right-padding"        guint                 : Read / Write

Дополнение вставляемое справа от
виджета.


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


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


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





Свойство "top-padding"


  "top-padding"          guint                 : Read / Write

Дополнение вставляемое сверху от
виджета.


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


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


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





Свойство "xalign"


  "xalign"               gfloat                : Read / Write

Горизонтальная позиция дочернего
виджета в доступном пространстве. 0.0
левое выравнивание, 1.0 правое выравнивание.


Допустимые значения: [0,1]


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




Свойство "xscale"


  "xscale"               gfloat                : Read / Write

Если доступное горизонтальное пространство
больше чем необходимо для дочернего
виджета, сколько из этого пространства
нужно использовать для дочернего
виджета. 0.0 нисколько, 1.0 всё.


Допустимые значения: [0,1]


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




Свойство "yalign"


  "yalign"               gfloat                : Read / Write

Вертикальная позиция дочернего виджета
в доступном пространстве. 0.0 верхнее
выравнивание, 1.0 нижнее выравнивание.


Допустимые значения: [0,1]


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




Свойство "yscale"


  "yscale"               gfloat                : Read / Write

Если доступное вертикальное пространство
больше чем необходимо для дочернего
виджета, сколько из этого пространства
нужно использовать для дочернего
виджета. 0.0 нисколько, 1.0 всё.


Допустимые значения: [0,1]


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