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 без input-only окна — возможность установить другой цвет фона или рисовать на нём.

Существует одна неожиданная проблема для невидимого event box, у которого окно расположено ниже дочернего элемента. (См. gtk_event_box_set_above_child().) Поскольку окно input-only не является родительским окном для любого окна, созданного дочерними виджетами 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, перехватывающее события, над окном дочернего виджета, или под ним.

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

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

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

  “visible-window”           gboolean

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

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

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