NAME
XSetTransientForHint, XGetTransientForHint - set or read a window's WM_TRANSIENT_FOR property
SYNTAX
int XSetTransientForHint(Display *_d_i_s_p_l_a_y, Window _w,
Window _p_r_o_p___w_i_n_d_o_w);
Status XGetTransientForHint(Display *_d_i_s_p_l_a_y, Window _w,
Window *_p_r_o_p___w_i_n_d_o_w___r_e_t_u_r_n);
ARGUMENTS
-
_d_i_s_p_l_a_y
Specifies the connection to the X server.
-
-
_w
Specifies the window.
-
-
_p_r_o_p___w_i_n_d_o_w
Specifies the window that the WM_TRANSIENT_FOR property is to be set to.
-
-
_p_r_o_p___w_i_n_d_o_w___r_e_t_u_r_n
Returns the WM_TRANSIENT_FOR property of the specified window.
-
DESCRIPTION
The
_X_S_e_t_T_r_a_n_s_i_e_n_t_F_o_r_H_i_n_t
function sets the WM_TRANSIENT_FOR property of the specified window to the
specified prop_window.
_X_S_e_t_T_r_a_n_s_i_e_n_t_F_o_r_H_i_n_t
can generate
_B_a_d_A_l_l_o_c
and
_B_a_d_W_i_n_d_o_w
errors.
The
_X_G_e_t_T_r_a_n_s_i_e_n_t_F_o_r_H_i_n_t
function returns the WM_TRANSIENT_FOR property for the specified window.
It returns a nonzero status on success;
otherwise, it returns a zero status.
_X_G_e_t_T_r_a_n_s_i_e_n_t_F_o_r_H_i_n_t
can generate a
_B_a_d_W_i_n_d_o_w
error.
PROPERTIES
-
WM_TRANSIENT_FOR
-
Set by application programs to indicate to the window manager that a transient
top-level window, such as a dialog box.
DIAGNOSTICS
-
_B_a_d_A_l_l_o_c
-
The server failed to allocate the requested resource or server memory.
-
_B_a_d_W_i_n_d_o_w
-
A value for a Window argument does not name a defined Window.
SEE ALSO
XAllocClassHint(3X11),
XAllocIconSize(3X11),
XAllocSizeHints(3X11),
XAllocWMHints(3X11),
XSetCommand(3X11),
XSetTextProperty(3X11),
XSetWMClientMachine(3X11),
XSetWMColormapWindows(3X11),
XSetWMIconName(3X11),
XSetWMName(3X11),
XSetWMProperties(3X11),
XSetWMProtocols(3X11),
XStringListToTextProperty(3X11)
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e