XRaiseWindow(3X11) AIX (XLIB FUNCTIONS) XRaiseWindow(3X11) NAME XRaiseWindow, XLowerWindow, XCirculateSubwindows, XCircula- teSubwindowsUp, XCirculateSubwindowsDown, XRestackWindows - change window stacking order SYNTAX XRaiseWindow(_d_i_s_p_l_a_y, _w) Display *_d_i_s_p_l_a_y; Window _w; XLowerWindow(_d_i_s_p_l_a_y, _w) Display *_d_i_s_p_l_a_y; Window _w; XCirculateSubwindows(_d_i_s_p_l_a_y, _w, _d_i_r_e_c_t_i_o_n) Display *_d_i_s_p_l_a_y; Window _w; int _d_i_r_e_c_t_i_o_n; XCirculateSubwindowsUp(_d_i_s_p_l_a_y, _w) Display *_d_i_s_p_l_a_y; Window _w; XCirculateSubwindowsDown(_d_i_s_p_l_a_y, _w) Display *_d_i_s_p_l_a_y; Window _w; XRestackWindows(_d_i_s_p_l_a_y, _w_i_n_d_o_w_s, _n_w_i_n_d_o_w_s); Display *_d_i_s_p_l_a_y; Window _w_i_n_d_o_w_s[]; int _n_w_i_n_d_o_w_s; ARGUMENTS _d_i_r_e_c_t_i_o_n Specifies the direction (up or down) that you want to circulate the window. You can pass _R_a_i_s_e_L_o_w_e_s_t or _L_o_w_e_r_H_i_g_h_e_s_t. _d_i_s_p_l_a_y Specifies the connection to the X server. _n_w_i_n_d_o_w_s Specifies the number of windows to be restacked. _w Specifies the window. _w_i_n_d_o_w_s Specifies an array containing the windows to be restacked. DESCRIPTION The _X_R_a_i_s_e_W_i_n_d_o_w function raises the specified window to the top of the stack so that no sibling window obscures it. If the windows are regarded as overlapping sheets of paper stacked on a desk, then raising a window is analogous to moving the sheet to the top of the stack but leaving its x and y location on the desk constant. Raising a mapped Rev. Release 5 Page 1 XRaiseWindow(3X11) AIX (XLIB FUNCTIONS) XRaiseWindow(3X11) window may generate _E_x_p_o_s_e events for the window and any mapped subwindows that were formerly obscured. If the override-redirect attribute of the window is _F_a_l_s_e and some other client has selected _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k on the parent, the X server generates a _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t event, and no processing is performed. Otherwise, the win- dow is raised. _X_R_a_i_s_e_W_i_n_d_o_w can generate a _B_a_d_W_i_n_d_o_w error. The _X_L_o_w_e_r_W_i_n_d_o_w function lowers the specified window to the bottom of the stack so that it does not obscure any sibling windows. If the windows are regarded as overlapping sheets of paper stacked on a desk, then lowering a window is analo- gous to moving the sheet to the bottom of the stack but leaving its x and y location on the desk constant. Lowering a mapped window will generate _E_x_p_o_s_e events on any windows it formerly obscured. If the override-redirect attribute of the window is _F_a_l_s_e and some other client has selected _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k on the parent, the X server generates a _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t event, and no processing is performed. Otherwise, the window is lowered to the bottom of the stack. _X_L_o_w_e_r_W_i_n_d_o_w can generate a _B_a_d_W_i_n_d_o_w error. The _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s function circulates children of the specified window in the specified direction. If you specify _R_a_i_s_e_L_o_w_e_s_t, _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s raises the lowest mapped child (if any) that is occluded by another child to the top of the stack. If you specify _L_o_w_e_r_H_i_g_h_e_s_t, _X_C_i_r_c_u_l_a_- _t_e_S_u_b_w_i_n_d_o_w_s lowers the highest mapped child (if any) that occludes another child to the bottom of the stack. Exposure processing is then performed on formerly obscured windows. If some other client has selected _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k on the window, the X server generates a _C_i_r_c_u_l_a_t_e_R_e_q_u_e_s_t event, and no further processing is performed. If a child is actually restacked, the X server generates a _C_i_r_c_u_l_a_t_e_N_o_- _t_i_f_y event. _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s can generate _B_a_d_V_a_l_u_e and _B_a_d_W_i_n_d_o_w errors. The _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s_U_p function raises the lowest mapped child of the specified window that is partially or com- pletely occluded by another child. Completely unobscured children are not affected. This is a convenience function equivalent to _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s with _R_a_i_s_e_L_o_w_e_s_t speci- fied. _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s_U_p can generate a _B_a_d_W_i_n_d_o_w error. Rev. Release 5 Page 2 XRaiseWindow(3X11) AIX (XLIB FUNCTIONS) XRaiseWindow(3X11) The _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s_D_o_w_n function lowers the highest mapped child of the specified window that partially or com- pletely occludes another child. Completely unobscured chil- dren are not affected. This is a convenience function equivalent to _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s with _L_o_w_e_r_H_i_g_h_e_s_t speci- fied. _X_C_i_r_c_u_l_a_t_e_S_u_b_w_i_n_d_o_w_s_D_o_w_n can generate a _B_a_d_W_i_n_d_o_w error. The _X_R_e_s_t_a_c_k_W_i_n_d_o_w_s function restacks the windows in the order specified, from top to bottom. The stacking order of the first window in the windows array is unaffected, but the other windows in the array are stacked underneath the first window, in the order of the array. The stacking order of the other windows is not affected. For each window in the window array that is not a child of the specified window, a _B_a_d_M_a_t_c_h error results. If the override-redirect attribute of a window is _F_a_l_s_e and some other client has selected _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k on the parent, the X server generates _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t events for each window whose override-redirect flag is not set, and no further processing is performed. Otherwise, the windows will be restacked in top to bottom order. _X_R_e_s_t_a_c_k_W_i_n_d_o_w_s can generate _B_a_d_W_i_n_d_o_w error. DIAGNOSTICS _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 gen- erate this error. _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a defined Window. SEE ALSO XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWindow(3X11), XDestroyWindow(3X11), XMapWindow(3X11), XUnmapWindow(3X11) _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e Rev. Release 5 Page 3