home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xwindowchanges.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  9.9 KB  |  265 lines
  1.  
  2.  
  3.  
  4. XConfigureWindow(3X11)      XLIB FUNCTIONS   XConfigureWindow(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XConfigureWindow, XMoveWindow, XResizeWindow, XMoveRe-
  9.        sizeWindow, XSetWindowBorderWidth, XWindowChanges - con-
  10.        figure windows and window changes structure
  11.  
  12. SSYYNNTTAAXX
  13.        XConfigureWindow(_d_i_s_p_l_a_y, _w, _v_a_l_u_e___m_a_s_k, _v_a_l_u_e_s)
  14.          Display *_d_i_s_p_l_a_y;
  15.          Window _w;
  16.          unsigned int _v_a_l_u_e___m_a_s_k;
  17.          XWindowChanges *_v_a_l_u_e_s;
  18.  
  19.        XMoveWindow(_d_i_s_p_l_a_y, _w, _x, _y)
  20.          Display *_d_i_s_p_l_a_y;
  21.          Window _w;
  22.          int _x, _y;
  23.  
  24.        XResizeWindow(_d_i_s_p_l_a_y, _w, _w_i_d_t_h, _h_e_i_g_h_t)
  25.          Display *_d_i_s_p_l_a_y;
  26.          Window _w;
  27.          unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  28.  
  29.        XMoveResizeWindow(_d_i_s_p_l_a_y, _w, _x, _y, _w_i_d_t_h, _h_e_i_g_h_t)
  30.          Display *_d_i_s_p_l_a_y;
  31.          Window _w;
  32.          int _x, _y;
  33.          unsigned int _w_i_d_t_h, _h_e_i_g_h_t;
  34.  
  35.        XSetWindowBorderWidth(_d_i_s_p_l_a_y, _w, _w_i_d_t_h)
  36.          Display *_d_i_s_p_l_a_y;
  37.          Window _w;
  38.          unsigned int _w_i_d_t_h;
  39.  
  40. AARRGGUUMMEENNTTSS
  41.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  42.  
  43.        _v_a_l_u_e___m_a_s_k
  44.          Specifies which values are to be set using
  45.          information in the values structure.  This mask
  46.          is the bitwise inclusive OR of the valid config-
  47.          ure window values bits.
  48.  
  49.        _v_a_l_u_e_s     Specifies the _X_W_i_n_d_o_w_C_h_a_n_g_e_s structure.
  50.  
  51.        _w     Specifies the window to be reconfigured, moved,
  52.          or resized..
  53.  
  54.        _w_i_d_t_h     Specifies the width of the window border.
  55.  
  56.        _w_i_d_t_h
  57.        _h_e_i_g_h_t     Specify the width and height, which are the
  58.          interior dimensions of the window.
  59.  
  60.        _x
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XConfigureWindow(3X11)      XLIB FUNCTIONS   XConfigureWindow(3X11)
  71.  
  72.  
  73.        _y     Specify the x and y coordinates, which define
  74.          the new location of the top-left pixel of the
  75.          window's border or the window itself if it has
  76.          no border or define the new position of the win-
  77.          dow relative to its parent.
  78.  
  79. DDEESSCCRRIIPPTTIIOONN
  80.        The _X_C_o_n_f_i_g_u_r_e_W_i_n_d_o_w function uses the values specified in
  81.        the _X_W_i_n_d_o_w_C_h_a_n_g_e_s structure to reconfigure a window's
  82.        size, position, border, and stacking order.  Values not
  83.        specified are taken from the existing geometry of the win-
  84.        dow.
  85.  
  86.        If a sibling is specified without a stack_mode or if the
  87.        window is not actually a sibling, a _B_a_d_M_a_t_c_h error
  88.        results.     Note that the computations for _B_o_t_t_o_m_I_f, _T_o_p_I_f,
  89.        and _O_p_p_o_s_i_t_e are performed with respect to the window's
  90.        final geometry (as controlled by the other arguments
  91.        passed to _X_C_o_n_f_i_g_u_r_e_W_i_n_d_o_w), not its initial geometry.
  92.        Any backing store contents of the window, its inferiors,
  93.        and other newly visible windows are either discarded or
  94.        changed to reflect the current screen contents (depending
  95.        on the implementation).
  96.  
  97.        _X_C_o_n_f_i_g_u_r_e_W_i_n_d_o_w can generate _B_a_d_M_a_t_c_h, _B_a_d_V_a_l_u_e, and _B_a_d_-
  98.        _W_i_n_d_o_w errors.
  99.  
  100.        The _X_M_o_v_e_W_i_n_d_o_w function moves the specified window to the
  101.        specified x and y coordinates, but it does not change the
  102.        window's size, raise the window, or change the mapping
  103.        state of the window.  Moving a mapped window may or may
  104.        not lose the window's contents depending on if the window
  105.        is obscured by nonchildren and if no backing store exists.
  106.        If the contents of the window are lost, the X server gen-
  107.        erates _E_x_p_o_s_e events.  Moving a mapped window generates
  108.        _E_x_p_o_s_e events on any formerly obscured windows.
  109.  
  110.        If the override-redirect flag of the window is _F_a_l_s_e and
  111.        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
  112.        the parent, the X server generates a _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t
  113.        event, and no further processing is performed.  Otherwise,
  114.        the window is moved.
  115.  
  116.        _X_M_o_v_e_W_i_n_d_o_w can generate a _B_a_d_W_i_n_d_o_w error.
  117.  
  118.        The _X_R_e_s_i_z_e_W_i_n_d_o_w function changes the inside dimensions
  119.        of the specified window, not including its borders.  This
  120.        function does not change the window's upper-left coordi-
  121.        nate or the origin and does not restack the window.
  122.        Changing the size of a mapped window may lose its contents
  123.        and generate _E_x_p_o_s_e events.  If a mapped window is made
  124.        smaller, changing its size generates _E_x_p_o_s_e events on win-
  125.        dows that the mapped window formerly obscured.
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XConfigureWindow(3X11)      XLIB FUNCTIONS   XConfigureWindow(3X11)
  137.  
  138.  
  139.        If the override-redirect flag of the window is _F_a_l_s_e and
  140.        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
  141.        the parent, the X server generates a _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t
  142.        event, and no further processing is performed.  If either
  143.        width or height is zero, a _B_a_d_V_a_l_u_e error results.
  144.  
  145.        _X_R_e_s_i_z_e_W_i_n_d_o_w can generate _B_a_d_V_a_l_u_e and _B_a_d_W_i_n_d_o_w errors.
  146.  
  147.        The _X_M_o_v_e_R_e_s_i_z_e_W_i_n_d_o_w function changes the size and loca-
  148.        tion of the specified window without raising it.     Moving
  149.        and resizing a mapped window may generate an _E_x_p_o_s_e event
  150.        on the window.  Depending on the new size and location
  151.        parameters, moving and resizing a window may generate
  152.        _E_x_p_o_s_e events on windows that the window formerly
  153.        obscured.
  154.  
  155.        If the override-redirect flag of the window is _F_a_l_s_e and
  156.        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
  157.        the parent, the X server generates a _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t
  158.        event, and no further processing is performed.  Otherwise,
  159.        the window size and location are changed.
  160.  
  161.        _X_M_o_v_e_R_e_s_i_z_e_W_i_n_d_o_w can generate _B_a_d_V_a_l_u_e and _B_a_d_W_i_n_d_o_w
  162.        errors.
  163.  
  164.        The _X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r_W_i_d_t_h function sets the specified win-
  165.        dow's border width to the specified width.
  166.  
  167.        _X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r_W_i_d_t_h can generate a _B_a_d_W_i_n_d_o_w error.
  168.  
  169. SSTTRRUUCCTTUURREESS
  170.        The _X_W_i_n_d_o_w_C_h_a_n_g_e_s structure contains:
  171.  
  172.  
  173.        /* Configure window value mask bits */
  174.        #define     _C_W_X                 (1<<0)
  175.        #define     _C_W_Y                 (1<<1)
  176.        #define     _C_W_W_i_d_t_h             (1<<2)
  177.        #define     _C_W_H_e_i_g_h_t             (1<<3)
  178.        #define     _C_W_B_o_r_d_e_r_W_i_d_t_h             (1<<4)
  179.        #define     _C_W_S_i_b_l_i_n_g             (1<<5)
  180.        #define     _C_W_S_t_a_c_k_M_o_d_e             (1<<6)
  181.        /* Values */
  182.  
  183.        typedef struct {
  184.         int x, y;
  185.         int width, height;
  186.         int border_width;
  187.         Window sibling;
  188.         int stack_mode;
  189.        } XWindowChanges;
  190.  
  191.        The x and y members are used to set the window's x and y
  192.        coordinates, which are relative to the parent's origin and
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XConfigureWindow(3X11)      XLIB FUNCTIONS   XConfigureWindow(3X11)
  203.  
  204.  
  205.        indicate the position of the upper-left outer corner of
  206.        the window.  The width and height members are used to set
  207.        the inside size of the window, not including the border,
  208.        and must be nonzero, or a _B_a_d_V_a_l_u_e error results.
  209.        Attempts to configure a root window have no effect.
  210.  
  211.        The border_width member is used to set the width of the
  212.        border in pixels.  Note that setting just the border width
  213.        leaves the outer-left corner of the window in a fixed
  214.        position but moves the absolute position of the window's
  215.        origin.    If you attempt to set the border-width attribute
  216.        of an _I_n_p_u_t_O_n_l_y window nonzero, a _B_a_d_M_a_t_c_h error results.
  217.  
  218.        The sibling member is used to set the sibling window for
  219.        stacking operations.  The stack_mode member is used to set
  220.        how the window is to be restacked and can be set to _A_b_o_v_e,
  221.        _B_e_l_o_w, _T_o_p_I_f, _B_o_t_t_o_m_I_f, or _O_p_p_o_s_i_t_e.
  222.  
  223. DDIIAAGGNNOOSSTTIICCSS
  224.        _B_a_d_M_a_t_c_h     An _I_n_p_u_t_O_n_l_y window is used as a Drawable.
  225.  
  226.        _B_a_d_M_a_t_c_h     Some argument or pair of arguments has the cor-
  227.          rect type and range but fails to match in some
  228.          other way required by the request.
  229.  
  230.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  231.          values accepted by the request.  Unless a spe-
  232.          cific range is specified for an argument, the
  233.          full range defined by the argument's type is
  234.          accepted.  Any argument defined as a set of
  235.          alternatives can generate this error.
  236.  
  237.        _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  238.          defined Window.
  239.  
  240. SSEEEE AALLSSOO
  241.        XChangeWindowAttributes(3X11), XCreateWindow(3X11), XDe-
  242.        stroyWindow(3X11), XMapWindow(3X11), XRaiseWindow(3X11),
  243.        XUnmapWindow(3X11)
  244.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. X Version 11           Release 6.1                4
  263.  
  264.  
  265.