home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xcrossingevent.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  7.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XCrossingEvent(3X11)      XLIB FUNCTIONS     XCrossingEvent(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XCrossingEvent - EnterNotify and LeaveNotify event struc-
  9.        ture
  10.  
  11. SSTTRRUUCCTTUURREESS
  12.        The structure for _E_n_t_e_r_N_o_t_i_f_y and _L_e_a_v_e_N_o_t_i_f_y events con-
  13.        tains:
  14.  
  15.        typedef struct {
  16.         int type;             /* EnterNotify or LeaveNotify */
  17.         unsigned long serial;    /* # of last request processed by server */
  18.         Bool send_event;         /* true if this came from a SendEvent request */
  19.         Display *display;         /* Display the event was read from */
  20.         Window window;         /* ``event'' window reported relative to */
  21.         Window root;         /* root window that the event occurred on */
  22.         Window subwindow;         /* child window */
  23.         Time time;             /* milliseconds */
  24.         int x, y;             /* pointer x, y coordinates in event window */
  25.         int x_root, y_root;         /* coordinates relative to root */
  26.         int mode;             /* NotifyNormal, NotifyGrab, NotifyUngrab */
  27.         int detail;
  28.                      /*
  29.                      * NotifyAncestor, NotifyVirtual, NotifyInferior,
  30.                      * NotifyNonlinear,NotifyNonlinearVirtual
  31.                      */
  32.         Bool same_screen;         /* same screen flag */
  33.         Bool focus;             /* boolean focus */
  34.         unsigned int state;         /* key or button mask */
  35.        } XCrossingEvent;
  36.        typedef XCrossingEvent XEnterWindowEvent;
  37.        typedef XCrossingEvent XLeaveWindowEvent;
  38.  
  39.        When you receive these events, the structure members are
  40.        set as follows.
  41.  
  42.        The type member is set to the event type constant name
  43.        that uniquely identifies it.  For example, when the X
  44.        server reports a _G_r_a_p_h_i_c_s_E_x_p_o_s_e event to a client applica-
  45.        tion, it sends an _X_G_r_a_p_h_i_c_s_E_x_p_o_s_e_E_v_e_n_t structure with the
  46.        type member set to _G_r_a_p_h_i_c_s_E_x_p_o_s_e.  The display member is
  47.        set to a pointer to the display the event was read on.
  48.        The send_event member is set to _T_r_u_e if the event came
  49.        from a _S_e_n_d_E_v_e_n_t protocol request.  The serial member is
  50.        set from the serial number reported in the protocol but
  51.        expanded from the 16-bit least-significant bits to a full
  52.        32-bit value.  The window member is set to the window that
  53.        is most useful to toolkit dispatchers.
  54.  
  55.        The window member is set to the window on which the _E_n_t_e_r_-
  56.        _N_o_t_i_f_y or _L_e_a_v_e_N_o_t_i_f_y event was generated and is referred
  57.        to as the event window.    This is the window used by the X
  58.        server to report the event, and is relative to the root
  59.        window on which the event occurred.  The root member is
  60.        set to the root window of the screen on which the event
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XCrossingEvent(3X11)      XLIB FUNCTIONS     XCrossingEvent(3X11)
  71.  
  72.  
  73.        occurred.
  74.  
  75.        For a _L_e_a_v_e_N_o_t_i_f_y event, if a child of the event window
  76.        contains the initial position of the pointer, the subwin-
  77.        dow component is set to that child.  Otherwise, the X
  78.        server sets the subwindow member to _N_o_n_e.  For an _E_n_t_e_r_-
  79.        _N_o_t_i_f_y event, if a child of the event window contains the
  80.        final pointer position, the subwindow component is set to
  81.        that child or _N_o_n_e.
  82.  
  83.        The time member is set to the time when the event was gen-
  84.        erated and is expressed in milliseconds.     The x and y mem-
  85.        bers are set to the coordinates of the pointer position in
  86.        the event window.  This position is always the pointer's
  87.        final position, not its initial position.  If the event
  88.        window is on the same screen as the root window, x and y
  89.        are the pointer coordinates relative to the event window's
  90.        origin.    Otherwise, x and y are set to zero.  The x_root
  91.        and y_root members are set to the pointer's coordinates
  92.        relative to the root window's origin at the time of the
  93.        event.
  94.  
  95.        The same_screen member is set to indicate whether the
  96.        event window is on the same screen as the root window and
  97.        can be either _T_r_u_e or _F_a_l_s_e.  If _T_r_u_e, the event and root
  98.        windows are on the same screen.    If _F_a_l_s_e, the event and
  99.        root windows are not on the same screen.
  100.  
  101.        The focus member is set to indicate whether the event win-
  102.        dow is the focus window or an inferior of the focus win-
  103.        dow.  The X server can set this member to either _T_r_u_e or
  104.        _F_a_l_s_e.  If _T_r_u_e, the event window is the focus window or
  105.        an inferior of the focus window.     If _F_a_l_s_e, the event win-
  106.        dow is not the focus window or an inferior of the focus
  107.        window.
  108.  
  109.        The state member is set to indicate the state of the
  110.        pointer buttons and modifier keys just prior to the event.
  111.        The X server can set this member to the bitwise inclusive
  112.        OR of one or more of the button or modifier key masks:
  113.        _B_u_t_t_o_n_1_M_a_s_k, _B_u_t_t_o_n_2_M_a_s_k, _B_u_t_t_o_n_3_M_a_s_k, _B_u_t_t_o_n_4_M_a_s_k,
  114.        _B_u_t_t_o_n_5_M_a_s_k, _S_h_i_f_t_M_a_s_k, _L_o_c_k_M_a_s_k, _C_o_n_t_r_o_l_M_a_s_k, _M_o_d_1_M_a_s_k,
  115.        _M_o_d_2_M_a_s_k, _M_o_d_3_M_a_s_k, _M_o_d_4_M_a_s_k, _M_o_d_5_M_a_s_k.
  116.  
  117.        The mode member is set to indicate whether the events are
  118.        normal events, pseudo-motion events when a grab activates,
  119.        or pseudo-motion events when a grab deactivates.     The X
  120.        server can set this member to _N_o_t_i_f_y_N_o_r_m_a_l, _N_o_t_i_f_y_G_r_a_b, or
  121.        _N_o_t_i_f_y_U_n_g_r_a_b.
  122.  
  123.        The detail member is set to indicate the notify detail and
  124.        can be _N_o_t_i_f_y_A_n_c_e_s_t_o_r, _N_o_t_i_f_y_V_i_r_t_u_a_l, _N_o_t_i_f_y_I_n_f_e_r_i_o_r,
  125.        _N_o_t_i_f_y_N_o_n_l_i_n_e_a_r, or _N_o_t_i_f_y_N_o_n_l_i_n_e_a_r_V_i_r_t_u_a_l.
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XCrossingEvent(3X11)      XLIB FUNCTIONS     XCrossingEvent(3X11)
  137.  
  138.  
  139. SSEEEE AALLSSOO
  140.        XAnyEvent(3X11), XButtonEvent(3X11), XCreateWindow-
  141.        Event(3X11), XCirculateEvent(3X11), XCircu-
  142.        lateRequestEvent(3X11), XColormapEvent(3X11), XConfig-
  143.        ureEvent(3X11), XConfigureRequestEvent(3X11), XDestroyWin-
  144.        dowEvent(3X11), XErrorEvent(3X11), XExposeEvent(3X11),
  145.        XFocusChangeEvent(3X11), XGraphicsExposeEvent(3X11),
  146.        XGravityEvent(3X11), XKeymapEvent(3X11), XMapEvent(3X11),
  147.        XMapRequestEvent(3X11), XPropertyEvent(3X11), XRepar-
  148.        entEvent(3X11), XResizeRequestEvent(3X11), XSelection-
  149.        ClearEvent(3X11), XSelectionEvent(3X11), XSelectionRe-
  150.        questEvent(3X11), XUnmapEvent(3X11), XVisibili-
  151.        tyEvent(3X11)
  152.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.