NAME
XChangeDeviceDontPropagateList, XGetDeviceDontPropagateList - query or change the dont-propagate-list for extension devices
SYNTAX
int XChangeDeviceDontPropagateList(Display *_d_i_s_p_l_a_y, Window
*_w_i_n_d_o_w, int *_c_o_u_n_t, XEventClass *_e_v_e_n_t___l_i_s_t, int
_m_o_d_e);
XEventClass *XGetDeviceDontPropagateList(Display *_d_i_s_p_l_a_y, Window
*_w_i_n_d_o_w, int *_c_o_u_n_t);
ARGUMENTS
-
display
-
Specifies the connection to the X server.
-
window
-
Specifies the window whose dont-propagate-list is to be queried or modified.
-
event_list
-
Specifies a pointer to a list of event classes.
-
mode
-
Specifies the mode.
You can pass
_A_d_d_T_o_L_i_s_t ,
or
_D_e_l_e_t_e_F_r_o_m_L_i_s_t.
-
count
-
Specifies the number of event classes in the list.
DESCRIPTION
The _X_C_h_a_n_g_e_D_e_v_i_c_e_D_o_n_t_P_r_o_p_a_g_a_t_e_L_i_s_t request modifies the list
of events that should not be propagated to ancestors of the event window.
This request allows extension events to be added to or deleted from
that list. By default, all events are propagated to ancestor windows.
Once modified, the list remains modified for the life of the window.
Events are not removed from the list because the client that added them
has terminated.
Suppression of event propagation is not allowed for all input extension
events. If a specified event class is one that cannot be suppressed,
a _B_a_d_C_l_a_s_s error will result. Events that can be suppressed
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_a_s_e, _D_e_v_i_c_e_M_o_t_i_o_n_N_o_t_i_f_y, _P_r_o_x_i_m_i_t_y_I_n,
and _P_r_o_x_i_m_i_t_y_O_u_t.
_X_C_h_a_n_g_e_D_e_v_i_c_e_D_o_n_t_P_r_o_p_a_g_a_t_e_L_i_s_t
can generate a _B_a_d_D_e_v_i_c_e, _B_a_d_C_l_a_s_s, or _B_a_d_V_a_l_u_e error.
The _X_G_e_t_D_e_v_i_c_e_D_o_n_t_P_r_o_p_a_g_a_t_e_L_i_s_t request queries the list
of events that should not be propagated to ancestors of the event window.
_X_G_e_t_D_e_v_i_c_e_D_o_n_t_P_r_o_p_a_g_a_t_e_L_i_s_t
can generate a _B_a_d_C_l_a_s_s or _B_a_d_W_i_n_d_o_w error.
DIAGNOSTICS
-
_B_a_d_D_e_v_i_c_e
-
An invalid device was specified. The specified device does not exist or has
not been opened by this client via _X_O_p_e_n_I_n_p_u_t_D_e_v_i_c_e. This error may
also occur if some other client has caused the specified device to become
the X keyboard or X pointer device via the _X_C_h_a_n_g_e_K_e_y_b_o_a_r_d_D_e_v_i_c_e or
_X_C_h_a_n_g_e_P_o_i_n_t_e_r_D_e_v_i_c_e requests.
-
_B_a_d_V_a_l_u_e
-
Some numeric value falls outside the range of values accepted by the request.
Unless a specific range is specified for an argument, the full range defined
by the argument's type is accepted. Any argument defined as a set of
alternatives can generate this error.
-
_B_a_d_W_i_n_d_o_w
-
An invalid window id was specified.
-
_B_a_d_C_l_a_s_s
-
An invalid event class was specified.
SEE ALSO
_P_r_o_g_r_a_m_m_i_n_g _W_i_t_h _X_l_i_b