GtkOverlay

GtkOverlay как GtkBuildable

Реализация GtkOverlay интерфейса GtkBuildable поддерживает размещение дочернего элемента в качестве наложения путем указания «overlay» в качестве атрибута «type» элемента <child>.

Узлы CSS

GtkOverlay имеет один узел CSS с именем «overlay». Наложенные дочерние элементы, чье выравнивание приводит к размещению их на краю, получают классы стилей «.left», «.right», «.top» и/или «.bottom» в зависимости от их позиции.

gtk_overlay_new ()

GtkWidget *
gtk_overlay_new (void);

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

gtk_overlay_set_child ()

void
gtk_overlay_set_child (GtkOverlay *overlay,
                       GtkWidget *child);

Устанавливает дочерний виджет для overlay .

gtk_overlay_get_child ()

GtkWidget *
gtk_overlay_get_child (GtkOverlay *overlay);

Получает дочерний виджет для overlay .

gtk_overlay_add_overlay ()

void
gtk_overlay_add_overlay (GtkOverlay *overlay,
                         GtkWidget *widget);

Добавляет widget к overlay .

Виджет будет размещён поверх основного виджета, добавленного с помощью gtk_overlay_set_child().

Положение widget определяется его свойствами “halign” и “valign”.

gtk_overlay_remove_overlay ()

void
gtk_overlay_remove_overlay (GtkOverlay *overlay,
                            GtkWidget *widget);

Удаляет наложение, добавленное с помощью gtk_overlay_add_overlay().

gtk_overlay_get_measure_overlay ()

gboolean
gtk_overlay_get_measure_overlay (GtkOverlay *overlay,
                                 GtkWidget *widget);

Получает, включён ли размер widget в вычисление размера overlay .

gtk_overlay_set_measure_overlay ()

void
gtk_overlay_set_measure_overlay (GtkOverlay *overlay,
                                 GtkWidget *widget,
                                 gboolean measure);

Устанавливает, включён ли widget в вычисление размера overlay .

Наложение запросит размер самого большого дочернего виджета, для которого это свойство установлено в TRUE. Виджеты, которые не включены, могут быть нарисованы вне области overlay, если они слишком велики.

gtk_overlay_get_clip_overlay ()

gboolean
gtk_overlay_get_clip_overlay (GtkOverlay *overlay,
                              GtkWidget *widget);

Получает, должен ли widget быть обрезано в родительском элементе.

gtk_overlay_set_clip_overlay ()

void
gtk_overlay_set_clip_overlay (GtkOverlay *overlay,
                              GtkWidget *widget,
                              gboolean clip_overlay);

Устанавливает, должен ли widget быть обрезано в родительском элементе.

GtkOverlay

typedef struct _GtkOverlay GtkOverlay;

Свойство “child”

  “child”                    GtkWidget *

Дочерний виджет.

Владелец: GtkOverlay

Флаги: Чтение/Запись

Сигнал “get-child-position”

gboolean
user_function (GtkOverlay   *overlay,
               GtkWidget    *widget,
               GdkRectangle *allocation,
               gpointer      user_data)

Сигнал ::get-child-position вызывается для определения позиции и размера дочерних виджетов наложения. Обработчик этого сигнала должен заполнить allocation желаемой позицией и размером для widget , относительно основного дочернего виджета overlay .

По умолчанию обработчик этого сигнала использует свойства widget halign и valign для определения позиции и задаёт виджету его естественный размер (за исключением того, что выравнивание GTK_ALIGN_FILL приведет к тому, что наложение заполнит всю ширину/высоту). Если основной дочерний виджет является GtkScrolledWindow, наложения размещаются относительно его содержимого.

Флаги: Выполняется последним