home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtmakegeometryrequest.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  4.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XtMakeGeometryRequest(3Xt) XT FUNCTIONSXtMakeGeometryRequest(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtMakeGeometryRequest, XtMakeResizeRequest - make geometry
  9.        manager request
  10.  
  11. SSYYNNTTAAXX
  12.        XtGeometryResult XtMakeGeometryRequest(_w, _r_e_q_u_e_s_t,
  13.        _r_e_p_l_y___r_e_t_u_r_n)
  14.          Widget _w;
  15.          XtWidgetGeometry *_r_e_q_u_e_s_t;
  16.          XtWidgetGeometry *_r_e_p_l_y___r_e_t_u_r_n;
  17.  
  18.        XtGeometryResult XtMakeResizeRequest(_w, _w_i_d_t_h, _h_e_i_g_h_t,
  19.        _w_i_d_t_h___r_e_t_u_r_n, _h_e_i_g_h_t___r_e_t_u_r_n)
  20.          Widget _w;
  21.          Dimension _w_i_d_t_h, _h_e_i_g_h_t;
  22.          Dimension *_w_i_d_t_h___r_e_t_u_r_n, *_h_e_i_g_h_t___r_e_t_u_r_n
  23.  
  24. AARRGGUUMMEENNTTSS
  25.        _r_e_p_l_y___r_e_t_u_r_n
  26.          Returns the allowed widget size or may be NULL
  27.          if the requesting widget is not interested in
  28.          handling _X_t_G_e_o_m_e_t_r_y_A_l_m_o_s_t.
  29.  
  30.        _r_e_q_u_e_s_t     Specifies the desired widget geometry (size,
  31.          position, border width, and stacking order).
  32.  
  33.        _w     Specifies the widget that is making the request.
  34.  
  35.        _w_i_d_t_h___r_e_t_u_r_n
  36.        _h_e_i_g_h_t___r_e_t_u_r_n
  37.          Return the allowed widget width and height.
  38.  
  39. DDEESSCCRRIIPPTTIIOONN
  40.        Depending on the condition, _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t performs
  41.        the following:
  42.  
  43.        +o    If the widget is unmanaged or the widget's parent is
  44.         not realized, it makes the changes and returns
  45.         _X_t_G_e_o_m_e_t_r_y_Y_e_s.
  46.  
  47.        +o    If the parent is not a subclass of _c_o_m_p_o_s_i_t_e_W_i_d_g_e_t_-
  48.         _C_l_a_s_s or the parent's geometry_manager is NULL, it
  49.         issues an error.
  50.  
  51.        +o    If the widget's being_destroyed field is _T_r_u_e, it
  52.         returns _X_t_G_e_o_m_e_t_r_y_N_o.
  53.  
  54.        +o    If the widget x, y, width, height and border_width
  55.         fields are all equal to the requested values, it
  56.         returns _X_t_G_e_o_m_e_t_r_y_Y_e_s; otherwise, it calls the par-
  57.         ent's geometry_manager procedure with the given
  58.         parameters.
  59.  
  60.        +o    If the parent's geometry manager returns
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtMakeGeometryRequest(3Xt) XT FUNCTIONSXtMakeGeometryRequest(3Xt)
  71.  
  72.  
  73.         _X_t_G_e_o_m_e_t_r_y_Y_e_s and if _X_t_C_W_Q_u_e_r_y_O_n_l_y is not set in the
  74.         request_mode and if the widget is realized, _X_t_M_a_k_e_-
  75.         _G_e_o_m_e_t_r_y_R_e_q_u_e_s_t calls the _X_C_o_n_f_i_g_u_r_e_W_i_n_d_o_w Xlib func-
  76.         tion to reconfigure the widget's window (set its
  77.         size, location, and stacking order as appropriate).
  78.  
  79.        +o    If the geometry manager returns _X_t_G_e_o_m_e_t_r_y_D_o_n_e, the
  80.         change has been approved and actually has been done.
  81.         In this case, _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t does no configur-
  82.         ing and returns _X_t_G_e_o_m_e_t_r_y_Y_e_s.  _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t
  83.         never returns _X_t_G_e_o_m_e_t_r_y_D_o_n_e.
  84.  
  85.        Otherwise, _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t returns the resulting
  86.        value from the parent's geometry manager.
  87.  
  88.        Children of primitive widgets are always unmanaged; thus,
  89.        _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t always returns _X_t_G_e_o_m_e_t_r_y_Y_e_s when
  90.        called by a child of a primitive widget.
  91.  
  92.        The _X_t_M_a_k_e_R_e_s_i_z_e_R_e_q_u_e_s_t function, a simple interface to
  93.        _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t, creates a _X_t_W_i_d_g_e_t_G_e_o_m_e_t_r_y struc-
  94.        ture and specifies that width and height should change.
  95.        The geometry manager is free to modify any of the other
  96.        window attributes (position or stacking order) to satisfy
  97.        the resize request.  If the return value is
  98.        _X_t_G_e_o_m_e_t_r_y_A_l_m_o_s_t, width_return and height_return contain a
  99.        compromise width and height.  If these are acceptable, the
  100.        widget should immediately make an _X_t_M_a_k_e_R_e_s_i_z_e_R_e_q_u_e_s_t and
  101.        request that the compromise width and height be applied.
  102.        If the widget is not interested in _X_t_G_e_o_m_e_t_r_y_A_l_m_o_s_t
  103.        replies, it can pass NULL for width_return and
  104.        height_return.
  105.  
  106. SSEEEE AALLSSOO
  107.        XtConfigureWidget(3Xt), XtQueryGeometery(3Xt)
  108.        _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s _- _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  109.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.