события

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

• event

• button_press_event

• button_release_event

• scroll_event

• motion_notify_event

• delete_event

• destroy_event

• expose_event

• key_press_event

• key_release_event

• enter_notify_event

• leave_notify_event

• configure_event

• focus_in_event

• focus_out_event

• map_event

• unmap_event

• property_notify_event

• selection_clear_event

• selection_request_event

• selection_notify_event

• proximity_in_event

• proximity_out_event

• visibility_notify_event

• client_event

• no_expose_event

• window_state_event

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

gint callback_func( gtkwidget *widget,
                    gdkevent  *event,
                    gpointer   callback_data );

gdkevent это c объединение(union) структур, тип которых зависит от выбранного события. для того чтобы понять какое событие произошло каждая из возможных альтернатив имеет свой тип, который отражает произошедшее событие. многие компоненты структуры событий зависят от типа события. возможные варианты типов событий:

  gdk_nothing
  gdk_delete
  gdk_destroy
  gdk_expose
  gdk_motion_notify
  gdk_button_press
  gdk_2button_press
  gdk_3button_press
  gdk_button_release
  gdk_key_press
  gdk_key_release
  gdk_enter_notify
  gdk_leave_notify
  gdk_focus_change
  gdk_configure
  gdk_map
  gdk_unmap
  gdk_property_notify
  gdk_selection_clear
  gdk_selection_request
  gdk_selection_notify
  gdk_proximity_in
  gdk_proximity_out
  gdk_drag_enter
  gdk_drag_leave
  gdk_drag_motion
  gdk_drag_status
  gdk_drop_start
  gdk_drop_finished
  gdk_client_event
  gdk_visibility_notify
  gdk_no_expose
  gdk_scroll
  gdk_window_state
  gdk_setting

так, для ассоциации функции обратного вызова с событием можно использовать следующее:

g_signal_connect (g_object (button), "button_press_event",
                      g_callback (button_press_callback), null);

это предполагает что кнопка(button) это кнопка виджета (button widget). когда курсор находится на кнопке и кнопка мыши нажата, то вызывается функция button_press_callback(). эта функция может быть объявлена так:

static gint button_press_callback( gtkwidget      *widget, 
                                                gdkeventbutton *event,
                                                gpointer        data );

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

значение возвращенное функцией указывает механизму обработки событий gtk о дальнейших действиях. возвращенное true указывает на прекращение дальнейшего выполнения события. возвращенное false продолжает нормальное выполнение события. для более подробной информации смотрите секцию advanced event and signal handling.

детально типы данных gdkevent, рассматриваются в gdk event types.

gdk selection и drag-and-drop apis также создают множество событий которые отражены сигналами gtk. смотрите signals on the source widget и signals on the destination widget для детального изучения функций обратного вызова сигналов:

• selection_received

• selection_get

• drag_begin_event

• drag_end_event

• drag_data_delete

• drag_motion

• drag_drop

• drag_data_get

• drag_data_received