home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xiconifywindow.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XIconifyWindow(3X11)      XLIB FUNCTIONS     XIconifyWindow(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XIconifyWindow, XWithdrawWindow, XReconfigureWMWindow -
  9.        manipulate top-level windows
  10.  
  11. SSYYNNTTAAXX
  12.        Status XIconifyWindow(_d_i_s_p_l_a_y, _w, _s_c_r_e_e_n___n_u_m_b_e_r)
  13.          Display *_d_i_s_p_l_a_y;
  14.          Window _w;
  15.          int _s_c_r_e_e_n___n_u_m_b_e_r;
  16.  
  17.        Status XWithdrawWindow(_d_i_s_p_l_a_y, _w, _s_c_r_e_e_n___n_u_m_b_e_r)
  18.          Display *_d_i_s_p_l_a_y;
  19.          Window _w;
  20.          int _s_c_r_e_e_n___n_u_m_b_e_r;
  21.  
  22.        Status XReconfigureWMWindow(_d_i_s_p_l_a_y, _w, _s_c_r_e_e_n___n_u_m_b_e_r,
  23.        _v_a_l_u_e___m_a_s_k, _v_a_l_u_e_s)
  24.          Display *_d_i_s_p_l_a_y;
  25.          Window _w;
  26.          int _s_c_r_e_e_n___n_u_m_b_e_r;
  27.          unsigned int _v_a_l_u_e___m_a_s_k;
  28.          XWindowChanges *_v_a_l_u_e_s;
  29.  
  30. AARRGGUUMMEENNTTSS
  31.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  32.  
  33.        _s_c_r_e_e_n___n_u_m_b_e_r
  34.          Specifies the appropriate screen number on the
  35.          host server.
  36.  
  37.        _v_a_l_u_e___m_a_s_k
  38.          Specifies which values are to be set using
  39.          information in the values structure.  This mask
  40.          is the bitwise inclusive OR of the valid config-
  41.          ure window values bits.
  42.  
  43.        _v_a_l_u_e_s     Specifies the _X_W_i_n_d_o_w_C_h_a_n_g_e_s structure.
  44.  
  45.        _w     Specifies the window.
  46.  
  47. DDEESSCCRRIIPPTTIIOONN
  48.        The _X_I_c_o_n_i_f_y_W_i_n_d_o_w function sends a WM_CHANGE_STATE
  49.        _C_l_i_e_n_t_M_e_s_s_a_g_e event with a format of 32 and a first data
  50.        element of _I_c_o_n_i_c_S_t_a_t_e (as described in section 4.1.4 of
  51.        the _I_n_t_e_r_-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l) and a
  52.        window of w to the root window of the specified screen
  53.        with an event mask set to _S_u_b_s_t_r_u_c_t_u_r_e_N_o_t_i_f_y_M_a_s_k|
  54.        _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k.  Window managers may elect to
  55.        receive this message and if the window is in its normal
  56.        state, may treat it as a request to change the window's
  57.        state from normal to iconic.  If the WM_CHANGE_STATE prop-
  58.        erty cannot be interned, _X_I_c_o_n_i_f_y_W_i_n_d_o_w does not send a
  59.        message and returns a zero status.  It returns a nonzero
  60.        status if the client message is sent successfully;
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XIconifyWindow(3X11)      XLIB FUNCTIONS     XIconifyWindow(3X11)
  71.  
  72.  
  73.        otherwise, it returns a zero status.
  74.  
  75.        The _X_W_i_t_h_d_r_a_w_W_i_n_d_o_w function unmaps the specified window
  76.        and sends a synthetic _U_n_m_a_p_N_o_t_i_f_y event to the root window
  77.        of the specified screen.     Window managers may elect to
  78.        receive this message and may treat it as a request to
  79.        change the window's state to withdrawn.    When a window is
  80.        in the withdrawn state, neither its normal nor its iconic
  81.        representations is visible.  It returns a nonzero status
  82.        if the _U_n_m_a_p_N_o_t_i_f_y event is successfully sent; otherwise,
  83.        it returns a zero status.
  84.  
  85.        _X_W_i_t_h_d_r_a_w_W_i_n_d_o_w can generate a _B_a_d_W_i_n_d_o_w error.
  86.  
  87.        The _X_R_e_c_o_n_f_i_g_u_r_e_W_M_W_i_n_d_o_w function issues a _C_o_n_f_i_g_u_r_e_W_i_n_d_o_w
  88.        request on the specified top-level window.  If the stack-
  89.        ing mode is changed and the request fails with a _B_a_d_M_a_t_c_h
  90.        error, the error is trapped by Xlib and a synthetic _C_o_n_-
  91.        _f_i_g_u_r_e_R_e_q_u_e_s_t_E_v_e_n_t containing the same configuration
  92.        parameters is sent to the root of the specified window.
  93.        Window managers may elect to receive this event and treat
  94.        it as a request to reconfigure the indicated window.  It
  95.        returns a nonzero status if the request or event is suc-
  96.        cessfully sent; otherwise, it returns a zero status.
  97.  
  98.        _X_R_e_c_o_n_f_i_g_u_r_e_W_M_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
  99.        errors.
  100.  
  101. DDIIAAGGNNOOSSTTIICCSS
  102.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  103.          values accepted by the request.  Unless a spe-
  104.          cific range is specified for an argument, the
  105.          full range defined by the argument's type is
  106.          accepted.  Any argument defined as a set of
  107.          alternatives can generate this error.
  108.  
  109.        _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  110.          defined Window.
  111.  
  112. SSEEEE AALLSSOO
  113.        XChangeWindowAttributes(3X11), XConfigureWindow(3X11),
  114.        XCreateWindow(3X11), XDestroyWindow(3X11), XRaiseWin-
  115.        dow(3X11), XMapWindow(3X11), XUnmapWindow(3X11)
  116.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.