gtkcontainer

			gtk+ reference manual
top \| description \| object hierarchy \| implemented interfaces \| properties \| signals

gtkcontainer — базовый класс для виджетов содержащих другие виджеты

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

#include <gtk/gtk.h>


            gtkcontainer;
#define     gtk_is_resize_container         (widget)
#define     gtk_container_warn_invalid_child_property_id(object, property_id, pspec)
#define     gtk_container_border_width

void        gtk_container_add               (gtkcontainer *container,
                                             gtkwidget *widget);
void        gtk_container_remove            (gtkcontainer *container,
                                             gtkwidget *widget);
void        gtk_container_add_with_properties

                                            (gtkcontainer *container,
                                             gtkwidget *widget,
                                             const gchar *first_prop_name,
                                             ...);
gtkresizemode gtk_container_get_resize_mode (gtkcontainer *container);
void        gtk_container_set_resize_mode   (gtkcontainer *container,
                                             gtkresizemode resize_mode);
void        gtk_container_check_resize      (gtkcontainer *container);
void        gtk_container_foreach           (gtkcontainer *container,
                                             gtkcallback callback,
                                             gpointer callback_data);
void        gtk_container_foreach_full      (gtkcontainer *container,
                                             gtkcallback callback,
                                             gtkcallbackmarshal marshal,
                                             gpointer callback_data,
                                             gtkdestroynotify notify);
#define     gtk_container_children

glist*      gtk_container_get_children      (gtkcontainer *container);
void        gtk_container_set_reallocate_redraws
                                            (gtkcontainer *container,
                                             gboolean needs_redraws);
void        gtk_container_set_focus_child   (gtkcontainer *container,
                                             gtkwidget *child);

gtkadjustment* gtk_container_get_focus_vadjustment
                                            (gtkcontainer *container);
void        gtk_container_set_focus_vadjustment
                                            (gtkcontainer *container,
                                             gtkadjustment *adjustment);

gtkadjustment* gtk_container_get_focus_hadjustment
                                            (gtkcontainer *container);
void        gtk_container_set_focus_hadjustment
                                            (gtkcontainer *container,
                                             gtkadjustment *adjustment);
void        gtk_container_resize_children   (gtkcontainer *container);

gtype       gtk_container_child_type        (gtkcontainer *container);
void        gtk_container_child_get         (gtkcontainer *container,
                                             gtkwidget *child,
                                             const gchar *first_prop_name,
                                             ...);
void        gtk_container_child_set         (gtkcontainer *container,
                                             gtkwidget *child,
                                             const gchar *first_prop_name,
                                             ...);
void        gtk_container_child_get_property

                                            (gtkcontainer *container,
                                             gtkwidget *child,
                                             const gchar *property_name,
                                             gvalue *value);
void        gtk_container_child_set_property
                                            (gtkcontainer *container,
                                             gtkwidget *child,
                                             const gchar *property_name,
                                             const gvalue *value);
void        gtk_container_child_get_valist  (gtkcontainer *container,
                                             gtkwidget *child,
                                             const gchar *first_property_name,
                                             va_list var_args);
void        gtk_container_child_set_valist  (gtkcontainer *container,
                                             gtkwidget *child,
                                             const gchar *first_property_name,
                                             va_list var_args);
void        gtk_container_forall            (gtkcontainer *container,
                                             gtkcallback callback,
                                             gpointer callback_data);

guint       gtk_container_get_border_width  (gtkcontainer *container);
void        gtk_container_set_border_width  (gtkcontainer *container,
                                             guint border_width);
void        gtk_container_propagate_expose  (gtkcontainer *container,
                                             gtkwidget *child,
                                             gdkeventexpose *event);

gboolean    gtk_container_get_focus_chain   (gtkcontainer *container,
                                             glist **focusable_widgets);
void        gtk_container_set_focus_chain   (gtkcontainer *container,
                                             glist *focusable_widgets);
void        gtk_container_unset_focus_chain (gtkcontainer *container);

gparamspec* gtk_container_class_find_child_property
                                            (gobjectclass *cclass,
                                             const gchar *property_name);
void        gtk_container_class_install_child_property
                                            (gtkcontainerclass *cclass,
                                             guint property_id,
                                             gparamspec *pspec);

gparamspec** gtk_container_class_list_child_properties
                                            (gobjectclass *cclass,
                                             guint *n_properties);

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

  gobject
   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget

                     +----gtkcontainer
                           +----gtkbin
                           +----gtkbox
                           +----gtkclist
                           +----gtkfixed
                           +----gtkpaned

                           +----gtkiconview
                           +----gtklayout
                           +----gtklist
                           +----gtkmenushell
                           +----gtknotebook

                           +----gtksocket
                           +----gtktable
                           +----gtktextview
                           +----gtktoolbar
                           +----gtktree

                           +----gtktreeview

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

gtkcontainer реализует atkimplementoriface.

свойства

  "border-width"         guint                 : read / write
  "child"                gtkwidget             : write
  "resize-mode"          gtkresizemode         : read / write

сигналы

"add"       void        user_function      (gtkcontainer *container,
                                            gtkwidget    *widget,
                                            gpointer      user_data)      : run first
"check-resize"
            void        user_function      (gtkcontainer *container,
                                            gpointer      user_data)      : run last
"remove"    void        user_function      (gtkcontainer *container,
                                            gtkwidget    *widget,
                                            gpointer      user_data)      : run first
"set-focus-child"
            void        user_function      (gtkcontainer *container,
                                            gtkwidget    *widget,
                                            gpointer      user_data)      : run first

описание

пользовательский интерфейс gtk+ конструируется методом вложения одних виджетов в другие. контейнерные виджеты являются внутренними узлами в получающемся дереве виджетов: они содержат другие виджеты. таким образом, например, вы можете иметь gtkwindow содержащий gtkframe который в свою очередь содержит gtklabel. если вам нужно изображение внутри текстового ярлыка находящегося в рамке, вы можете переразместить виджет gtklabel с виджетом gtkimage.

есть два основных вида контейнерных виджетов в gtk+. оба являются подклассами абстрактного базового класса gtkcontainer.

первый тип контейнерного виджета имеет единственный дочерний виджет и происходит от gtkbin. эти контейнеры являются декораторами, которые добавляют некоторый вид функциональности к дочерним виджетам. например, gtkbutton создаёт свой дочерний виджет внутри нажимаемой кнопки; gtkframe отображает рамку вокруг своего дочернего виджета, а gtkwindow размещает свой дочерний виджет внутри окна верхнего уровня.

второй тип контейнеров может иметь больше одного дочернего виджета; его цель заключается в управлении размещением. это означает что эти контейнеры определяют размер и позицию своих дочерних виджетов. например, gtkhbox выравнивает свои дочерние виджеты в горизонтальную строку, а gtktable распределяет своё содержимое в двух мерной сетке.

для выполнения своей задачи, контейнер размещения должен согласовать запрашиваемый размер со своим родителем и дочерними виджетами. это согласование выполняется в две фазы, запрос размера (size requisition) и распределение размера (size allocation).

запрос размера

запрос размера виджета это желаемая высота и ширина. это представляется объектом gtkrequisition.

желаемый размер виджета как правило зависит от его дочерних виджетов. gtklabel, например, запрашивает пространство достаточное для отображения всего текста который он представляет.

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

распределение размера

когда виджет верхнего уровня определил сколько пространства нужно для дочерних виджетов, начинается вторая фаза согласования – распределение размера. в зависимости от конфигурации (смотрите gtk_window_set_resizable()), виджет верхнего уровня может расшириться для удовлетворения запрашиваемого размера, или может проигнорировать запрашиваемый, сохраняя фиксированный размер. тогда он говорит своему дочернему виджету какое пространство он получит с помощью gtk_widget_size_allocate(). дочерний виджет распределяет полученное пространство между своими дочерними виджетами и т.д.. при нормальных обстоятельствах, gtkwindow всегда выдаёт дочерним виджетам запрашиваемое ими пространство.

распределение дочерних размеров представляется объектом gtkallocation. эта структура содержит не только ширину и высоту, но также позицию (то есть x и y координаты), поэтому контейнер может сообщить своим дочерним виджетам не только какое пространство они должны занимать, но и где расположиться внутри контейнера.

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

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

gtkcontainer представляет дочерние свойства – это свойства объекта которые определены не для контейнера и его дочерних виджетов, а скорее для их связки. типичный пример дочерних свойств – позиция или тип упаковки виджета который находится в gtkbox.

используйте gtk_container_class_install_child_property() для установки дочерних свойств контейнерного класса, а gtk_container_class_find_child_property() или gtk_container_class_list_child_properties() для получения информации о существующих дочерних свойствах.

для установки значения дочернего свойства, используйте gtk_container_child_set_property(), gtk_container_child_set() или gtk_container_child_set_valist(). для определения значения дочернего свойства используйте gtk_container_child_get_property(), gtk_container_child_get() или gtk_container_child_get_valist(). для издания уведомления об изменении дочернего свойства используйте gtk_widget_child_notify().

детали

gtkcontainer

typedef struct _gtkcontainer gtkcontainer;

gtk_is_resize_container()

#define gtk_is_resize_container(widget) (gtk_is_container (widget) && ((gtkcontainer*) (widget))->resize_mode != gtk_resize_parent)

widget :

gtk_container_warn_invalid_child_property_id()

#define     gtk_container_warn_invalid_child_property_id(object, property_id, pspec)

`object` :
`property_id` :
`pspec` :

gtk_container_border_width

#define gtk_container_border_width              gtk_container_set_border_width

внимание

gtk_container_border_width устарела и не должна использоваться во вновь создаваемом коде. вместо неё используйте gtk_container_set_border_width().

тоже самое что gtk_container_set_border_width().

gtk_container_add ()

void        gtk_container_add               (gtkcontainer *container,
                                             gtkwidget *widget);

добавляет widget в container. обычно используется для простых контейнеров, таких как gtkwindow, gtkframe, или gtkbutton; для более сложных контейнеров таких как gtkbox или gtktable, эта функция выберет параметры по умолчанию, которые могут быть некорректны. поэтому рассмотрите для этих случаев функции gtk_box_pack_start() и gtk_table_attach() как альтернативу gtk_container_add(). одновременно виджет может быть добавлен только к одному контейнеру; вы можете разместить некоторые виджеты внутри двух разных контейнеров.

`container` :	gtkcontainer
`widget` :	виджет помещаемый в `container`

gtk_container_remove ()

void        gtk_container_remove            (gtkcontainer *container,
                                             gtkwidget *widget);

удаляет виджет widget из container. widget должен находиться внутри container. помните что container владеет ссылкой на widget, и то что это может быть последняя ссылка; поэтому удаление виджета из контейнера может уничтожить этот виджет. если вам нужно использовать widget снова, вы должны добавить на него ссылку пока он не в контейнере, используя g_object_ref(). если вы больше не хотите использовать widget наиболее эффективным будет простое уничтожение с непосредственным использованием gtk_widget_destroy(), так как это удалит его из контейнера и поможет прекратить любые циклические ссылки.

`container` :	gtkcontainer
`widget` :	текущий дочерний виджет для `container`

gtk_container_add_with_properties ()

void        gtk_container_add_with_properties
                                            (gtkcontainer *container,
                                             gtkwidget *widget,
                                             const gchar *first_prop_name,
                                             ...);

добавляет widget в container, одновременно устанавливая дочерние свойства. смотрите gtk_container_add() и gtk_container_child_set() для подробного изучения.

`container` :	gtkcontainer
`widget` :	виджет помещаемый в `container`
`first_prop_name` :	имя первого дочернего свойства для установки
`...` :	`null`-завершённый список имен и значений свойств, начиная с `first_prop_name`.

gtk_container_get_resize_mode ()

gtkresizemode gtk_container_get_resize_mode (gtkcontainer *container);

определяет режим изменения размера контейнера. смотрите gtk_container_set_resize_mode().

`container` :	gtkcontainer
возвращает :	текущий режим изменения размера

gtk_container_set_resize_mode ()

void        gtk_container_set_resize_mode   (gtkcontainer *container,
                                             gtkresizemode resize_mode);

устанавливает режим изменения размера.

режим изменения размера контейнера определяет, будет ли помещённый в родитель контейнера запрос на изменение размера поставлен в очередь, для более позднего выполнения, или выполнен немедленно.

`container` :	gtkcontainer.
`resize_mode` :	новый режим изменения размера.

gtk_container_check_resize ()

void        gtk_container_check_resize      (gtkcontainer *container);

container :

gtk_container_foreach ()

void        gtk_container_foreach           (gtkcontainer *container,
                                             gtkcallback callback,
                                             gpointer callback_data);

вызывает callback на каждом не внутреннем дочернем виджете контейнера container. смотрите gtk_container_forall() для деталей относительно того, что составляет "внутренние" дочерние виджеты. большинство приложений должны использовать gtk_container_foreach(), а не gtk_container_forall().

`container` :	gtkcontainer
`callback` :	callback-функция
`callback_data` :	данные используемые callback-функцией

gtk_container_foreach_full ()

void        gtk_container_foreach_full      (gtkcontainer *container,
                                             gtkcallback callback,
                                             gtkcallbackmarshal marshal,
                                             gpointer callback_data,
                                             gtkdestroynotify notify);

внимание

gtk_container_foreach_full устарела и не должна использоваться во вновь создаваемом коде. вместо неё используйте gtk_container_foreach().

`container` :
`callback` :
`marshal` :
`callback_data` :
`notify` :

gtk_container_children

#define gtk_container_children gtk_container_get_children

внимание

gtk_container_children устарела и не должна использоваться во вновь создаваемом коде. вместо неё используйте gtk_container_get_children().

тоже самое что gtk_container_get_children().

gtk_container_get_children ()

glist*      gtk_container_get_children      (gtkcontainer *container);

определяет не внутренние дочерние виджеты контейнера. смотрите gtk_container_forall() для деталей относительно того, что составляет "внутренние" дочерние виджеты.

`container` :	gtkcontainer.
возвращает :	вновь созданный список не внутренних дочерних виджетов контейнера.

gtk_container_set_reallocate_redraws ()

void        gtk_container_set_reallocate_redraws
                                            (gtkcontainer *container,
                                             gboolean needs_redraws);

устанавливает reallocate_redraws флажок контейнера в полученное значение.

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

`container` :	gtkcontainer.
`needs_redraws` :	новое значение флажка `reallocate_redraws`.

gtk_container_set_focus_child ()

void        gtk_container_set_focus_child   (gtkcontainer *container,
                                             gtkwidget *child);

`container` :
`child` :

gtk_container_get_focus_vadjustment ()

gtkadjustment* gtk_container_get_focus_vadjustment
                                            (gtkcontainer *container);

определяет вертикальную регулировку фокуса для контейнера. смотрите gtk_container_set_focus_vadjustment().

`container` :	gtkcontainer
возвращает :	вертикальная регулировка, или `null` если не установлена.

gtk_container_set_focus_vadjustment ()

void        gtk_container_set_focus_vadjustment
                                            (gtkcontainer *container,
                                             gtkadjustment *adjustment);

устанавливает регулятор для обработки фокуса в контейнере, таким образом когда дочерний виджет контейнера находится в фокусе, регулятор прокручивается для отображения этого виджета. эта функция устанавливает вертикальное выравнивание. смотрите gtk_scrolled_window_get_vadjustment() для обычного способа определения регулировки и gtk_container_set_focus_hadjustment() для установки горизонтальной регулировки.

регулировки должны быть в пикселах и в той же самой координатной системе в которой распределены непосредственно дочерние виджеты контейнера.

`container` :	gtkcontainer
`adjustment` :	регулировки которые должны быть откорректированы при перемещении фокуса между дочерними виджетами `container`

gtk_container_get_focus_hadjustment ()

gtkadjustment* gtk_container_get_focus_hadjustment
                                            (gtkcontainer *container);

определяет горизонтальную регулировку для контейнера. смотрите gtk_container_set_focus_hadjustment().

`container` :	gtkcontainer
возвращает :	горизонтальная регулировка фокуса, или `null` если не установлена.

gtk_container_set_focus_hadjustment ()

void        gtk_container_set_focus_hadjustment
                                            (gtkcontainer *container,
                                             gtkadjustment *adjustment);

устанавливает регулятор для обработки фокуса в контейнере, таким образом когда дочерний виджет контейнера находится в фокусе, регулятор прокручивается для отображения этого виджета. эта функция устанавливает вертикальное выравнивание. смотрите gtk_scrolled_window_get_hadjustment() для обычного способа определения регулировки и gtk_container_set_focus_vadjustment() для установки горизонтальной регулировки.

`container` :	gtkcontainer
`adjustment` :	регулировки которые должны быть откорректированы при перемещении фокуса между дочерними виджетами `container`

gtk_container_resize_children ()

void        gtk_container_resize_children   (gtkcontainer *container);

container :

gtk_container_child_type ()

gtype       gtk_container_child_type        (gtkcontainer *container);

возвращает тип дочерних виджетов поддерживаемых контейнером.

помните, она может вернуть g_type_none указывающий что нельзя больше добавить дочерние виджеты, например для gtkpaned который уже имеет два дочерних виджета.

`container` :	gtkcontainer.
возвращает :	gtype.

gtk_container_child_get ()

void        gtk_container_child_get         (gtkcontainer *container,
                                             gtkwidget *child,
                                             const gchar *first_prop_name,
                                             ...);

определяет значение одного или более дочерних свойств для child и container.

`container` :	gtkcontainer
`child` :	дочерний виджет для `container`
`first_prop_name` :	имя первого свойства для определения
`...` :	`null`-завершённый список имен свойств и gvalue, начиная с `first_prop_name`*.

gtk_container_child_set ()

void        gtk_container_child_set         (gtkcontainer *container,
                                             gtkwidget *child,
                                             const gchar *first_prop_name,
                                             ...);

устанавливает одно или больше дочерних свойств для child и container.

`container` :	gtkcontainer
`child` :	дочерний виджет для `container`
`first_prop_name` :	имя первого свойства для установки
`...` :	`null`-завершённый список имен свойств и значений, начиная с `first_prop_name`.

gtk_container_child_get_property ()

void        gtk_container_child_get_property
                                            (gtkcontainer *container,
                                             gtkwidget *child,
                                             const gchar *property_name,
                                             gvalue *value);

определяет значение дочернего свойства для child и container.

`container` :	gtkcontainer
`child` :	дочерний виджет для `container`
`property_name` :	имя определяемого свойства
`value` :	определяемое значение

gtk_container_child_set_property ()

void        gtk_container_child_set_property
                                            (gtkcontainer *container,
                                             gtkwidget *child,
                                             const gchar *property_name,
                                             const gvalue *value);

устанавливает дочернее свойство для child и container.

`container` :	gtkcontainer
`child` :	дочерний виджет для `container`
`property_name` :	имя устанавливаемого свойства
`value` :	значение устанавливаемого свойства

gtk_container_child_get_valist ()

void        gtk_container_child_get_valist  (gtkcontainer *container,
                                             gtkwidget *child,
                                             const gchar *first_property_name,
                                             va_list var_args);

определяет значения одного или более дочерних свойств для child и container.

`container` :	gtkcontainer
`child` :	дочерний виджет для `container`
`first_property_name` :	имя первого определяемого свойства
`var_args` :	`null`-завершённый список имен свойств и gvalue, начиная с `first_prop_name`*.

gtk_container_child_set_valist ()

void        gtk_container_child_set_valist  (gtkcontainer *container,
                                             gtkwidget *child,
                                             const gchar *first_property_name,
                                             va_list var_args);

устанавливает одно или более дочерние свойства для child и container.

`container` :	gtkcontainer
`child` :	дочерний виджет для `container`
`first_property_name` :	имя первого устанавливаемого свойства
`var_args` :	`null`-завершённый список имен свойств и значений, начиная с `first_prop_name`.

gtk_container_forall ()

void        gtk_container_forall            (gtkcontainer *container,
                                             gtkcallback callback,
                                             gpointer callback_data);

вызывает callback на каждом дочернем виджете контейнера container, включая дочерние виджеты которые считаются внутренними "internal" (реализуют детали контейнера). "внутренние" дочерние виджеты обычно не добавляются пользователем контейнера, а добавляются непосредственно при реализации контейнера. большинство приложений должны использовать gtk_container_foreach(), а не gtk_container_forall().

`container` :	gtkcontainer
`callback` :	callback-функция
`callback_data` :	данные используемые callback-функцией

gtk_container_get_border_width ()

guint       gtk_container_get_border_width  (gtkcontainer *container);

определяет ширину окантовки контейнера. смотрите gtk_container_set_border_width().

`container` :	gtkcontainer
возвращает :	текущая ширина окантовки

gtk_container_set_border_width ()

void        gtk_container_set_border_width  (gtkcontainer *container,
                                             guint border_width);

устанавливает ширину окантовки контейнера.

ширина окантовки это количество пространства находящегося снаружи контейнера. единственное исключение – это gtkwindow; потому что окно верхнего уровня не может иметь внешнего пространства, оно предоставляет внутреннее пространство. окантовка добавляется со всех сторон контейнера. для добавления только с одной стороны, один из способов состоит в том чтобы создать виджет gtkalignment, вызвав gtk_widget_set_usize() для получения его размера, и поместить его со стороны контейнера как интервал.

`container` :	gtkcontainer
`border_width` :	количество свободного пространства с внешних сторон контейнера. допустимыми значениями является диапазон от 0 до 65535 пикселей.

gtk_container_propagate_expose ()

void        gtk_container_propagate_expose  (gtkcontainer *container,
                                             gtkwidget *child,
                                             gdkeventexpose *event);

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

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

в большинстве случаев, контейнер может просто унаследовать реализацию ::expose из gtkcontainer, или, выполнить некоторое отображение, а затем реализовать цепочку ::expose из gtkcontainer.

`container` :	gtkcontainer
`child` :	дочерний виджет контейнера `container`
`event` :	экспонирующее событие отправляемое контейнеру

gtk_container_get_focus_chain ()

gboolean    gtk_container_get_focus_chain   (gtkcontainer *container,
                                             glist **focusable_widgets);

определяет сфокусированную цепочку контейнера, если была установлена явно. если нет явно установленной, сфокусированной цепочки, gtk+ рассчитает сфокусированную цепочку основываясь на позиции дочерних виджетов. в этом случае, gtk+ сохраняет null в параметре focusable_widgets и возвращает false.

`container` :	gtkcontainer
`focusable_widgets` :	сфокусированная цепочка контейнера, или `null`. вы должны освободить этот список используя `g_list_free()` после выполнения этой функции, но не дополнительные ссылки для индивидуальных виджетов в сфокусированной цепочке.
возвращает :	`true` если сфокусированная цепочка контейнера была установлена явно.

gtk_container_set_focus_chain ()

void        gtk_container_set_focus_chain   (gtkcontainer *container,
                                             glist *focusable_widgets);

устанавливает сфокусированную цепочку, переписывая рассчитанную автоматически gtk+.

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

`container` :	gtkcontainer.
`focusable_widgets` :	новая сфокусированная цепочка.

gtk_container_unset_focus_chain ()

void        gtk_container_unset_focus_chain (gtkcontainer *container);

удаляет сфокусированную цепочку явно установленную с помощью gtk_container_set_focus_chain().

container :

gtkcontainer.

gtk_container_class_find_child_property ()

gparamspec* gtk_container_class_find_child_property
                                            (gobjectclass *cclass,
                                             const gchar *property_name);

находит дочернее свойство контейнерного класса по имени.

`cclass` :	gtkcontainerclass
`property_name` :	имя дочернего свойства для поиска
возвращает :	gparamspec дочернего свойства или `null` если `class` не имеет дочернего свойства с таким именем.

gtk_container_class_install_child_property ()

void        gtk_container_class_install_child_property
                                            (gtkcontainerclass *cclass,
                                             guint property_id,
                                             gparamspec *pspec);

устанавливает дочернее свойство в контейнерный класс.

`cclass` :	gtkcontainerclass
`property_id` :	id для свойства
`pspec` :	gparamspec для свойства

gtk_container_class_list_child_properties ()

gparamspec** gtk_container_class_list_child_properties
                                            (gobjectclass *cclass,
                                             guint *n_properties);

определяет все дочерние свойства контейнерного класса.

`cclass` :	gtkcontainerclass
`n_properties` :	количество найденных дочерних свойств
возвращает :	массив gparamspec*. массив должен освобождаться с помощью `g_free()`.

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

свойство "`border-width`"

  "border-width"         guint                 : read / write

ширина промежутка с внешней стороны контейнера.

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

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

свойство "`child`"

  "child"                gtkwidget             : write

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

свойство "`resize-mode`"

  "resize-mode"          gtkresizemode         : read / write

определяет как обрабатывать событие изменения размера.

значение по умолчанию: gtk_resize_parent

детали сигналов

сигнал "add"

void        user_function                  (gtkcontainer *container,
                                            gtkwidget    *widget,
                                            gpointer      user_data)      : run first

`container` :	объект получающий сигнал.
`widget` :
`user_data` :	данные устанавливаемые при подключении обработчика сигнала.

сигнал "check-resize"

void        user_function                  (gtkcontainer *container,
                                            gpointer      user_data)      : run last

`container` :	объект получающий сигнал.
`user_data` :	данные устанавливаемые при подключении обработчика сигнала.

сигнал "remove"

void        user_function                  (gtkcontainer *container,
                                            gtkwidget    *widget,
                                            gpointer      user_data)      : run first

`container` :	объект получающий сигнал.
`widget` :
`user_data` :	данные устанавливаемые при подключении обработчика сигнала.

сигнал "set-focus-child"

void        user_function                  (gtkcontainer *container,
                                            gtkwidget    *widget,
                                            gpointer      user_data)      : run first

`container` :	объект получающий сигнал.
`widget` :
`user_data` :	данные устанавливаемые при подключении обработчика сигнала.

gtkcontainer

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

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

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

свойства

сигналы

описание

запрос размера

распределение размера

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

детали

gtkcontainer

gtk_is_resize_container()

gtk_container_warn_invalid_child_property_id()

gtk_container_border_width

внимание

gtk_container_add ()

gtk_container_remove ()

gtk_container_add_with_properties ()

gtk_container_get_resize_mode ()

gtk_container_set_resize_mode ()

gtk_container_check_resize ()

gtk_container_foreach ()

gtk_container_foreach_full ()

внимание

gtk_container_children

внимание

gtk_container_get_children ()

gtk_container_set_reallocate_redraws ()

gtk_container_set_focus_child ()

gtk_container_get_focus_vadjustment ()

gtk_container_set_focus_vadjustment ()

gtk_container_get_focus_hadjustment ()

gtk_container_set_focus_hadjustment ()

gtk_container_resize_children ()

gtk_container_child_type ()

gtk_container_child_get ()

gtk_container_child_set ()

gtk_container_child_get_property ()

gtk_container_child_set_property ()

gtk_container_child_get_valist ()

gtk_container_child_set_valist ()

gtk_container_forall ()

gtk_container_get_border_width ()

gtk_container_set_border_width ()

gtk_container_propagate_expose ()

gtk_container_get_focus_chain ()

gtk_container_set_focus_chain ()

gtk_container_unset_focus_chain ()

gtk_container_class_find_child_property ()

gtk_container_class_install_child_property ()

gtk_container_class_list_child_properties ()

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

свойство "border-width"

свойство "child"

свойство "resize-mode"

детали сигналов

сигнал "add"

сигнал "check-resize"

сигнал "remove"

сигнал "set-focus-child"

свойство "`border-width`"

свойство "`child`"

свойство "`resize-mode`"