SET(MENU_POSITION)

     Sets menu positioning for one or more pop-up menu widgets.

  Syntax

     [{array1 | NONE} :=] SET (MENU_POSITION, mouse_down_button,
                               {array2 | NONE | widget})

  Parameters

     MENU_POSITION        A keyword indicating that SET is being used to
                          enable automatic menu positioning of one or more
                          pop-up menu widgets.  When the user presses the
                          specified mouse button and the application manages
                          the the pop-up widget, DECTPU positions the pop-up
                          widget for the current windowing environment.
                          DECTPU positions the pop-up widget immediately
                          below and to the right of the mouse pointer.  If
                          this built-in is not used, the pop-up widget is
                          positioned in the upper left corner of the
                          display.

     mouse_down_button    A keyword for a mouse down button (M1DOWN -
                          M5DOWN) indicating which mouse button is
                          associated with the pop-up widget specified in the
                          third parameter.  The Motif style guide requires
                          M3DOWN activate pop-up menus.

     array2               An integer-indexed array of pop-up widgets to be
                          set for automatic menu positioning when the user
                          presses the specified mouse button.

     widget               The pop-up widget to be set for automatic menu
                          positioning when the user presses the specified
                          mouse button.

     NONE                 A keyword directing DECTPU to stop automatic
                          positioning of pop-up widgets for the specified
                          mouse button.

  The built-in returns the keyword NONE when no pop-up widgets were set for
  automatic menu positioning prior to calling the built-in.  The built-in
  returns an integer-indexed array of all the pop-up widgets that were set
  for automatic menu positioning prior to calling the built-in.

  Related Topics

     CREATE_WIDGET   DELETE   MANAGE_WIDGET   MAP
     REALIZE_WIDGET  UNMANAGE_WIDGET          UNMAP