home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xrestackwindows.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  8.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XRaiseWindow(3X11)      XLIB FUNCTIONS       XRaiseWindow(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XRaiseWindow, XLowerWindow, XCirculateSubwindows, XCircu-
  9.        lateSubwindowsUp, XCirculateSubwindowsDown, XRestackWin-
  10.        dows - change window stacking order
  11.  
  12. SSYYNNTTAAXX
  13.        XRaiseWindow(_d_i_s_p_l_a_y, _w)
  14.          Display *_d_i_s_p_l_a_y;
  15.          Window _w;
  16.  
  17.        XLowerWindow(_d_i_s_p_l_a_y, _w)
  18.          Display *_d_i_s_p_l_a_y;
  19.          Window _w;
  20.  
  21.        XCirculateSubwindows(_d_i_s_p_l_a_y, _w, _d_i_r_e_c_t_i_o_n)
  22.          Display *_d_i_s_p_l_a_y;
  23.          Window _w;
  24.          int _d_i_r_e_c_t_i_o_n;
  25.  
  26.        XCirculateSubwindowsUp(_d_i_s_p_l_a_y, _w)
  27.          Display *_d_i_s_p_l_a_y;
  28.          Window _w;
  29.  
  30.        XCirculateSubwindowsDown(_d_i_s_p_l_a_y, _w)
  31.          Display *_d_i_s_p_l_a_y;
  32.          Window _w;
  33.  
  34.        XRestackWindows(_d_i_s_p_l_a_y, _w_i_n_d_o_w_s, _n_w_i_n_d_o_w_s);
  35.          Display *_d_i_s_p_l_a_y;
  36.          Window _w_i_n_d_o_w_s[];
  37.          int _n_w_i_n_d_o_w_s;
  38.  
  39. AARRGGUUMMEENNTTSS
  40.        _d_i_r_e_c_t_i_o_n Specifies the direction (up or down) that you
  41.          want to circulate the window.    You can pass
  42.          _R_a_i_s_e_L_o_w_e_s_t or _L_o_w_e_r_H_i_g_h_e_s_t.
  43.  
  44.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  45.  
  46.        _n_w_i_n_d_o_w_s     Specifies the number of windows to be restacked.
  47.  
  48.        _w     Specifies the window.
  49.  
  50.        _w_i_n_d_o_w_s     Specifies an array containing the windows to be
  51.          restacked.
  52.  
  53. DDEESSCCRRIIPPTTIIOONN
  54.        The _X_R_a_i_s_e_W_i_n_d_o_w function raises the specified window to
  55.        the top of the stack so that no sibling window obscures
  56.        it.  If the windows are regarded as overlapping sheets of
  57.        paper stacked on a desk, then raising a window is analo-
  58.        gous to moving the sheet to the top of the stack but leav-
  59.        ing its x and y location on the desk constant.  Raising a
  60.        mapped window may generate _E_x_p_o_s_e events for the window
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XRaiseWindow(3X11)      XLIB FUNCTIONS       XRaiseWindow(3X11)
  71.  
  72.  
  73.        and any mapped subwindows that were formerly obscured.
  74.  
  75.        If the override-redirect attribute of the window is _F_a_l_s_e
  76.        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_-
  77.        _M_a_s_k on the parent, the X server generates a _C_o_n_f_i_g_u_r_-
  78.        _e_R_e_q_u_e_s_t event, and no processing is performed.    Other-
  79.        wise, the window is raised.
  80.  
  81.        _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.
  82.  
  83.        The _X_L_o_w_e_r_W_i_n_d_o_w function lowers the specified window to
  84.        the bottom of the stack so that it does not obscure any
  85.        sibling windows.     If the windows are regarded as overlap-
  86.        ping sheets of paper stacked on a desk, then lowering a
  87.        window is analogous to moving the sheet to the bottom of
  88.        the stack but leaving its x and y location on the desk
  89.        constant.  Lowering a mapped window will generate _E_x_p_o_s_e
  90.        events on any windows it formerly obscured.
  91.  
  92.        If the override-redirect attribute of the window is _F_a_l_s_e
  93.        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_-
  94.        _M_a_s_k on the parent, the X server generates a _C_o_n_f_i_g_u_r_-
  95.        _e_R_e_q_u_e_s_t event, and no processing is performed.    Other-
  96.        wise, the window is lowered to the bottom of the stack.
  97.  
  98.        _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.
  99.  
  100.        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
  101.        the specified window in the specified direction.     If you
  102.        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 low-
  103.        est mapped child (if any) that is occluded by another
  104.        child to the top of the stack.  If you specify
  105.        _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
  106.        mapped child (if any) that occludes another child to the
  107.        bottom of the stack.  Exposure processing is then per-
  108.        formed on formerly obscured windows.  If some other client
  109.        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
  110.        server generates a _C_i_r_c_u_l_a_t_e_R_e_q_u_e_s_t event, and no further
  111.        processing is performed.     If a child is actually
  112.        restacked, the X server generates a _C_i_r_c_u_l_a_t_e_N_o_t_i_f_y event.
  113.  
  114.        _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
  115.        errors.
  116.  
  117.        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
  118.        mapped child of the specified window that is partially or
  119.        completely occluded by another child.  Completely unob-
  120.        scured children are not affected.  This is a convenience
  121.        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_-
  122.        _e_s_t specified.
  123.  
  124.        _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.
  125.  
  126.        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
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XRaiseWindow(3X11)      XLIB FUNCTIONS       XRaiseWindow(3X11)
  137.  
  138.  
  139.        mapped child of the specified window that partially or
  140.        completely occludes another child.  Completely unobscured
  141.        children are not affected.  This is a convenience function
  142.        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 spec-
  143.        ified.
  144.  
  145.        _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.
  146.  
  147.        The _X_R_e_s_t_a_c_k_W_i_n_d_o_w_s function restacks the windows in the
  148.        order specified, from top to bottom.  The stacking order
  149.        of the first window in the windows array is unaffected,
  150.        but the other windows in the array are stacked underneath
  151.        the first window, in the order of the array.  The stacking
  152.        order of the other windows is not affected.  For each win-
  153.        dow in the window array that is not a child of the speci-
  154.        fied window, a _B_a_d_M_a_t_c_h error results.
  155.  
  156.        If the override-redirect attribute of a window is _F_a_l_s_e
  157.        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_-
  158.        _M_a_s_k on the parent, the X server generates _C_o_n_f_i_g_u_r_-
  159.        _e_R_e_q_u_e_s_t events for each window whose override-redirect
  160.        flag is not set, and no further processing is performed.
  161.        Otherwise, the windows will be restacked in top-to-bottom
  162.        order.
  163.  
  164.        _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.
  165.  
  166. DDIIAAGGNNOOSSTTIICCSS
  167.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  168.          values accepted by the request.  Unless a spe-
  169.          cific range is specified for an argument, the
  170.          full range defined by the argument's type is
  171.          accepted.  Any argument defined as a set of
  172.          alternatives can generate this error.
  173.  
  174.        _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  175.          defined Window.
  176.  
  177. SSEEEE AALLSSOO
  178.        XChangeWindowAttributes(3X11), XConfigureWindow(3X11),
  179.        XCreateWindow(3X11), XDestroyWindow(3X11), XMapWin-
  180.        dow(3X11), XUnmapWindow(3X11)
  181.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.