home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtcallbackpopdown.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XtPopdown(3Xt)           XT FUNCTIONS           XtPopdown(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtPopdown, XtCallbackPopdown - unmap a pop-up
  9.  
  10. SSYYNNTTAAXX
  11.        void XtPopdown(_p_o_p_u_p___s_h_e_l_l)
  12.          Widget _p_o_p_u_p___s_h_e_l_l;
  13.  
  14.        void XtCallbackPopdown(_w, _c_l_i_e_n_t___d_a_t_a, _c_a_l_l___d_a_t_a)
  15.          Widget _w;
  16.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  17.          XtPointer _c_a_l_l___d_a_t_a;
  18.  
  19.        void MenuPopdown(_s_h_e_l_l___n_a_m_e)
  20.          String _s_h_e_l_l___n_a_m_e;
  21.  
  22. AARRGGUUMMEENNTTSS
  23.        _c_a_l_l___d_a_t_a Specifies the callback data, which is not used
  24.          by this procedure.
  25.  
  26.        _c_l_i_e_n_t___d_a_t_a
  27.          Specifies a pointer to the _X_t_P_o_p_d_o_w_n_I_D struc-
  28.          ture.
  29.  
  30.        _p_o_p_u_p___s_h_e_l_l
  31.          Specifies the widget shell to pop down.
  32.  
  33.        _s_h_e_l_l___n_a_m_e
  34.          Specifies the name of the widget shell to pop
  35.          down.
  36.  
  37.        _w     Specifies the widget.
  38.  
  39. DDEESSCCRRIIPPTTIIOONN
  40.        The _X_t_P_o_p_d_o_w_n function performs the following:
  41.  
  42.        +o    Calls _X_t_C_h_e_c_k_S_u_b_c_l_a_s_s to ensure popup_shell is a sub-
  43.         class of _S_h_e_l_l.
  44.  
  45.        +o    Checks that popup_shell is currently popped_up; oth-
  46.         erwise, it generates an error.
  47.  
  48.        +o    Unmaps popup_shell's window.
  49.  
  50.        +o    If popup_shell's grab_kind is either _X_t_G_r_a_b_N_o_n_e_x_c_l_u_-
  51.         _s_i_v_e or _X_t_G_r_a_b_E_x_c_l_u_s_i_v_e, it calls _X_t_R_e_m_o_v_e_G_r_a_b.
  52.  
  53.        +o    Sets pop-up shell's popped_up field to _F_a_l_s_e.
  54.  
  55.        +o    Calls the callback procedures on the shell's pop-
  56.         down_callback list.
  57.  
  58.        The _X_t_C_a_l_l_b_a_c_k_P_o_p_d_o_w_n function casts the client data
  59.        parameter to an _X_t_P_o_p_d_o_w_n_I_D pointer:
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtPopdown(3Xt)           XT FUNCTIONS           XtPopdown(3Xt)
  71.  
  72.  
  73.        typedef struct {
  74.         Widget shell_widget;
  75.         Widget enable_widget;
  76.        } XtPopdownIDRec, *XtPopdownID;
  77. The shell_widget is the pop-up shell to pop down, and the
  78. enable_widget is the widget that was used to pop it up.
  79.  
  80.        _X_t_C_a_l_l_b_a_c_k_P_o_p_d_o_w_n calls _X_t_P_o_p_d_o_w_n with the specified
  81.        shell_widget and then calls _X_t_S_e_t_S_e_n_s_i_t_i_v_e to resensitize
  82.        the enable_widget.
  83.  
  84.        If a shell name is not given, _M_e_n_u_P_o_p_d_o_w_n calls _X_t_P_o_p_d_o_w_n
  85.        with the widget for which the translation is specified.
  86.        If a shell_name is specified in the translation table,
  87.        _M_e_n_u_P_o_p_d_o_w_n tries to find the shell by looking up the wid-
  88.        get tree starting at the parent of the widget in which it
  89.        is invoked.  If it finds a shell with the specified name
  90.        in the pop-up children of that parent, it pops down the
  91.        shell; otherwise, it moves up the parent chain as needed.
  92.        If _M_e_n_u_P_o_p_d_o_w_n gets to the application top-level shell
  93.        widget and cannot find a matching shell, it generates an
  94.        error.
  95.  
  96. SSEEEE AALLSSOO
  97.        XtCreatePopupShell(3Xt), XtPopup(3Xt)
  98.        _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
  99.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.