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