GTK+ 2.0 教学-事件

除有前面描述的信号机制外,还有一套 events 反映 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(),像前面介绍的一样,用上面事件名之一作为 name 参数。事件的回呼函式与信号的回呼函式有一点点不同:

gint callback_func( GtkWidget *widget, GdkEvent *event,gpointer callback_data);

GdkEvent 是一个 C union结构,它的型别依赖于上述事件中的哪个事件发生了。为了让我们得知发生了哪个事件,每个可能的型别都有一个 type 成员来反映发生的事件。事件结构的其它部分将依赖于这个事件的型别。型别的可能的值有:


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 (button, "button_press_event",
                  G_CALLBACK (button_press_callback), NULL);

这里假定 button 是一个按钮元件。现在,当滑鼠位于按钮上并按一下滑鼠时,函数 button_press_callback() 会被呼叫。这个函式应该声明为:

static gboolean button_press_callback( GtkWidget      *widget,
                                       GdkEventButton *event,
                                       gpointer        data );

注意,我们可以把第二个参数型别声明为 GdkEventButton,因为我们知道哪个型别的事件会发生。

这个函式的传回值指示这个事件是否应该由 GTK 事件处理机置做进一步的传播。传回 TRUE 指示这个事件已经处理了,且不应该做进一步传播。传回 FALSE 继续正常的事件处理。详见进阶事件和信号处理这一章。

GdkEvent 资料型态详情请参见附录 GDK 事件型别

GDK 选择区和拖拉的应用程式介面也发出许多事件,在 GTK 中用信号来反映。下列信号的内容详见原始元件上的信号目的元件上的信号这两章:

  • selection_received
  • selection_get
  • drag_begin_event
  • drag_end_event
  • drag_data_delete
  • drag_motion
  • drag_drop
  • drag_data_get
  • drag_data_received

<<信号和回呼函式的原理

单元首页

Hello World 详解 >>

1 則留言


Comments are closed.