NAME
XSelectExtensionEvent, XGetSelectedExtensionEvents - select extension events, get the list of currently selected extension events
SYNTAX
XSelectExtensionEvent(_d_i_s_p_l_a_y, _w, _e_v_e_n_t___l_i_s_t, _e_v_e_n_t___c_o_u_n_t)
Display *_d_i_s_p_l_a_y;
Window _w;
XEventClass *_e_v_e_n_t___l_i_s_t;
int _e_v_e_n_t___c_o_u_n_t;
XGetSelectedExtensionEvents(_d_i_s_p_l_a_y, _w, _t_h_i_s___c_l_i_e_n_t___e_v_e_n_t___c_o_u_n_t___r_e_t_u_r_n,
_t_h_i_s___c_l_i_e_n_t___e_v_e_n_t___l_i_s_t___r_e_t_u_r_n, _a_l_l___c_l_i_e_n_t_s___e_v_e_n_t___c_o_u_n_t___r_e_t_u_r_n,
_a_l_l___c_l_i_e_n_t_s___e_v_e_n_t___l_i_s_t___r_e_t_u_r_n)
Display *_d_i_s_p_l_a_y;
Window _w;
int _t_h_i_s___c_l_i_e_n_t___e_v_e_n_t___c_o_u_n_t___r_e_t_u_r_n;
XEventClass *_t_h_i_s___c_l_i_e_n_t___e_v_e_n_t___l_i_s_t___r_e_t_u_r_n;
int _a_l_l___c_l_i_e_n_t_s___e_v_e_n_t___c_o_u_n_t___r_e_t_u_r_n;
XEventClass *_a_l_l___c_l_i_e_n_t_s___e_v_e_n_t___l_i_s_t___r_e_t_u_r_n;
ARGUMENTS
-
display
-
Specifies the connection to the X server.
-
w
-
Specifies the window whose events you are interested in.
-
event_list
-
Specifies the list of event classes that describe the events you are interested in.
-
event_count
-
Specifies the count of event classes in the event list.
-
this_client_event_count_return
-
Returns the count of event classes selected by this client.
-
this_client_event_list_return
-
Returns a pointer to the list of event classes selected by this client.
-
all_clients_event_count_return
-
Returns the count of event classes selected by all clients.
-
all_clients_event_list_return
-
Returns a pointer to the list of event classes selected by all clients.
DESCRIPTION
The
_X_S_e_l_e_c_t_E_x_t_e_n_s_i_o_n_E_v_e_n_t request causes the X server to report the
events associated with the
specified list of event classes.
Initially, X will not report any of these events.
Events are reported relative to a window.
If a window is not interested in a device event, it usually propagates to
the closest ancestor that is interested,
unless the do_not_propagate mask prohibits it.
Multiple clients can select for the same events on the same window
with the following restrictions:
-
·
Multiple clients can select events on the same window because their event masks
-
are disjoint.
When the X server generates an event, it reports it
to all interested clients.
-
·
Only one client at a time can select a
-
_D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s
event with automatic passive grabbing enabled, which is associated with
the event class _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s_G_r_a_b.
To receive _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s events without automatic passive
grabbing, use event class _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s but do not specify
event class _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s_G_r_a_b.
The server reports the event to all interested clients.
Information contained in the _X_D_e_v_i_c_e structure returned by
_X_O_p_e_n_D_e_v_i_c_e is used
by macros to obtain the event classes that clients use in making
_X_S_e_l_e_c_t_E_x_t_e_n_s_i_o_n_E_v_e_n_t requests. Currently defined macros include
_D_e_v_i_c_e_K_e_y_P_r_e_s_s, _D_e_v_i_c_e_K_e_y_R_e_l_e_a_s_e, _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s,
_D_e_v_i_c_e_B_u_t_t_o_n_R_e_l_e_s_e, _D_e_v_i_c_e_M_o_t_i_o_n_N_o_t_i_f_y, _D_e_v_i_c_e_F_o_c_u_s_I_n,
_D_e_v_i_c_e_F_o_c_u_s_O_u_t, _P_r_o_x_i_m_i_t_y_I_n, _P_r_o_x_i_m_i_t_y_O_u_t,
_D_e_v_i_c_e_S_t_a_t_e_N_o_t_i_f_y, _D_e_v_i_c_e_M_a_p_p_i_i_n_g_N_o_t_i_f_y,
_C_h_a_n_g_e_D_e_v_i_c_e_N_o_t_i_f_y, _D_e_v_i_c_e_P_o_i_n_t_e_r_M_o_t_i_o_n_H_i_n_t,
_D_e_v_i_c_e_B_u_t_t_o_n_1_M_o_t_i_o_n, _D_e_v_i_c_e_B_u_t_t_o_n_2_M_o_t_i_o_n, _D_e_v_i_c_e_B_u_t_t_o_n_3_M_o_t_i_o_n,
_D_e_v_i_c_e_B_u_t_t_o_n_4_M_o_t_i_o_n, _D_e_v_i_c_e_B_u_t_t_o_n_5_M_o_t_i_o_n, _D_e_v_i_c_e_B_u_t_t_o_n_M_o_t_i_o_n,
_D_e_v_i_c_e_O_w_n_e_r_G_r_a_b_B_u_t_t_o_n, _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s_G_r_a_b, and
_N_o_E_x_t_e_n_s_i_o_n_E_v_e_n_t.
To obtain the proper event class for a particular device, one of the above
macros is invoked using the _X_D_e_v_i_c_e structure for that device. For
example,
DeviceKeyPress (*device, type, eventclass);
returns the _D_e_v_i_c_e_K_e_y_P_r_e_s_s event type and the eventclass for selecting
_D_e_v_i_c_e_K_e_y_P_r_e_s_s events from this device.
_X_S_e_l_e_c_t_E_x_t_e_n_s_i_o_n_E_v_e_n_t
can generate a _B_a_d_W_i_n_d_o_w or _B_a_d_C_l_a_s_s error.
The
_X_G_e_t_S_e_l_e_c_t_e_d_E_x_t_e_n_s_i_o_n_E_v_e_n_t_s
request reports the extension events selected by this client and all clients
for the specified window. This request returns pointers to two
_X_E_v_e_n_t_C_l_a_s_s
arrays. One lists the input extension events selected by this client from
the specified window. The other lists the event classes selected by all
clients from the specified window. You should use _X_F_r_e_e to free these
two arrays.
_X_G_e_t_S_e_l_e_c_t_e_d_E_x_t_e_n_s_i_o_n_E_v_e_n_t_s
can generate a _B_a_d_W_i_n_d_o_w error.
DIAGNOSTICS
-
_B_a_d_W_i_n_d_o_w
-
A value for a Window argument does not name a defined Window.
-
_B_a_d_C_l_a_s_s
-
A value for an XEventClass argument is invalid.
SEE ALSO
_P_r_o_g_r_a_m_m_i_n_g _w_i_t_h _X_l_i_b