XmAddToPostFromList(3X)



     XmAddToPostFromList(3X)   UNIX System V   XmAddToPostFromList(3X)



     NAME
          XmAddToPostFromList - a RowColumn function that makes a menu
          accessible from more than one widget

     SYNOPSIS
          #include <Xm/RowColumn.h>

          void XmAddToPostFromList(
          Widget menu,
          Widget postfromwidget);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmAddToPostFromList makes a menu accessible from more than
          one widget. After a menu is once created, this function may
          be used to make that menu accessible from a second widget.
          The process may be repeated indefinitely. In other words,
          where an application would use XmCreatePopupMenu or
          XmCreatePulldownMenu or their equivalent to create a new
          menu identical to one that already exists, it can use this
          function to reuse that earlier menu.

          If menu refers to a Popup menu, then the
          post_from_widgetwidget can now pop up the specified menu.
          The actual posting of the menu occurs as it always does,
          either through an event handler, or the automatic popup menu
          support (see the XmRowColumn(3) reference page).

          If menu refers to a Pulldown menu, its ID is placed in the
          XmNsubMenuId resource of the specified post_from_widget.  In
          this case, the post_from_widget widget must be either a
          CascadeButton or a CascadeButtonGadget.

          Note that this function manipulates the internal structures
          themselves, not a copy of them.

          menu      Specifies the ID of the RowColumn widget
                    containing the menu (Popup or Pulldown) to be made
                    accessible from the widget.

          post_from_widget
                    Specifies the widget ID of the widget which will
                    now be able to post the menu specified by menu.

          For a complete definition of RowColumn and its associated
          resources, see XmRowColumn(3).

     RELATED
          XmGetPostedFromWidget(3), XmRemoveFromPostFromList(3), and
          XmRowColumn(3).



     Page 1                                          (printed 1/22/99)
Museum
