gdk-events.html

最新gtk中文资料集

<td><p><span class="term"><a name="GDK-ENTER-NOTIFY:CAPS"></a><code class="literal">GDK_ENTER_NOTIFY</code></span></p></td>
<td>the pointer has entered the window.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-LEAVE-NOTIFY:CAPS"></a><code class="literal">GDK_LEAVE_NOTIFY</code></span></p></td>
<td>the pointer has left the window.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-FOCUS-CHANGE:CAPS"></a><code class="literal">GDK_FOCUS_CHANGE</code></span></p></td>
<td>the keyboard focus has entered or left the window.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-CONFIGURE:CAPS"></a><code class="literal">GDK_CONFIGURE</code></span></p></td>
<td>the size, position or stacking order of the window has changed.
Note that GTK+ discards these events for <a class="link" href="gdk-Windows.html#GDK-WINDOW-CHILD:CAPS"><code class="literal">GDK_WINDOW_CHILD</code></a> windows.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-MAP:CAPS"></a><code class="literal">GDK_MAP</code></span></p></td>
<td>the window has been mapped.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-UNMAP:CAPS"></a><code class="literal">GDK_UNMAP</code></span></p></td>
<td>the window has been unmapped.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-PROPERTY-NOTIFY:CAPS"></a><code class="literal">GDK_PROPERTY_NOTIFY</code></span></p></td>
<td>a property on the window has been changed or deleted.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-SELECTION-CLEAR:CAPS"></a><code class="literal">GDK_SELECTION_CLEAR</code></span></p></td>
<td>the application has lost ownership of a selection.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-SELECTION-REQUEST:CAPS"></a><code class="literal">GDK_SELECTION_REQUEST</code></span></p></td>
<td>another application has requested a selection.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-SELECTION-NOTIFY:CAPS"></a><code class="literal">GDK_SELECTION_NOTIFY</code></span></p></td>
<td>a selection has been received.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-PROXIMITY-IN:CAPS"></a><code class="literal">GDK_PROXIMITY_IN</code></span></p></td>
<td>an input device has moved into contact with a sensing
surface (e.g. a touchscreen or graphics tablet).
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-PROXIMITY-OUT:CAPS"></a><code class="literal">GDK_PROXIMITY_OUT</code></span></p></td>
<td>an input device has moved out of contact with a sensing
surface.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-DRAG-ENTER:CAPS"></a><code class="literal">GDK_DRAG_ENTER</code></span></p></td>
<td>the mouse has entered the window while a drag is in progress.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-DRAG-LEAVE:CAPS"></a><code class="literal">GDK_DRAG_LEAVE</code></span></p></td>
<td>the mouse has left the window while a drag is in progress.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-DRAG-MOTION:CAPS"></a><code class="literal">GDK_DRAG_MOTION</code></span></p></td>
<td>the mouse has moved in the window while a drag is in
progress.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-DRAG-STATUS:CAPS"></a><code class="literal">GDK_DRAG_STATUS</code></span></p></td>
<td>the status of the drag operation initiated by the window
has changed.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-DROP-START:CAPS"></a><code class="literal">GDK_DROP_START</code></span></p></td>
<td>a drop operation onto the window has started.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-DROP-FINISHED:CAPS"></a><code class="literal">GDK_DROP_FINISHED</code></span></p></td>
<td>the drop operation initiated by the window has completed.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-CLIENT-EVENT:CAPS"></a><code class="literal">GDK_CLIENT_EVENT</code></span></p></td>
<td>a message has been received from another application.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-VISIBILITY-NOTIFY:CAPS"></a><code class="literal">GDK_VISIBILITY_NOTIFY</code></span></p></td>
<td>the window visibility status has changed.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-NO-EXPOSE:CAPS"></a><code class="literal">GDK_NO_EXPOSE</code></span></p></td>
<td>indicates that the source region was completely available
when parts of a drawable were copied. This is not very useful.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-SCROLL:CAPS"></a><code class="literal">GDK_SCROLL</code></span></p></td>
<td>the scroll wheel was turned
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-WINDOW-STATE:CAPS"></a><code class="literal">GDK_WINDOW_STATE</code></span></p></td>
<td>the state of a window has changed. See <a class="link" href="gdk-Event-Structures.html#GdkWindowState"><span class="type">GdkWindowState</span></a>
for the possible window states
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-SETTING:CAPS"></a><code class="literal">GDK_SETTING</code></span></p></td>
<td>a setting has been modified.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-OWNER-CHANGE:CAPS"></a><code class="literal">GDK_OWNER_CHANGE</code></span></p></td>
<td>the owner of a selection has changed. This event type
  was added in 2.6
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-GRAB-BROKEN:CAPS"></a><code class="literal">GDK_GRAB_BROKEN</code></span></p></td>
<td>a pointer or keyboard grab was broken. This event type
  was added in 2.8.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3229172"></a><h3>
<a name="GdkEventMask"></a>enum GdkEventMask</h3>
<a class="indexterm" name="id3229185"></a><pre class="programlisting">typedef enum
{
  GDK_EXPOSURE_MASK		= 1 &lt;&lt; 1,
  GDK_POINTER_MOTION_MASK	= 1 &lt;&lt; 2,
  GDK_POINTER_MOTION_HINT_MASK	= 1 &lt;&lt; 3,
  GDK_BUTTON_MOTION_MASK	= 1 &lt;&lt; 4,
  GDK_BUTTON1_MOTION_MASK	= 1 &lt;&lt; 5,
  GDK_BUTTON2_MOTION_MASK	= 1 &lt;&lt; 6,
  GDK_BUTTON3_MOTION_MASK	= 1 &lt;&lt; 7,
  GDK_BUTTON_PRESS_MASK		= 1 &lt;&lt; 8,
  GDK_BUTTON_RELEASE_MASK	= 1 &lt;&lt; 9,
  GDK_KEY_PRESS_MASK		= 1 &lt;&lt; 10,
  GDK_KEY_RELEASE_MASK		= 1 &lt;&lt; 11,
  GDK_ENTER_NOTIFY_MASK		= 1 &lt;&lt; 12,
  GDK_LEAVE_NOTIFY_MASK		= 1 &lt;&lt; 13,
  GDK_FOCUS_CHANGE_MASK		= 1 &lt;&lt; 14,
  GDK_STRUCTURE_MASK		= 1 &lt;&lt; 15,
  GDK_PROPERTY_CHANGE_MASK	= 1 &lt;&lt; 16,
  GDK_VISIBILITY_NOTIFY_MASK	= 1 &lt;&lt; 17,
  GDK_PROXIMITY_IN_MASK		= 1 &lt;&lt; 18,
  GDK_PROXIMITY_OUT_MASK	= 1 &lt;&lt; 19,
  GDK_SUBSTRUCTURE_MASK		= 1 &lt;&lt; 20,
  GDK_SCROLL_MASK               = 1 &lt;&lt; 21,
  GDK_ALL_EVENTS_MASK		= 0x3FFFFE
} GdkEventMask;
</pre>
<p>
A set of bit-flags to indicate which events a window is to receive.
Most of these masks map onto one or more of the <a class="link" href="gdk-Events.html#GdkEventType"><span class="type">GdkEventType</span></a> event types
above.
</p>
<p>
<a class="link" href="gdk-Events.html#GDK-POINTER-MOTION-HINT-MASK:CAPS"><code class="literal">GDK_POINTER_MOTION_HINT_MASK</code></a> is a special mask which is used to reduce the
number of <a class="link" href="gdk-Events.html#GDK-MOTION-NOTIFY:CAPS"><code class="literal">GDK_MOTION_NOTIFY</code></a> events received. Normally a <a class="link" href="gdk-Events.html#GDK-MOTION-NOTIFY:CAPS"><code class="literal">GDK_MOTION_NOTIFY</code></a>
event is received each time the mouse moves. However, if the application
spends a lot of time processing the event (updating the display, for example),
it can lag behind the position of the mouse. When using
<a class="link" href="gdk-Events.html#GDK-POINTER-MOTION-HINT-MASK:CAPS"><code class="literal">GDK_POINTER_MOTION_HINT_MASK</code></a>, fewer <a class="link" href="gdk-Events.html#GDK-MOTION-NOTIFY:CAPS"><code class="literal">GDK_MOTION_NOTIFY</code></a> events will be sent,
some of which are marked as a hint (the is_hint member is <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>).
To receive more motion events after a motion hint event, the application
needs to asks for more, by calling <a class="link" href="gdk-Events.html#gdk-event-request-motions"><code class="function">gdk_event_request_motions()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="GDK-EXPOSURE-MASK:CAPS"></a><code class="literal">GDK_EXPOSURE_MASK</code></span></p></td>
<td>receive expose events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-POINTER-MOTION-MASK:CAPS"></a><code class="literal">GDK_POINTER_MOTION_MASK</code></span></p></td>
<td>receive all pointer motion events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-POINTER-MOTION-HINT-MASK:CAPS"></a><code class="literal">GDK_POINTER_MOTION_HINT_MASK</code></span></p></td>
<td>see the explanation above
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-BUTTON-MOTION-MASK:CAPS"></a><code class="literal">GDK_BUTTON_MOTION_MASK</code></span></p></td>
<td>receive pointer motion events while any button is pressed
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-BUTTON1-MOTION-MASK:CAPS"></a><code class="literal">GDK_BUTTON1_MOTION_MASK</code></span></p></td>
<td>receive pointer motion events while 1 button is pressed
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-BUTTON2-MOTION-MASK:CAPS"></a><code class="literal">GDK_BUTTON2_MOTION_MASK</code></span></p></td>
<td>receive pointer motion events while 2 button is pressed
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-BUTTON3-MOTION-MASK:CAPS"></a><code class="literal">GDK_BUTTON3_MOTION_MASK</code></span></p></td>
<td>receive pointer motion events while 3 button is pressed
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-BUTTON-PRESS-MASK:CAPS"></a><code class="literal">GDK_BUTTON_PRESS_MASK</code></span></p></td>
<td>receive button press events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-BUTTON-RELEASE-MASK:CAPS"></a><code class="literal">GDK_BUTTON_RELEASE_MASK</code></span></p></td>
<td>receive button release events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-KEY-PRESS-MASK:CAPS"></a><code class="literal">GDK_KEY_PRESS_MASK</code></span></p></td>
<td>receive key press events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-KEY-RELEASE-MASK:CAPS"></a><code class="literal">GDK_KEY_RELEASE_MASK</code></span></p></td>
<td>receive key release events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-ENTER-NOTIFY-MASK:CAPS"></a><code class="literal">GDK_ENTER_NOTIFY_MASK</code></span></p></td>
<td>receive window enter events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-LEAVE-NOTIFY-MASK:CAPS"></a><code class="literal">GDK_LEAVE_NOTIFY_MASK</code></span></p></td>
<td>receive window leave events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-FOCUS-CHANGE-MASK:CAPS"></a><code class="literal">GDK_FOCUS_CHANGE_MASK</code></span></p></td>
<td>receive focus change events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-STRUCTURE-MASK:CAPS"></a><code class="literal">GDK_STRUCTURE_MASK</code></span></p></td>
<td>receive events about window configuration change
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-PROPERTY-CHANGE-MASK:CAPS"></a><code class="literal">GDK_PROPERTY_CHANGE_MASK</code></span></p></td>
<td>receive property change events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-VISIBILITY-NOTIFY-MASK:CAPS"></a><code class="literal">GDK_VISIBILITY_NOTIFY_MASK</code></span></p></td>
<td>receive visibility change events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-PROXIMITY-IN-MASK:CAPS"></a><code class="literal">GDK_PROXIMITY_IN_MASK</code></span></p></td>
<td>receive proximity in events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-PROXIMITY-OUT-MASK:CAPS"></a><code class="literal">GDK_PROXIMITY_OUT_MASK</code></span></p></td>
<td>receive proximity out events