hpux man page for xtmenupopup

XtMenuPopup()															     XtMenuPopup()

Name
  XtMenuPopup - built-in action for popping up a widget.

Synopsis (Translation Table)
  <Event sequence>: XtMenuPopup(shell_name)

Inputs
  shell_name
	    Specifies the name of the widget shell to pop up.

Availability
  This action is named MenuPopup prior to Release 4.

Description
  XtMenuPopdown  is a predefined action procedure which does not have a corresponding public C routine.  It can only be invoked from a trans-
  lation table.

  XtMenuPopup tries to find the named shell by searching the widget tree starting at the widget in which it is invoked.  If it finds a	shell
  with the specified name in the popup children of that widget, it pops up the shell with the appropriate parameters.  Otherwise, it moves up
  the parent chain to find a popup child with the specified name.  If XtMenuPopup gets to the application top-level shell widget and has  not
  found a matching shell, it generates a warning and returns immediately.

  If  XtMenuPopup is invoked on ButtonPress, it calls XtPopupSpringLoaded() on the specified shell widget.  If XtMenuPopup is invoked on Key-
  Press or EnterWindow, it calls XtPopup() on the specified shell widget with grab_kind set to XtGrabNonexclusive.  Otherwise,	the  transla-
  tion manager generates a warning message and ignores the action.

  XtMenuPopup  is specially registered with the translation manager as an action that will invoke a grab.  This registration is done by call-
  ing XtRegisterGrabAction() specifying owner_events True, event_mask ButtonPressMask	ButtonReleaseMask, and pointer_mode and keyboard_mode
  GrabModeAsync.

Usage
  Note that XtMenuPopup is an action procedure; you cannot call it from C code.

  MenuPopup is a synonym for XtMenuPopup.

  Popup  shells  can  also  be popped up explicitly using XtPopup(), XtPopupSpringLoaded() or one of the predefined popup callback procedures
  (see XtCallbackExclusive()).

  The action XtMenuPopdown can be used to pop down a shell widget from a translation table.

See Also
  XtMenuPopdown(1), XtPopDown(1), XtPopup(1), XtPopupSpringLoaded(1), XtRegisterGrabAction(1).

Xt - Pop Ups															     XtMenuPopup()