gdk-Events               package:RGtk2               R Documentation

_E_v_e_n_t_s

_D_e_s_c_r_i_p_t_i_o_n:

     Functions for handling events from the window system

_M_e_t_h_o_d_s _a_n_d _F_u_n_c_t_i_o_n_s:

     'gdkEventsPending()'
      'gdkEventPeek()'
      'gdkEventGet()'
      'gdkEventGetGraphicsExpose(window)'
      'gdkEventPut(object)'
      'gdkEventNew(type)'
      'gdkEventCopy(object)'
      'gdkEventGetTime(object)'
      'gdkEventGetState(object)'
      'gdkEventGetAxis(object, axis.use)'
      'gdkEventGetCoords(object)'
      'gdkEventGetRootCoords(object)'
      'gdkEventRequestMotions(event)'
      'gdkEventHandlerSet(func, data)'
      'gdkAddClientMessageFilter(message.type, func, data)'
      'gdkGetShowEvents()'
      'gdkSetShowEvents(show.events)'
      'gdkEventSetScreen(object, screen)'
      'gdkEventGetScreen(object)'
      'gdkSettingGet(name)'

_D_e_t_a_i_l_e_d _D_e_s_c_r_i_p_t_i_o_n:

     This section describes functions dealing with events from the
     window system.

     In GTK+ applications the events are handled automatically in
     'gtkMainDoEvent' and passed on to the appropriate widgets, so
     these functions are rarely needed. Though some of the fields in
     the Event Structures are useful.

_E_n_u_m_s _a_n_d _F_l_a_g_s:


     '_G_d_k_E_v_e_n_t_T_y_p_e' Specifies the type of the event.

          Do not confuse these events with the signals that GTK+
          widgets emit. Although many of these events result in
          corresponding signals being emitted, the events are often
          transformed or filtered along the way.

          '_n_o_t_h_i_n_g' a special code to indicate a null event.

          '_d_e_l_e_t_e' the window manager has requested that the toplevel
               window be hidden or destroyed, usually when the user
               clicks on a special icon in the title bar.

          '_d_e_s_t_r_o_y' the window has been destroyed.

          '_e_x_p_o_s_e' all or part of the window has become visible and
               needs to be redrawn.

          '_m_o_t_i_o_n-_n_o_t_i_f_y' the pointer (usually a mouse) has moved.

          '_b_u_t_t_o_n-_p_r_e_s_s' a mouse button has been pressed.

          '_2_b_u_t_t_o_n-_p_r_e_s_s' a mouse button has been double-clicked
               (clicked twice within a short period of time). Note that
               each click also generates a 'GDK_BUTTON_PRESS' event.

          '_3_b_u_t_t_o_n-_p_r_e_s_s' a mouse button has been clicked 3 times in a
               short period of time. Note that each click also
               generates a 'GDK_BUTTON_PRESS' event.

          '_b_u_t_t_o_n-_r_e_l_e_a_s_e' a mouse button has been released.

          '_k_e_y-_p_r_e_s_s' a key has been pressed.

          '_k_e_y-_r_e_l_e_a_s_e' a key has been released.

          '_e_n_t_e_r-_n_o_t_i_f_y' the pointer has entered the window.

          '_l_e_a_v_e-_n_o_t_i_f_y' the pointer has left the window.

          '_f_o_c_u_s-_c_h_a_n_g_e' the keyboard focus has entered or left the
               window.

          '_c_o_n_f_i_g_u_r_e' the size, position or stacking order of the
               window has changed. Note that GTK+ discards these events
               for 'GDK_WINDOW_CHILD' windows.

          '_m_a_p' the window has been mapped.

          '_u_n_m_a_p' the window has been unmapped.

          '_p_r_o_p_e_r_t_y-_n_o_t_i_f_y' a property on the window has been changed
               or deleted.

          '_s_e_l_e_c_t_i_o_n-_c_l_e_a_r' the application has lost ownership of a
               selection.

          '_s_e_l_e_c_t_i_o_n-_r_e_q_u_e_s_t' another application has requested a
               selection.

          '_s_e_l_e_c_t_i_o_n-_n_o_t_i_f_y' a selection has been received.

          '_p_r_o_x_i_m_i_t_y-_i_n' an input device has moved into contact with a
               sensing surface (e.g. a touchscreen or graphics tablet).

          '_p_r_o_x_i_m_i_t_y-_o_u_t' an input device has moved out of contact with
               a sensing surface.

          '_d_r_a_g-_e_n_t_e_r' the mouse has entered the window while a drag is
               in progress.

          '_d_r_a_g-_l_e_a_v_e' the mouse has left the window while a drag is in
               progress.

          '_d_r_a_g-_m_o_t_i_o_n' the mouse has moved in the window while a drag
               is in progress.

          '_d_r_a_g-_s_t_a_t_u_s' the status of the drag operation initiated by
               the window has changed.

          '_d_r_o_p-_s_t_a_r_t' a drop operation onto the window has started.

          '_d_r_o_p-_f_i_n_i_s_h_e_d' the drop operation initiated by the window
               has completed.

          '_c_l_i_e_n_t-_e_v_e_n_t' a message has been received from another
               application.

          '_v_i_s_i_b_i_l_i_t_y-_n_o_t_i_f_y' the window visibility status has changed.

          '_n_o-_e_x_p_o_s_e' indicates that the source region was completely
               available when parts of a drawable were copied. This is
               not very useful.

          '_s_c_r_o_l_l' the scroll wheel was turned

          '_w_i_n_d_o_w-_s_t_a_t_e' the state of a window has changed. See
               'GdkWindowState' for the possible window states

          '_s_e_t_t_i_n_g' a setting has been modified.


     '_G_d_k_E_v_e_n_t_M_a_s_k' 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 'GdkEventType' event types above.
          'GDK_POINTER_MOTION_HINT_MASK' is a special mask which is
          used to reduce the number of 'GDK_MOTION_NOTIFY' events
          received. Normally a 'GDK_MOTION_NOTIFY' 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 'GDK_POINTER_MOTION_HINT_MASK', fewer
          'GDK_MOTION_NOTIFY' events will be sent, some of which are
          marked as a hint (the is_hint member is 'TRUE'). To receive
          more motion events after a motion hint event, the application
          needs to asks for more, by calling 'gdkEventRequestMotions'.

          '_e_x_p_o_s_u_r_e-_m_a_s_k' receive expose events

          '_p_o_i_n_t_e_r-_m_o_t_i_o_n-_m_a_s_k' receive all pointer motion events

          '_p_o_i_n_t_e_r-_m_o_t_i_o_n-_h_i_n_t-_m_a_s_k' see the explanation above

          '_b_u_t_t_o_n-_m_o_t_i_o_n-_m_a_s_k' receive pointer motion events while any
               button is pressed

          '_b_u_t_t_o_n_1-_m_o_t_i_o_n-_m_a_s_k' receive pointer motion events while 1
               button is pressed

          '_b_u_t_t_o_n_2-_m_o_t_i_o_n-_m_a_s_k' receive pointer motion events while 2
               button is pressed

          '_b_u_t_t_o_n_3-_m_o_t_i_o_n-_m_a_s_k' receive pointer motion events while 3
               button is pressed

          '_b_u_t_t_o_n-_p_r_e_s_s-_m_a_s_k' receive button press events

          '_b_u_t_t_o_n-_r_e_l_e_a_s_e-_m_a_s_k' receive button release events

          '_k_e_y-_p_r_e_s_s-_m_a_s_k' receive key press events

          '_k_e_y-_r_e_l_e_a_s_e-_m_a_s_k' receive key release events

          '_e_n_t_e_r-_n_o_t_i_f_y-_m_a_s_k' receive window enter events

          '_l_e_a_v_e-_n_o_t_i_f_y-_m_a_s_k' receive window leave events

          '_f_o_c_u_s-_c_h_a_n_g_e-_m_a_s_k' receive focus change events

          '_s_t_r_u_c_t_u_r_e-_m_a_s_k' receive events about window configuration
               change

          '_p_r_o_p_e_r_t_y-_c_h_a_n_g_e-_m_a_s_k' receive property change events

          '_v_i_s_i_b_i_l_i_t_y-_n_o_t_i_f_y-_m_a_s_k' receive visibility change events

          '_p_r_o_x_i_m_i_t_y-_i_n-_m_a_s_k' receive proximity in events

          '_p_r_o_x_i_m_i_t_y-_o_u_t-_m_a_s_k' receive proximity out events

          '_s_u_b_s_t_r_u_c_t_u_r_e-_m_a_s_k' receive events about window configuration
               changes of  child windows

          '_s_c_r_o_l_l-_m_a_s_k' receive scroll events

          '_a_l_l-_e_v_e_n_t_s-_m_a_s_k' the combination of all the above event
               masks.


_U_s_e_r _F_u_n_c_t_i_o_n_s:


     '_G_d_k_E_v_e_n_t_F_u_n_c(_e_v_e_n_t, _d_a_t_a)' Specifies the type of function passed
          to 'gdkEventHandlerSet' to handle all GDK events.

          '_e_v_e_n_t' ['GdkEvent'] the 'GdkEvent' to process.

          '_d_a_t_a' [R object] user data set when the event handler was
               installed with 'gdkEventHandlerSet'.


_A_u_t_h_o_r(_s):

     Derived by RGtkGen from GTK+ documentation

_R_e_f_e_r_e_n_c_e_s:

     <URL: http://developer.gnome.org/doc/API/2.0/gdk/gdk-Events.html>

