<refentry id="gdk-Event-Structures">
<refmeta>
<refentrytitle>Event Structures</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GDK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>Event Structures</refname><refpurpose>data structures specific to each type of event.</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>
<synopsis>

#include &lt;gdk/gdk.h&gt;


union       <link linkend="GdkEvent">GdkEvent</link>;

struct      <link linkend="GdkEventAny">GdkEventAny</link>;
struct      <link linkend="GdkEventKey">GdkEventKey</link>;
struct      <link linkend="GdkEventButton">GdkEventButton</link>;
struct      <link linkend="GdkEventScroll">GdkEventScroll</link>;
struct      <link linkend="GdkEventMotion">GdkEventMotion</link>;
struct      <link linkend="GdkEventExpose">GdkEventExpose</link>;
struct      <link linkend="GdkEventVisibility">GdkEventVisibility</link>;
struct      <link linkend="GdkEventCrossing">GdkEventCrossing</link>;
struct      <link linkend="GdkEventFocus">GdkEventFocus</link>;
struct      <link linkend="GdkEventConfigure">GdkEventConfigure</link>;
struct      <link linkend="GdkEventProperty">GdkEventProperty</link>;
struct      <link linkend="GdkEventSelection">GdkEventSelection</link>;
typedef     <link linkend="GdkNativeWindow">GdkNativeWindow</link>;
struct      <link linkend="GdkEventDND">GdkEventDND</link>;
struct      <link linkend="GdkEventProximity">GdkEventProximity</link>;
struct      <link linkend="GdkEventClient">GdkEventClient</link>;
struct      <link linkend="GdkEventNoExpose">GdkEventNoExpose</link>;
struct      <link linkend="GdkEventWindowState">GdkEventWindowState</link>;
struct      <link linkend="GdkEventSetting">GdkEventSetting</link>;

enum        <link linkend="GdkScrollDirection">GdkScrollDirection</link>;
enum        <link linkend="GdkVisibilityState">GdkVisibilityState</link>;
enum        <link linkend="GdkCrossingMode">GdkCrossingMode</link>;
enum        <link linkend="GdkNotifyType">GdkNotifyType</link>;
enum        <link linkend="GdkPropertyState">GdkPropertyState</link>;
enum        <link linkend="GdkWindowState">GdkWindowState</link>;
enum        <link linkend="GdkSettingAction">GdkSettingAction</link>;


</synopsis>
</refsynopsisdiv>





<refsect1>
<title>Description</title>
<para>
The event structs contain data specific to each type of event in GDK.
</para>
<note>
<para>
A common mistake is to forget to set the event mask of a widget so that the
required events are received. See <link linkend="gtk-widget-set-events">gtk_widget_set_events</link>().
</para>
</note>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GdkEvent">union GdkEvent</title>
<programlisting>union GdkEvent
{
  GdkEventType		    type;
  GdkEventAny		    any;
  GdkEventExpose	    expose;
  GdkEventNoExpose	    no_expose;
  GdkEventVisibility	    visibility;
  GdkEventMotion	    motion;
  GdkEventButton	    button;
  GdkEventScroll            scroll;
  GdkEventKey		    key;
  GdkEventCrossing	    crossing;
  GdkEventFocus		    focus_change;
  GdkEventConfigure	    configure;
  GdkEventProperty	    property;
  GdkEventSelection	    selection;
  GdkEventProximity	    proximity;
  GdkEventClient	    client;
  GdkEventDND               dnd;
  GdkEventWindowState       window_state;
  GdkEventSetting           setting;
};
</programlisting>
<para>
The <link linkend="GdkEvent">GdkEvent</link> struct contains a union of all of the event structs,
and allows access to the data fields in a number of ways.
</para>
<para>
The event type is always the first field in all of the event structs, and
can always be accessed with the following code, no matter what type of event
it is:
<informalexample>
<programlisting>
  GdkEvent *event;  
  GdkEventType type;

  type = event->type;
</programlisting>
</informalexample>
</para>

<para>
To access other fields of the event structs, the pointer to the event can be
cast to the appropriate event struct pointer, or the union member name can be
used. For example if the event type is <literal>GDK_BUTTON_PRESS</literal> then the x coordinate
of the button press can be accessed with:
<informalexample>
<programlisting>
  GdkEvent *event;  
  gdouble x;

  x = ((GdkEventButton*)event)->x;
</programlisting>
</informalexample>
or:
<informalexample>
<programlisting>
  GdkEvent *event;  
  gdouble x;

  x = event->button.x;
</programlisting>
</informalexample>
</para></refsect2>
<refsect2>
<title><anchor id="GdkEventAny">struct GdkEventAny</title>
<programlisting>struct GdkEventAny
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
};
</programlisting>
<para>
Contains the fields which are common to all event structs.
Any event pointer can safely be cast to a pointer to a <link linkend="GdkEventAny">GdkEventAny</link> to access
these fields.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event.
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using 
<function>XSendEvent</function>).

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventKey">struct GdkEventKey</title>
<programlisting>struct GdkEventKey
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  guint32 time;
  guint state;
  guint keyval;
  gint length;
  gchar *string;
  guint16 hardware_keycode;
  guint8 group;
};
</programlisting>
<para>
Describes a key press or key release event.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_KEY_PRESS</literal> or <literal>GDK_KEY_RELEASE</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using 
<function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="guint32">guint32</link> <structfield>time</structfield></entry>
<entry>the time of the event in milliseconds.
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>state</structfield></entry>
<entry>a bit-mask representing the state of the modifier keys (e.g. Control,
Shift and Alt) and the pointer buttons. See <link linkend="GdkModifierType">GdkModifierType</link>.
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>keyval</structfield></entry>
<entry>the key that was pressed or released. See the <filename>&lt;gdk/gdkkeysym.h&gt;</filename>
header file for a complete list of GDK key codes.
</entry>
</row>
<row>
<entry><link linkend="gint">gint</link> <structfield>length</structfield></entry>
<entry>the length of <parameter>string</parameter>.
</entry>
</row>
<row>
<entry><link linkend="gchar">gchar</link> *<structfield>string</structfield></entry>
<entry>a nul-terminated multi-byte string containing the composed characters
resulting from the key press. When text is being input, in a <link linkend="GtkEntry">GtkEntry</link> for
example, it is these characters which should be added to the input buffer.
When using <link linkend="gdk-Input-Methods">Input Methods</link> to support
internationalized text input, the composed characters appear here after the
pre-editing has been completed.
</entry>
</row>
<row>
<entry><link linkend="guint16">guint16</link> <structfield>hardware_keycode</structfield></entry>
<entry>the raw code of the key that was pressed or released.
</entry>
</row>
<row>
<entry><link linkend="guint8">guint8</link> <structfield>group</structfield></entry>
<entry>the keyboard group.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventButton">struct GdkEventButton</title>
<programlisting>struct GdkEventButton
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  guint32 time;
  gdouble x;
  gdouble y;
  gdouble *axes;
  guint state;
  guint button;
  GdkDevice *device;
  gdouble x_root, y_root;
};
</programlisting>
<para>
Used for button press and button release events. The
<structfield>type</structfield> field will be one of <literal>GDK_BUTTON_PRESS</literal>,
<literal>GDK_2BUTTON_PRESS</literal>, <literal>GDK_3BUTTON_PRESS</literal>, and <literal>GDK_BUTTON_RELEASE</literal>.
</para>
<para>
Double and triple-clicks result in a sequence of events being received.
For double-clicks the order of events will be:
<orderedlist>
<listitem><para><literal>GDK_BUTTON_PRESS</literal></para></listitem>
<listitem><para><literal>GDK_BUTTON_RELEASE</literal></para></listitem>
<listitem><para><literal>GDK_BUTTON_PRESS</literal></para></listitem>
<listitem><para><literal>GDK_2BUTTON_PRESS</literal></para></listitem>
<listitem><para><literal>GDK_BUTTON_RELEASE</literal></para></listitem>
</orderedlist>
Note that the first click is received just like a normal
button press, while the second click results in a <literal>GDK_2BUTTON_PRESS</literal> being
received just after the <literal>GDK_BUTTON_PRESS</literal>.
</para>
<para>
Triple-clicks are very similar to double-clicks, except that <literal>GDK_3BUTTON_PRESS</literal>
is inserted after the third click. The order of the events is:
<orderedlist>
<listitem><para><literal>GDK_BUTTON_PRESS</literal></para></listitem>
<listitem><para><literal>GDK_BUTTON_RELEASE</literal></para></listitem>
<listitem><para><literal>GDK_BUTTON_PRESS</literal></para></listitem>
<listitem><para><literal>GDK_2BUTTON_PRESS</literal></para></listitem>
<listitem><para><literal>GDK_BUTTON_RELEASE</literal></para></listitem>
<listitem><para><literal>GDK_BUTTON_PRESS</literal></para></listitem>
<listitem><para><literal>GDK_3BUTTON_PRESS</literal></para></listitem>
<listitem><para><literal>GDK_BUTTON_RELEASE</literal></para></listitem>
</orderedlist>
</para>
<para>
For a double click to occur, the second button press must occur within 1/4 of
a second of the first. For a triple click to occur, the third button press
must also occur within 1/2 second of the first button press.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_BUTTON_PRESS</literal>, <literal>GDK_2BUTTON_PRESS</literal>,
<literal>GDK_3BUTTON_PRESS</literal> or <literal>GDK_BUTTON_RELEASE</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using 
<function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="guint32">guint32</link> <structfield>time</structfield></entry>
<entry>the time of the event in milliseconds.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>x</structfield></entry>
<entry>the x coordinate of the pointer relative to the window.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>y</structfield></entry>
<entry>the y coordinate of the pointer relative to the window.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> *<structfield>axes</structfield></entry>
<entry><parameter>x</parameter>, <parameter>y</parameter> translated to the axes of <parameter>device</parameter>, or <literal>NULL</literal> if <parameter>device</parameter> is 
  the mouse.
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>state</structfield></entry>
<entry>a bit-mask representing the state of the modifier keys (e.g. Control,
Shift and Alt) and the pointer buttons. See <link linkend="GdkModifierType">GdkModifierType</link>.
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>button</structfield></entry>
<entry>the button which was pressed or released, numbered from 1 to 5.
Normally button 1 is the left mouse button, 2 is the middle button,
and 3 is the right button. On 2-button mice, the middle button can often
be simulated by pressing both mouse buttons together.
</entry>
</row>
<row>
<entry><link linkend="GdkDevice">GdkDevice</link> *<structfield>device</structfield></entry>
<entry>the device where the event originated.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>x_root</structfield></entry>
<entry>the x coordinate of the pointer relative to the root of the screen.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>y_root</structfield></entry>
<entry>the y coordinate of the pointer relative to the root of the screen.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventScroll">struct GdkEventScroll</title>
<programlisting>struct GdkEventScroll
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  guint32 time;
  gdouble x;
  gdouble y;
  guint state;
  GdkScrollDirection direction;
  GdkDevice *device;
  gdouble x_root, y_root;
};
</programlisting>
<para>
Generated from button presses for the buttons 4 to 7. Wheel mice are 
usually configured to generate button press events for buttons 4 and 5
when the wheel is turned.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_SCROLL</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using 
<function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="guint32">guint32</link> <structfield>time</structfield></entry>
<entry>the time of the event in milliseconds.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>x</structfield></entry>
<entry>the x coordinate of the pointer relative to the window.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>y</structfield></entry>
<entry>the y coordinate of the pointer relative to the window.
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>state</structfield></entry>
<entry>a bit-mask representing the state of the modifier keys (e.g. Control,
Shift and Alt) and the pointer buttons. See <link linkend="GdkModifierType">GdkModifierType</link>.
</entry>
</row>
<row>
<entry><link linkend="GdkScrollDirection">GdkScrollDirection</link> <structfield>direction</structfield></entry>
<entry>the direction to scroll to (one of <literal>GDK_SCROLL_UP</literal>, 
  <literal>GDK_SCROLL_DOWN</literal>, <literal>GDK_SCROLL_LEFT</literal> and <literal>GDK_SCROLL_RIGHT</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkDevice">GdkDevice</link> *<structfield>device</structfield></entry>
<entry>the device where the event originated.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>x_root</structfield></entry>
<entry>the x coordinate of the pointer relative to the root of the screen.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>y_root</structfield></entry>
<entry>the y coordinate of the pointer relative to the root of the screen.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventMotion">struct GdkEventMotion</title>
<programlisting>struct GdkEventMotion
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  guint32 time;
  gdouble x;
  gdouble y;
  gdouble *axes;
  guint state;
  gint16 is_hint;
  GdkDevice *device;
  gdouble x_root, y_root;
};
</programlisting>
<para>
Generated when the pointer moves.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event.
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using 
<function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="guint32">guint32</link> <structfield>time</structfield></entry>
<entry>the time of the event in milliseconds.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>x</structfield></entry>
<entry>the x coordinate of the pointer relative to the window.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>y</structfield></entry>
<entry>the y coordinate of the pointer relative to the window.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> *<structfield>axes</structfield></entry>
<entry><parameter>x</parameter>, <parameter>y</parameter> translated to the axes of <parameter>device</parameter>, or <literal>NULL</literal> if <parameter>device</parameter> is 
  the mouse.
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>state</structfield></entry>
<entry>a bit-mask representing the state of the modifier keys (e.g. Control,
  Shift and Alt) and the pointer buttons. See <link linkend="GdkModifierType">GdkModifierType</link>.
</entry>
</row>
<row>
<entry><link linkend="gint16">gint16</link> <structfield>is_hint</structfield></entry>
<entry>
</entry>
</row>
<row>
<entry><link linkend="GdkDevice">GdkDevice</link> *<structfield>device</structfield></entry>
<entry>the device where the event originated.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>x_root</structfield></entry>
<entry>the x coordinate of the pointer relative to the root of the screen.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>y_root</structfield></entry>
<entry>the y coordinate of the pointer relative to the root of the screen.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventExpose">struct GdkEventExpose</title>
<programlisting>struct GdkEventExpose
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  GdkRectangle area;
  GdkRegion *region;
  gint count; /* If non-zero, how many more events follow. */
};
</programlisting>
<para>
Generated when all or part of a window becomes visible and needs to be
redrawn.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_EXPOSE</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using 
<function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="GdkRectangle">GdkRectangle</link> <structfield>area</structfield></entry>
<entry>bounding box of <parameter>region</parameter>.
</entry>
</row>
<row>
<entry><link linkend="GdkRegion">GdkRegion</link> *<structfield>region</structfield></entry>
<entry>the region that needs to be redrawn.
</entry>
</row>
<row>
<entry><link linkend="gint">gint</link> <structfield>count</structfield></entry>
<entry>the number of contiguous <literal>GDK_EXPOSE</literal> events following this one.
The only use for this is "exposure compression", i.e. handling all contiguous
<literal>GDK_EXPOSE</literal> events in one go, though GDK performs some exposure compression
so this is not normally needed.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventVisibility">struct GdkEventVisibility</title>
<programlisting>struct GdkEventVisibility
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  GdkVisibilityState state;
};
</programlisting>
<para>
Generated when the window visibility status has changed.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_VISIBILITY_NOTIFY</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using 
<function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="GdkVisibilityState">GdkVisibilityState</link> <structfield>state</structfield></entry>
<entry>the new visibility state (<literal>GDK_VISIBILITY_FULLY_OBSCURED</literal>,
<literal>GDK_VISIBILITY_PARTIAL</literal> or <literal>GDK_VISIBILITY_UNOBSCURED</literal>).

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventCrossing">struct GdkEventCrossing</title>
<programlisting>struct GdkEventCrossing
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  GdkWindow *subwindow;
  guint32 time;
  gdouble x;
  gdouble y;
  gdouble x_root;
  gdouble y_root;
  GdkCrossingMode mode;
  GdkNotifyType detail;
  gboolean focus;
  guint state;
};
</programlisting>
<para>
Generated when the pointer enters or leaves a window.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_ENTER_NOTIFY</literal> or <literal>GDK_LEAVE_NOTIFY</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using 
<function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>subwindow</structfield></entry>
<entry>the window that was entered or left.
</entry>
</row>
<row>
<entry><link linkend="guint32">guint32</link> <structfield>time</structfield></entry>
<entry>the time of the event in milliseconds.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>x</structfield></entry>
<entry>the x coordinate of the pointer relative to the window.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>y</structfield></entry>
<entry>the y coordinate of the pointer relative to the window.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>x_root</structfield></entry>
<entry>the x coordinate of the pointer relative to the root of the screen.
</entry>
</row>
<row>
<entry><link linkend="gdouble">gdouble</link> <structfield>y_root</structfield></entry>
<entry>the y coordinate of the pointer relative to the root of the screen.
</entry>
</row>
<row>
<entry><link linkend="GdkCrossingMode">GdkCrossingMode</link> <structfield>mode</structfield></entry>
<entry>the crossing mode (<literal>GDK_CROSSING_NORMAL</literal>, <literal>GDK_CROSSING_GRAB</literal> or
  <literal>GDK_CROSSING_UNGRAB</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkNotifyType">GdkNotifyType</link> <structfield>detail</structfield></entry>
<entry>the kind of crossing that happened (<literal>GDK_NOTIFY_INFERIOR</literal>,
  <literal>GDK_NOTIFY_ANCESTOR</literal>, <literal>GDK_NOTIFY_VIRTUAL</literal>, <literal>GDK_NOTIFY_NONLINEAR</literal> or
  <literal>GDK_NOTIFY_NONLINEAR_VIRTUAL</literal>).
</entry>
</row>
<row>
<entry><link linkend="gboolean">gboolean</link> <structfield>focus</structfield></entry>
<entry><literal>TRUE</literal> if <parameter>window</parameter> is the focus window or an inferior.
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>state</structfield></entry>
<entry>a bit-mask representing the state of the modifier keys (e.g. Control,
  Shift and Alt) and the pointer buttons. See <link linkend="GdkModifierType">GdkModifierType</link>.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventFocus">struct GdkEventFocus</title>
<programlisting>struct GdkEventFocus
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  gint16 in;
};
</programlisting>
<para>
Describes a change of keyboard focus.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_FOCUS_CHANGE</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using <function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="gint16">gint16</link> <structfield>in</structfield></entry>
<entry><literal>TRUE</literal> if the window has gained the keyboard focus, <literal>FALSE</literal> if it has lost
the focus.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventConfigure">struct GdkEventConfigure</title>
<programlisting>struct GdkEventConfigure
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  gint x, y;
  gint width;
  gint height;
};
</programlisting>
<para>
Generated when a window size or position has changed.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_CONFIGURE</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using <function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="gint">gint</link> <structfield>x</structfield></entry>
<entry>the new x coordinate of the window, relative to its parent.
</entry>
</row>
<row>
<entry><link linkend="gint">gint</link> <structfield>y</structfield></entry>
<entry>the new y coordinate of the window, relative to its parent.
</entry>
</row>
<row>
<entry><link linkend="gint">gint</link> <structfield>width</structfield></entry>
<entry>the new width of the window.
</entry>
</row>
<row>
<entry><link linkend="gint">gint</link> <structfield>height</structfield></entry>
<entry>the new height of the window.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventProperty">struct GdkEventProperty</title>
<programlisting>struct GdkEventProperty
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  GdkAtom atom;
  guint32 time;
  guint state;
};
</programlisting>
<para>
Describes a property change on a window.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_PROPERTY_NOTIFY</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using <function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="GdkAtom">GdkAtom</link> <structfield>atom</structfield></entry>
<entry>the property that was changed.
</entry>
</row>
<row>
<entry><link linkend="guint32">guint32</link> <structfield>time</structfield></entry>
<entry>the time of the event in milliseconds.
</entry>
</row>
<row>
<entry><link linkend="guint">guint</link> <structfield>state</structfield></entry>
<entry>whether the property was changed (<literal>GDK_PROPERTY_NEW_VALUE</literal>) or
deleted (<literal>GDK_PROPERTY_DELETE</literal>).

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventSelection">struct GdkEventSelection</title>
<programlisting>struct GdkEventSelection
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  GdkAtom selection;
  GdkAtom target;
  GdkAtom property;
  guint32 time;
  GdkNativeWindow requestor;
};
</programlisting>
<para>
Generated when a selection is requested or ownership of a selection 
is taken over by another client application. 
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_SELECTION_CLEAR</literal>, <literal>GDK_SELECTION_NOTIFY</literal> or 
<literal>GDK_SELECTION_REQUEST</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using <function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="GdkAtom">GdkAtom</link> <structfield>selection</structfield></entry>
<entry>the selection.
</entry>
</row>
<row>
<entry><link linkend="GdkAtom">GdkAtom</link> <structfield>target</structfield></entry>
<entry>the target to which the selection should be converted.
</entry>
</row>
<row>
<entry><link linkend="GdkAtom">GdkAtom</link> <structfield>property</structfield></entry>
<entry>the property in which to place the result of the conversion.
</entry>
</row>
<row>
<entry><link linkend="guint32">guint32</link> <structfield>time</structfield></entry>
<entry>the time of the event in milliseconds.
</entry>
</row>
<row>
<entry><link linkend="GdkNativeWindow">GdkNativeWindow</link> <structfield>requestor</structfield></entry>
<entry>the native window on which to place <parameter>property</parameter>.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkNativeWindow">GdkNativeWindow</title>
<para>
Used to represent native windows (<type>Window</type>s for the X11 backend, 
<type>HWND</type>s for Win32).
</para></refsect2>
<refsect2>
<title><anchor id="GdkEventDND">struct GdkEventDND</title>
<programlisting>struct GdkEventDND {
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  GdkDragContext *context;

  guint32 time;
  gshort x_root, y_root;
};
</programlisting>
<para>
Generated during DND operations. 
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_DRAG_ENTER</literal>, <literal>GDK_DRAG_LEAVE</literal>,
  <literal>GDK_DRAG_MOTION</literal>, <literal>GDK_DRAG_STATUS</literal>, <literal>GDK_DROP_START</literal> or <literal>GDK_DROP_FINISHED</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using <function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="GdkDragContext">GdkDragContext</link> *<structfield>context</structfield></entry>
<entry>the <link linkend="GdkDragContext">GdkDragContext</link> for the current DND operation.
</entry>
</row>
<row>
<entry><link linkend="guint32">guint32</link> <structfield>time</structfield></entry>
<entry>the time of the event in milliseconds.
</entry>
</row>
<row>
<entry><link linkend="gshort">gshort</link> <structfield>x_root</structfield></entry>
<entry>the x coordinate of the pointer relative to the root of the screen,
  only set for <literal>GDK_DRAG_MOTION</literal> and <literal>GDK_DROP_START</literal>.
</entry>
</row>
<row>
<entry><link linkend="gshort">gshort</link> <structfield>y_root</structfield></entry>
<entry>the y coordinate of the pointer relative to the root of the screen,
  only set for <literal>GDK_DRAG_MOTION</literal> and <literal>GDK_DROP_START</literal>.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventProximity">struct GdkEventProximity</title>
<programlisting>struct GdkEventProximity
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  guint32 time;
  GdkDevice *device;
};
</programlisting>
<para>
Proximity events are generated when using GDK's wrapper for the
XInput extension. The XInput extension is an add-on for standard X
that allows you to use nonstandard devices such as graphics tablets.
A proximity event indicates that the stylus has moved in or out of
contact with the tablet, or perhaps that the user's finger has moved
in or out of contact with a touch screen.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_PROXIMITY_IN</literal> or <literal>GDK_PROXIMITY_OUT</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using <function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="guint32">guint32</link> <structfield>time</structfield></entry>
<entry>the time of the event in milliseconds.
</entry>
</row>
<row>
<entry><link linkend="GdkDevice">GdkDevice</link> *<structfield>device</structfield></entry>
<entry>the device where the event originated.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventClient">struct GdkEventClient</title>
<programlisting>struct GdkEventClient
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  GdkAtom message_type;
  gushort data_format;
  union {
    char b[20];
    short s[10];
    long l[5];
  } data;
};
</programlisting>
<para>
An event sent by another client application.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_CLIENT_EVENT</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using <function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="GdkAtom">GdkAtom</link> <structfield>message_type</structfield></entry>
<entry>the type of the message, which can be defined by the
application.
</entry>
</row>
<row>
<entry><link linkend="gushort">gushort</link> <structfield>data_format</structfield></entry>
<entry>the format of the data, given as the number of bits in each
data element, i.e. 8, 16, or 32. 8-bit data uses the b array of the data
union, 16-bit data uses the s array, and 32-bit data uses the l array.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventNoExpose">struct GdkEventNoExpose</title>
<programlisting>struct GdkEventNoExpose
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  /* XXX: does anyone need the X major_code or minor_code fields? */
};
</programlisting>
<para>
Generated when the area of a <link linkend="GdkDrawable">GdkDrawable</link> being copied, with <link linkend="gdk-draw-drawable">gdk_draw_drawable</link>()
or <link linkend="gdk-window-copy-area">gdk_window_copy_area</link>(), was completely available.
</para>
<para>
FIXME: add more here.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_NO_EXPOSE</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using <function>XSendEvent</function>).

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventWindowState">struct GdkEventWindowState</title>
<programlisting>struct GdkEventWindowState
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  GdkWindowState changed_mask;
  GdkWindowState new_window_state;
};
</programlisting>
<para>
Generated when the state of a toplevel window changes.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_WINDOW_STATE</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using <function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindowState">GdkWindowState</link> <structfield>changed_mask</structfield></entry>
<entry>mask specifying what flags have changed.
</entry>
</row>
<row>
<entry><link linkend="GdkWindowState">GdkWindowState</link> <structfield>new_window_state</structfield></entry>
<entry>the new window state, a combination of <link linkend="GdkWindowState">GdkWindowState</link> bits.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkEventSetting">struct GdkEventSetting</title>
<programlisting>struct GdkEventSetting
{
  GdkEventType type;
  GdkWindow *window;
  gint8 send_event;
  GdkSettingAction action;
  char *name;
};
</programlisting>
<para>
Generated when a setting is modified.
</para><informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><link linkend="GdkEventType">GdkEventType</link> <structfield>type</structfield></entry>
<entry>the type of the event (<literal>GDK_SETTING</literal>).
</entry>
</row>
<row>
<entry><link linkend="GdkWindow">GdkWindow</link> *<structfield>window</structfield></entry>
<entry>the window which received the event.
</entry>
</row>
<row>
<entry><link linkend="gint8">gint8</link> <structfield>send_event</structfield></entry>
<entry><literal>TRUE</literal> if the event was sent explicitly (e.g. using <function>XSendEvent</function>).
</entry>
</row>
<row>
<entry><link linkend="GdkSettingAction">GdkSettingAction</link> <structfield>action</structfield></entry>
<entry>what happened to the setting (<literal>GDK_SETTING_ACTION_NEW</literal>,
  <literal>GDK_SETTING_ACTION_CHANGED</literal> or <literal>GDK_SETTING_ACTION_DELETED</literal>).
</entry>
</row>
<row>
<entry>char *<structfield>name</structfield></entry>
<entry>the name of the setting.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkScrollDirection">enum GdkScrollDirection</title>
<programlisting>typedef enum
{
  GDK_SCROLL_UP,
  GDK_SCROLL_DOWN,
  GDK_SCROLL_LEFT,
  GDK_SCROLL_RIGHT
} GdkScrollDirection;
</programlisting>
<para>
Specifies the direction for <link linkend="GdkEventScroll">GdkEventScroll</link>. 
</para><informaltable pgwide="1" frame="none" role="enum">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><literal>GDK_SCROLL_UP</literal></entry>
<entry>the window is scrolled up.
</entry>
</row>
<row>
<entry><literal>GDK_SCROLL_DOWN</literal></entry>
<entry>the window is scrolled down.
</entry>
</row>
<row>
<entry><literal>GDK_SCROLL_LEFT</literal></entry>
<entry>the window is scrolled to the left.
</entry>
</row>
<row>
<entry><literal>GDK_SCROLL_RIGHT</literal></entry>
<entry>the window is scrolled to the right.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkVisibilityState">enum GdkVisibilityState</title>
<programlisting>typedef enum
{
  GDK_VISIBILITY_UNOBSCURED,
  GDK_VISIBILITY_PARTIAL,
  GDK_VISIBILITY_FULLY_OBSCURED
} GdkVisibilityState;
</programlisting>
<para>
Specifies the visiblity status of a window for a <link linkend="GdkEventVisibility">GdkEventVisibility</link>.
</para><informaltable pgwide="1" frame="none" role="enum">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><literal>GDK_VISIBILITY_UNOBSCURED</literal></entry>
<entry>the window is completely visible.
</entry>
</row>
<row>
<entry><literal>GDK_VISIBILITY_PARTIAL</literal></entry>
<entry>the window is partially visible.
</entry>
</row>
<row>
<entry><literal>GDK_VISIBILITY_FULLY_OBSCURED</literal></entry>
<entry>the window is not visible at all.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkCrossingMode">enum GdkCrossingMode</title>
<programlisting>typedef enum
{
  GDK_CROSSING_NORMAL,
  GDK_CROSSING_GRAB,
  GDK_CROSSING_UNGRAB
} GdkCrossingMode;
</programlisting>
<para>
Specifies the crossing mode for <link linkend="GdkEventCrossing">GdkEventCrossing</link>.
</para><informaltable pgwide="1" frame="none" role="enum">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><literal>GDK_CROSSING_NORMAL</literal></entry>
<entry>crossing because of pointer motion.
</entry>
</row>
<row>
<entry><literal>GDK_CROSSING_GRAB</literal></entry>
<entry>crossing because a grab is activated.
</entry>
</row>
<row>
<entry><literal>GDK_CROSSING_UNGRAB</literal></entry>
<entry>crossing because a grab is deactivated.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkNotifyType">enum GdkNotifyType</title>
<programlisting>typedef enum
{
  GDK_NOTIFY_ANCESTOR		= 0,
  GDK_NOTIFY_VIRTUAL		= 1,
  GDK_NOTIFY_INFERIOR		= 2,
  GDK_NOTIFY_NONLINEAR		= 3,
  GDK_NOTIFY_NONLINEAR_VIRTUAL	= 4,
  GDK_NOTIFY_UNKNOWN		= 5
} GdkNotifyType;
</programlisting>
<para>
Specifies the kind of crossing for <link linkend="GdkEventCrossing">GdkEventCrossing</link>.
</para>
<para>
See the X11 protocol specification of <type>LeaveNotify</type> for
full details of crossing event generation.
</para><informaltable pgwide="1" frame="none" role="enum">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><literal>GDK_NOTIFY_ANCESTOR</literal></entry>
<entry>the window is entered from an ancestor or 
   left towards an ancestor.
</entry>
</row>
<row>
<entry><literal>GDK_NOTIFY_VIRTUAL</literal></entry>
<entry>the pointer moves between an ancestor and an 
    inferior of the window.
</entry>
</row>
<row>
<entry><literal>GDK_NOTIFY_INFERIOR</literal></entry>
<entry>the window is entered from an inferior or 
   left towards an inferior.
</entry>
</row>
<row>
<entry><literal>GDK_NOTIFY_NONLINEAR</literal></entry>
<entry> the window is entered from or left towards 
   a window which is neither an ancestor nor an inferior.
</entry>
</row>
<row>
<entry><literal>GDK_NOTIFY_NONLINEAR_VIRTUAL</literal></entry>
<entry>the pointer moves between two windows 
   which are not ancestors of each other and the window is part of
   the ancestor chain between one of these windows and their least
   common ancestor.
</entry>
</row>
<row>
<entry><literal>GDK_NOTIFY_UNKNOWN</literal></entry>
<entry>

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkPropertyState">enum GdkPropertyState</title>
<programlisting>typedef enum
{
  GDK_PROPERTY_NEW_VALUE,
  GDK_PROPERTY_DELETE
} GdkPropertyState;
</programlisting>
<para>
Specifies the type of a property change for a <link linkend="GdkEventProperty">GdkEventProperty</link>.
</para><informaltable pgwide="1" frame="none" role="enum">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><literal>GDK_PROPERTY_NEW_VALUE</literal></entry>
<entry>the property value was changed.
</entry>
</row>
<row>
<entry><literal>GDK_PROPERTY_DELETE</literal></entry>
<entry>the property was deleted.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkWindowState">enum GdkWindowState</title>
<programlisting>typedef enum
{
  GDK_WINDOW_STATE_WITHDRAWN = 1 &lt;&lt; 0,
  GDK_WINDOW_STATE_ICONIFIED = 1 &lt;&lt; 1,
  GDK_WINDOW_STATE_MAXIMIZED = 1 &lt;&lt; 2,
  GDK_WINDOW_STATE_STICKY    = 1 &lt;&lt; 3
} GdkWindowState;
</programlisting>
<para>
Specifies the state of a toplevel window.
</para><informaltable pgwide="1" frame="none" role="enum">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><literal>GDK_WINDOW_STATE_WITHDRAWN</literal></entry>
<entry>the window is not shown.
</entry>
</row>
<row>
<entry><literal>GDK_WINDOW_STATE_ICONIFIED</literal></entry>
<entry>the window is minimized.
</entry>
</row>
<row>
<entry><literal>GDK_WINDOW_STATE_MAXIMIZED</literal></entry>
<entry>the window is maximized.
</entry>
</row>
<row>
<entry><literal>GDK_WINDOW_STATE_STICKY</literal></entry>
<entry>the window is sticky.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="GdkSettingAction">enum GdkSettingAction</title>
<programlisting>typedef enum
{
  GDK_SETTING_ACTION_NEW,
  GDK_SETTING_ACTION_CHANGED,
  GDK_SETTING_ACTION_DELETED
} GdkSettingAction;
</programlisting>
<para>
Specifies the kind of modification applied to a setting in a <link linkend="GdkEventSetting">GdkEventSetting</link>.
</para><informaltable pgwide="1" frame="none" role="enum">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row>
<entry><literal>GDK_SETTING_ACTION_NEW</literal></entry>
<entry>a setting was added.
</entry>
</row>
<row>
<entry><literal>GDK_SETTING_ACTION_CHANGED</literal></entry>
<entry>a setting was changed.
</entry>
</row>
<row>
<entry><literal>GDK_SETTING_ACTION_DELETED</literal></entry>
<entry>a setting was deleted.

</entry>
</row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>




</refentry>
