home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cato / Xm / XmCreatePulldownMenu.z / XmCreatePulldownMenu
Encoding:
Text File  |  1998-10-20  |  7.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV  XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu - A RowColumn widget convenience
  10.           creation function
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////RRRRoooowwwwCCCCoooolllluuuummmmnnnn....hhhh>>>>
  14.  
  15.           WWWWiiiiddddggggeeeetttt XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu ((((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))))
  16.                WWWWiiiiddddggggeeeetttt    _p_a_r_e_n_t;;;;
  17.                SSSSttttrrrriiiinnnngggg    _n_a_m_e;;;;
  18.                AAAArrrrggggLLLLiiiisssstttt   _a_r_g_l_i_s_t;;;;
  19.                CCCCaaaarrrrddddiiiinnnnaaaallll  _a_r_g_c_o_u_n_t;;;;
  20.  
  21.  
  22.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  23.           This page documents version 1.2 of the Motif library.
  24.  
  25.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.           XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu creates an instance of a RowColumn
  27.           widget of type XXXXmmmmMMMMEEEENNNNUUUU____PPPPUUUULLLLLLLLDDDDOOOOWWWWNNNN and returns the associated
  28.           widget ID.  When using this function to create the Pulldown
  29.           MenuPane, a MenuShell widget is automatically created as the
  30.           parent of the MenuPane. If the widget specified by the
  31.           _p_a_r_e_n_t parameter is a Popup or a Pulldown MenuPane, the
  32.           MenuShell widget is created as a child of the _p_a_r_e_n_t's
  33.           MenuShell; otherwise, it is created as a child of the
  34.           specified _p_a_r_e_n_t widget.
  35.  
  36.           XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu is provided as a convenience function
  37.           for creating RowColumn widgets configured to operate as
  38.           Pulldown MenuPanes and is not implemented as a separate
  39.           widget class.
  40.  
  41.           A Pulldown MenuPane displays a 3-D shadow, unless the
  42.           feature is disabled by the application.  The shadow appears
  43.           around the edge of the MenuPane.
  44.  
  45.           A Pulldown MenuPane is used when creating submenus that are
  46.           to be attached to a CascadeButton or a CascadeButtonGadget.
  47.           This is the case for all MenuPanes that are part of a
  48.           PulldownMenu system (a MenuBar), the MenuPane associated
  49.           with an OptionMenu, and any MenuPanes that cascade from a
  50.           Popup MenuPane.  Pulldown MenuPanes that are to be
  51.           associated with an OptionMenu must be created before the
  52.           OptionMenu is created.
  53.  
  54.           The Pulldown MenuPane must be attached to a CascadeButton or
  55.           CascadeButtonGadget that resides in a MenuBar, a Popup
  56.           MenuPane, a Pulldown MenuPane, or an OptionMenu.  This is
  57.           done by using the button resource XXXXmmmmNNNNssssuuuubbbbMMMMeeeennnnuuuuIIIIdddd.
  58.  
  59.           A MenuShell widget is required between the Pulldown MenuPane
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV  XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           and its parent.  If the application uses this convenience
  75.           function for creating a Pulldown MenuPane, the MenuShell is
  76.           automatically created as the real parent of the MenuPane;
  77.           otherwise, it is the application's responsibility to create
  78.           the MenuShell widget.
  79.  
  80.           To function correctly when incorporated into a menu, the
  81.           Pulldown MenuPane's hierarchy must be considered; this
  82.           hierarchy depends on the type of menu system that is being
  83.           built as follows:
  84.  
  85.  
  86.             +o  If the Pulldown MenuPane is to be pulled down from a
  87.                MenuBar, its _p_a_r_e_n_t must be the MenuBar.
  88.  
  89.             +o  If the Pulldown MenuPane is to be pulled down from a
  90.                Popup or another Pulldown MenuPane, its _p_a_r_e_n_t must be
  91.                that Popup or Pulldown MenuPane.
  92.  
  93.             +o  If the Pulldown MenuPane is to be pulled down from an
  94.                OptionMenu, its _p_a_r_e_n_t must be the same as the
  95.                OptionMenu parent.
  96.  
  97.             +o  Specifies the parent widget ID
  98.  
  99.             +o  Specifies the name of the created widget
  100.  
  101.             +o  Specifies the argument list
  102.  
  103.             +o  Specifies the number of attribute/value pairs in the
  104.                argument list (_a_r_g_l_i_s_t)
  105.  
  106.  
  107.           PullDown MenuPanes support tear-off capabilities for tear-
  108.           off menus through XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn resources.  For a complete
  109.           definition of RowColumn and its associated resources, see
  110.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))).
  111.  
  112.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  113.           Returns the RowColumn widget ID.
  114.  
  115.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  116.           XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnn((((3333XXXX)))), XXXXmmmmCCCCaaaassssccccaaaaddddeeeeBBBBuuuuttttttttoooonnnnGGGGaaaaddddggggeeeetttt((((3333XXXX)))),
  117.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeOOOOppppttttiiiioooonnnnMMMMeeeennnnuuuu((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333XXXX)))),
  118.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX)))), XXXXmmmmMMMMeeeennnnuuuuSSSShhhheeeellllllll((((3333XXXX)))),
  119.           XXXXmmmmRRRRoooowwwwCCCCoooolllluuuummmmnnnn((((3333XXXX)))), and XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPuuuullllllllddddoooowwwwnnnnMMMMeeeennnnuuuu((((3333XXXX)))).
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.