home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtwindowtowidget.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XtNameToWidget(3Xt)       XT FUNCTIONS          XtNameToWidget(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtNameToWidget, XtWindowToWidget - translating strings to
  9.        widgets or widgets to windows
  10.  
  11. SSYYNNTTAAXX
  12.        Widget XtNameToWidget(_r_e_f_e_r_e_n_c_e, _n_a_m_e_s);
  13.          Widget _r_e_f_e_r_e_n_c_e;
  14.          String _n_a_m_e_s;
  15.  
  16.        Widget XtWindowToWidget(_d_i_s_p_l_a_y, _w_i_n_d_o_w)
  17.          Display *_d_i_s_p_l_a_y;
  18.          Window _w_i_n_d_o_w;
  19.  
  20. AARRGGUUMMEENNTTSS
  21.        _d_i_s_p_l_a_y     Specifies the display on which the window is
  22.          defined.
  23.  
  24.        _n_a_m_e_s     Specifies the fully qualified name of the
  25.          desired widget.
  26.  
  27.        _r_e_f_e_r_e_n_c_e Specifies the widget from which the search is to
  28.          start.
  29.  
  30.        _w_i_n_d_o_w     Specify the window for which you want the wid-
  31.          get.
  32.  
  33. DDEESSCCRRIIPPTTIIOONN
  34.        The _X_t_N_a_m_e_T_o_W_i_d_g_e_t function looks for a widget whose name
  35.        is the first component in the specified names and that is
  36.        a pop-up child of reference (or a normal child if refer-
  37.        ence is a subclass of _c_o_m_p_o_s_i_t_e_W_i_d_g_e_t_C_l_a_s_s).  It then uses
  38.        that widget as the new reference and repeats the search
  39.        after deleting the first component from the specified
  40.        names.  If it cannot find the specified widget, _X_t_N_a_m_e_T_o_-
  41.        _W_i_d_g_e_t returns NULL.
  42.  
  43.        Note that the names argument contains the name of a widget
  44.        with respect to the specified reference widget and can
  45.        contain more than one widget name (separated by periods)
  46.        for widgets that are not direct children of the specified
  47.        reference widget.
  48.  
  49.        If more than one child of the reference widget matches the
  50.        name, _X_t_N_a_m_e_T_o_W_i_d_g_e_t can return any of the children.  The
  51.        Intrinsics do not require that all children of a widget
  52.        have unique names.  If the specified names contain more
  53.        than one component and if more than one child matches the
  54.        first component, _X_t_N_a_m_e_T_o_W_i_d_g_e_t can return NULL if the
  55.        single branch that it follows does not contain the named
  56.        widget.    That is, _X_t_N_a_m_e_T_o_W_i_d_g_e_t does not back up and fol-
  57.        low other matching branches of the widget tree.
  58.  
  59.        The _X_t_W_i_n_d_o_w_T_o_W_i_d_g_e_t function translates the specified
  60.        window and display pointer into the appropriate widget
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtNameToWidget(3Xt)       XT FUNCTIONS          XtNameToWidget(3Xt)
  71.  
  72.  
  73.        instance.
  74.  
  75. SSEEEE AALLSSOO
  76.        _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
  77.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  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.