home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xsetwindowbackground.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  10.5 KB  |  265 lines
  1.  
  2.  
  3.  
  4. XChangeWindowAttributes(3X1X1L)IB FUNCTIXOCNhSangeWindowAttributes(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XChangeWindowAttributes, XSetWindowBackground, XSetWindow-
  9.        BackgroundPixmap, XSetWindowBorder, XSetWindowBorder-
  10.        Pixmap, XSetWindowColormap - change window attributes
  11.  
  12. SSYYNNTTAAXX
  13.        XChangeWindowAttributes(_d_i_s_p_l_a_y, _w, _v_a_l_u_e_m_a_s_k, _a_t_t_r_i_b_u_t_e_s)
  14.          Display *_d_i_s_p_l_a_y;
  15.          Window _w;
  16.          unsigned long _v_a_l_u_e_m_a_s_k;
  17.          XSetWindowAttributes *_a_t_t_r_i_b_u_t_e_s;
  18.  
  19.        XSetWindowBackground(_d_i_s_p_l_a_y, _w, _b_a_c_k_g_r_o_u_n_d___p_i_x_e_l)
  20.          Display *_d_i_s_p_l_a_y;
  21.          Window _w;
  22.          unsigned long _b_a_c_k_g_r_o_u_n_d___p_i_x_e_l;
  23.  
  24.        XSetWindowBackgroundPixmap(_d_i_s_p_l_a_y, _w, _b_a_c_k_g_r_o_u_n_d___p_i_x_m_a_p)
  25.          Display *_d_i_s_p_l_a_y;
  26.          Window _w;
  27.          Pixmap _b_a_c_k_g_r_o_u_n_d___p_i_x_m_a_p;
  28.  
  29.        XSetWindowBorder(_d_i_s_p_l_a_y, _w, _b_o_r_d_e_r___p_i_x_e_l)
  30.          Display *_d_i_s_p_l_a_y;
  31.          Window _w;
  32.          unsigned long _b_o_r_d_e_r___p_i_x_e_l;
  33.  
  34.        XSetWindowBorderPixmap(_d_i_s_p_l_a_y, _w, _b_o_r_d_e_r___p_i_x_m_a_p)
  35.          Display *_d_i_s_p_l_a_y;
  36.          Window _w;
  37.          Pixmap _b_o_r_d_e_r___p_i_x_m_a_p;
  38.  
  39.        XSetWindowColormap(_d_i_s_p_l_a_y, _w, _c_o_l_o_r_m_a_p)
  40.          Display *_d_i_s_p_l_a_y;
  41.          Window _w;
  42.          Colormap _c_o_l_o_r_m_a_p;
  43.  
  44. AARRGGUUMMEENNTTSS
  45.        _a_t_t_r_i_b_u_t_e_s
  46.          Specifies the structure from which the values
  47.          (as specified by the value mask) are to be
  48.          taken.     The value mask should have the appropri-
  49.          ate bits set to indicate which attributes have
  50.          been set in the structure.
  51.  
  52.        _b_a_c_k_g_r_o_u_n_d___p_i_x_e_l
  53.          Specifies the pixel that is to be used for the
  54.          background.
  55.  
  56.        _b_a_c_k_g_r_o_u_n_d___p_i_x_m_a_p
  57.          Specifies the background pixmap, _P_a_r_e_n_t_R_e_l_a_t_i_v_e,
  58.          or _N_o_n_e.
  59.  
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XChangeWindowAttributes(3X1X1L)IB FUNCTIXOCNhSangeWindowAttributes(3X11)
  71.  
  72.  
  73.        _b_o_r_d_e_r___p_i_x_e_l
  74.          Specifies the entry in the colormap.
  75.  
  76.        _b_o_r_d_e_r___p_i_x_m_a_p
  77.          Specifies the border pixmap or _C_o_p_y_F_r_o_m_P_a_r_e_n_t.
  78.  
  79.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  80.  
  81.        _v_a_l_u_e_m_a_s_k Specifies which window attributes are defined in
  82.          the attributes argument.  This mask is the bit-
  83.          wise inclusive OR of the valid attribute mask
  84.          bits.    If valuemask is zero, the attributes are
  85.          ignored and are not referenced.
  86.  
  87.        _w     Specifies the window.
  88.  
  89.        _c_o_l_o_r_m_a_p     Specifies the colormap.
  90.  
  91. DDEESSCCRRIIPPTTIIOONN
  92.        Depending on the valuemask, the _X_C_h_a_n_g_e_W_i_n_d_o_w_A_t_t_r_i_b_u_t_e_s
  93.        function uses the window attributes in the _X_S_e_t_W_i_n_d_o_w_A_t_-
  94.        _t_r_i_b_u_t_e_s structure to change the specified window
  95.        attributes.  Changing the background does not cause the
  96.        window contents to be changed.  To repaint the window and
  97.        its background, use _X_C_l_e_a_r_W_i_n_d_o_w.  Setting the border or
  98.        changing the background such that the border tile origin
  99.        changes causes the border to be repainted.  Changing the
  100.        background of a root window to _N_o_n_e or _P_a_r_e_n_t_R_e_l_a_t_i_v_e
  101.        restores the default background pixmap.    Changing the bor-
  102.        der of a root window to _C_o_p_y_F_r_o_m_P_a_r_e_n_t restores the
  103.        default border pixmap.  Changing the win-gravity does not
  104.        affect the current position of the window.  Changing the
  105.        backing-store of an obscured window to _W_h_e_n_M_a_p_p_e_d or
  106.        _A_l_w_a_y_s, or changing the backing-planes, backing-pixel, or
  107.        save-under of a mapped window may have no immediate
  108.        effect.    Changing the colormap of a window (that is,
  109.        defining a new map, not changing the contents of the
  110.        existing map) generates a _C_o_l_o_r_m_a_p_N_o_t_i_f_y event.    Changing
  111.        the colormap of a visible window may have no immediate
  112.        effect on the screen because the map may not be installed
  113.        (see _X_I_n_s_t_a_l_l_C_o_l_o_r_m_a_p).    Changing the cursor of a root
  114.        window to _N_o_n_e restores the default cursor.  Whenever pos-
  115.        sible, you are encouraged to share colormaps.
  116.  
  117.        Multiple clients can select input on the same window.
  118.        Their event masks are maintained separately.  When an
  119.        event is generated, it is reported to all interested
  120.        clients.     However, only one client at a time can select
  121.        for _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k, _R_e_s_i_z_e_R_e_d_i_r_e_c_t_M_a_s_k, and
  122.        _B_u_t_t_o_n_P_r_e_s_s_M_a_s_k.     If a client attempts to select any of
  123.        these event masks and some other client has already
  124.        selected one, a _B_a_d_A_c_c_e_s_s error results.     There is only
  125.        one do-not-propagate-mask for a window, not one per
  126.        client.
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XChangeWindowAttributes(3X1X1L)IB FUNCTIXOCNhSangeWindowAttributes(3X11)
  137.  
  138.  
  139.        _X_C_h_a_n_g_e_W_i_n_d_o_w_A_t_t_r_i_b_u_t_e_s can generate _B_a_d_A_c_c_e_s_s, _B_a_d_C_o_l_o_r,
  140.        _B_a_d_C_u_r_s_o_r, _B_a_d_M_a_t_c_h, _B_a_d_P_i_x_m_a_p, _B_a_d_V_a_l_u_e, and _B_a_d_W_i_n_d_o_w
  141.        errors.
  142.  
  143.        The _X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d function sets the background of
  144.        the window to the specified pixel value.     Changing the
  145.        background does not cause the window contents to be
  146.        changed.     _X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d uses a pixmap of undefined
  147.        size filled with the pixel value you passed.  If you try
  148.        to change the background of an _I_n_p_u_t_O_n_l_y window, a _B_a_d_-
  149.        _M_a_t_c_h error results.
  150.  
  151.        _X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d can generate _B_a_d_M_a_t_c_h and _B_a_d_W_i_n_d_o_w
  152.        errors.
  153.  
  154.        The _X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d_P_i_x_m_a_p function sets the back-
  155.        ground pixmap of the window to the specified pixmap.  The
  156.        background pixmap can immediately be freed if no further
  157.        explicit references to it are to be made.  If _P_a_r_e_n_t_R_e_l_a_-
  158.        _t_i_v_e is specified, the background pixmap of the window's
  159.        parent is used, or on the root window, the default back-
  160.        ground is restored.  If you try to change the background
  161.        of an _I_n_p_u_t_O_n_l_y window, a _B_a_d_M_a_t_c_h error results.  If the
  162.        background is set to _N_o_n_e, the window has no defined back-
  163.        ground.
  164.  
  165.        _X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d_P_i_x_m_a_p can generate _B_a_d_M_a_t_c_h,
  166.        _B_a_d_P_i_x_m_a_p, and _B_a_d_W_i_n_d_o_w errors.
  167.  
  168.        The _X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r function sets the border of the win-
  169.        dow to the pixel value you specify.  If you attempt to
  170.        perform this on an _I_n_p_u_t_O_n_l_y window, a _B_a_d_M_a_t_c_h error
  171.        results.
  172.  
  173.        _X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r can generate _B_a_d_M_a_t_c_h and _B_a_d_W_i_n_d_o_w
  174.        errors.
  175.  
  176.        The _X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r_P_i_x_m_a_p function sets the border pixmap
  177.        of the window to the pixmap you specify.     The border
  178.        pixmap can be freed immediately if no further explicit
  179.        references to it are to be made.     If you specify
  180.        _C_o_p_y_F_r_o_m_P_a_r_e_n_t, a copy of the parent window's border
  181.        pixmap is used.    If you attempt to perform this on an
  182.        _I_n_p_u_t_O_n_l_y window, a _B_a_d_M_a_t_c_h error results.
  183.  
  184.        _X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r_P_i_x_m_a_p can generate _B_a_d_M_a_t_c_h, _B_a_d_P_i_x_m_a_p,
  185.        and _B_a_d_W_i_n_d_o_w errors.
  186.  
  187.        The _X_S_e_t_W_i_n_d_o_w_C_o_l_o_r_m_a_p function sets the specified col-
  188.        ormap of the specified window.  The colormap must have the
  189.        same visual type as the window, or a _B_a_d_M_a_t_c_h error
  190.        results.
  191.  
  192.        _X_S_e_t_W_i_n_d_o_w_C_o_l_o_r_m_a_p can generate _B_a_d_C_o_l_o_r, _B_a_d_M_a_t_c_h, and
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XChangeWindowAttributes(3X1X1L)IB FUNCTIXOCNhSangeWindowAttributes(3X11)
  203.  
  204.  
  205.        _B_a_d_W_i_n_d_o_w errors.
  206.  
  207. DDIIAAGGNNOOSSTTIICCSS
  208.        _B_a_d_A_c_c_e_s_s A client attempted to free a color map entry
  209.          that it did not already allocate.
  210.  
  211.        _B_a_d_A_c_c_e_s_s A client attempted to store into a read-only
  212.          color map entry.
  213.  
  214.        _B_a_d_C_o_l_o_r     A value for a Colormap argument does not name a
  215.          defined Colormap.
  216.  
  217.        _B_a_d_C_u_r_s_o_r A value for a Cursor argument does not name a
  218.          defined Cursor.
  219.  
  220.        _B_a_d_M_a_t_c_h     Some argument or pair of arguments has the cor-
  221.          rect type and range but fails to match in some
  222.          other way required by the request.
  223.  
  224.        _B_a_d_M_a_t_c_h     An _I_n_p_u_t_O_n_l_y window locks this attribute.
  225.  
  226.        _B_a_d_P_i_x_m_a_p A value for a Pixmap argument does not name a
  227.          defined Pixmap.
  228.  
  229.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  230.          values accepted by the request.  Unless a spe-
  231.          cific range is specified for an argument, the
  232.          full range defined by the argument's type is
  233.          accepted.  Any argument defined as a set of
  234.          alternatives can generate this error.
  235.  
  236.        _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  237.          defined Window.
  238.  
  239. SSEEEE AALLSSOO
  240.        XConfigureWindow(3X11), XCreateWindow(3X11), XDestroyWin-
  241.        dow(3X11), XInstallColormap(3X11), XMapWindow(3X11),
  242.        XRaiseWindow(3X11), XUnmapWindow(3X11)
  243.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  244.  
  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.