GtkSizeGroup

Функции

Свойства

Типы и значения

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

    GObject
    ╰── GtkSizeGroup

Реализованные интерфейсы

GtkSizeGroup реализует GtkBuildable.

Файлы заголовков

#include <gtk/gtk.h>

Описание

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

Подробно, размер, запрашиваемый для каждого виджета в GtkSizeGroup, является максимальным из размеров, которые были бы запрошены для каждого виджета в группе размеров, если бы они не были в группе размеров. Режим группы размеров (см. gtk_size_group_set_mode()) определяет, относится ли это к горизонтальному размеру, вертикальному размеру или обоим размерам.

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

Объекты GtkSizeGroup ссылаются на каждый виджет в группе размеров, поэтому, после добавления всех виджетов в GtkSizeGroup, вы можете отказаться от начальной ссылки на группу размеров с g_object_unref(). Если виджеты в группе размеров впоследствии будут уничтожены, они будут удалены из группы размеров и откажутся от своих ссылок на группу размеров; когда все виджеты будут удалены, группа размеров будет освобождена.

Виджеты могут входить в состав нескольких групп размеров; GTK будет вычислять горизонтальный размер виджета из горизонтального запроса всех виджетов, которые могут быть достигнуты от виджета цепочкой групп размеров типа GTK_SIZE_GROUP_HORIZONTAL или GTK_SIZE_GROUP_BOTH, а вертикальный размер — из вертикального запроса всех виджетов, которые могут быть достигнуты от виджета цепочкой групп размеров типа GTK_SIZE_GROUP_VERTICAL или GTK_SIZE_GROUP_BOTH.

Обратите внимание, что группы размеров обращаются только к неконтекстуальным размерам каждого виджета (поскольку группы размеров не знают, какого размера виджет будет выделен в одном измерении, они не могут вывести, какой высоты виджет получит при заданной ширине). При группировании виджетов, которые обменивают высоту на ширину в режиме GTK_SIZE_GROUP_VERTICAL или GTK_SIZE_GROUP_BOTH: высота для минимальной ширины будет запрашиваемой высотой для всех виджетов в группе. То же самое, конечно, верно и при горизонтальном группировании ширины для высоты виджетов.

Виджеты, которые меняют высоту на ширину, должны установить разумно большую минимальную ширину с помощью “width-chars”, например. Виджеты со статическими размерами, а также виджеты, которые растут (например, обрезание текста), не требуют таких соображений.

<object class="GtkSizeGroup">
  <property name="mode">horizontal</property>
  <widgets>
    <widget name="radio1"/>
    <widget name="radio2"/>
  </widgets>
</object>

Функции

GtkSizeGroup *
gtk_size_group_new (GtkSizeGroupMode mode);

void
gtk_size_group_set_mode (GtkSizeGroup *size_group,
                         GtkSizeGroupMode mode);

GtkSizeGroupMode
gtk_size_group_get_mode (GtkSizeGroup *size_group);

void
gtk_size_group_add_widget (GtkSizeGroup *size_group,
                           GtkWidget *widget);

void
gtk_size_group_remove_widget (GtkSizeGroup *size_group,
                              GtkWidget *widget);

GSList *
gtk_size_group_get_widgets (GtkSizeGroup *size_group);

Типы и значения

struct GtkSizeGroup;

Подробное описание свойств

  “mode”                     GtkSizeGroupMode