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