Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xtmenupopup(1) [hpux man page]

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()

Check Out this Related Man Page

XtPopupSpringLoaded()													     XtPopupSpringLoaded()

Name
  XtPopupSpringLoaded - map a spring-loaded popup from within an application.

Synopsis
  void XtPopupSpringLoaded(popup_shell)
	   Widget popup_shell;

Inputs
  popup_shell
	    Specifies the shell widget to be popped up.

Availability
  Release 4 and later.

Description
  XtPopupSpringLoaded() 	calls	      the	  functions	    registered	       on	  the	     specified	      shell's
  XtNpopupCallback callback list and pops the shell up, making it a spring-loaded shell.  A spring-loaded shell is one that is popped  up  in
  response to a button press and will pop down when the button is released.  Spring-loaded shells have events dispatched to them specially to
  ensure that they receive the button up event, even if it occurs in another window.  See XtAddGrab() for more details.

  XtPopupSpringLoaded() performs exactly like XtPopup(), except that XtPopupSpringLoaded() does the following:

  o  Sets the shell spring_loaded field to True.

  o  Always calls XtAddGrab() with exclusive set to True and spring_loaded set to True.

  See XtPopup() for details.

Usage
  You can also pop up spring loaded shells by using the XtMenuPopup action in a translation table.  This  predefined  action  calls  XtPopup-
  SpringLoaded().

  Any pop up shell can be popped down with XtPopdown(), the XtCallbackPopdown() callback function, or with the XtMenuPopdown action.

  XtPopupSpringLoaded()  was  added  in  Release  4,  and  prior to this release, the only way to pop up a spring loaded shell was to use the
  MenuPopup action (which has now been renamed XtMenuPopup).

See Also
  XtAddGrab(1), XtCreatePopupShell(1), XtMenuPopdown(1), XtMenuPopup(1), XtPopdown(1), XtPopup(1).

Xt - Pop Ups														     XtPopupSpringLoaded()
Man Page