GtkEventBox

gtk_event_box_new ()

GtkWidget *
gtk_event_box_new (void);

Создает новый GtkEventBox.

gtk_event_box_set_above_child ()

void
gtk_event_box_set_above_child (GtkEventBox *event_box,
                               gboolean above_child);

Устанавливает, размещается ли окно event box над окнами его дочернего элемента, а не под ним. Если окно находится сверху, все события внутри event box попадают в event box. Если окно находится снизу, события в окнах дочерних виджетов сначала попадают в этот виджет, а затем в его родительские элементы.

По умолчанию окно остается под дочерним элементом.

С: 2.4

gtk_event_box_get_above_child ()

gboolean
gtk_event_box_get_above_child (GtkEventBox *event_box);

Возвращает, находится ли окно event box над или под окнами его дочернего элемента. См. gtk_event_box_set_above_child() для получения подробностей.

С: 2.4

gtk_event_box_set_visible_window ()

void
gtk_event_box_set_visible_window (GtkEventBox *event_box,
                                  gboolean visible_window);

Устанавливает, использует ли event box видимое или невидимое окно дочернего элемента. По умолчанию используются видимые окна.

В event box с невидимым окном окно, создаваемое event box, является окном GDK_INPUT_ONLY, что означает, что оно невидимо и служит только для приема событий.

Event box с видимым окном создает видимое (GDK_INPUT_OUTPUT) окно, которое действует как родительское окно для всех виджетов, содержащихся в event box.

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

Основная причина создания event box без входных данных — возможность установить другой цвет фона или рисовать на нем.

Есть одна неожиданная проблема для невидимого event box, у которого окно находится ниже дочернего элемента. (См. gtk_event_box_set_above_child().) Поскольку окно только для ввода не является предковым окном для каких-либо окон, создаваемых дочерними виджетами event box, события в этих окнах не распространяются вверх системой окон, а только GTK+. Практический эффект состоит в том, что если событие не находится в маске событий для дочернего окна (см. gtk_widget_add_events()), оно не будет получено event box.

Эта проблема не возникает для видимых event box, поскольку в этом случае окно event box фактически является предком дочерних окон, а не просто находится в том же месте на экране.

С: 2.4

gtk_event_box_get_visible_window ()

gboolean
gtk_event_box_get_visible_window (GtkEventBox *event_box);

Возвращает, имеет ли event box видимое окно. См. gtk_event_box_set_visible_window() для получения подробностей.

С: 2.4

struct GtkEventBox

struct GtkEventBox;

struct GtkEventBoxClass

struct GtkEventBoxClass {
  GtkBinClass parent_class;
};

Свойство “above-child”

  “above-child”              gboolean

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

Владелец: GtkEventBox

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

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

Свойство “visible-window”

  “visible-window”           gboolean

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

Владелец: GtkEventBox

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

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