xtregistergrabaction(3) [x11r4 man page]

XtRegisterGrabAction(3) 					   XT FUNCTIONS 					   XtRegisterGrabAction(3)

NAME

       XtRegisterGrabAction - register button and key grabs

SYNTAX

       void XtRegisterGrabAction(XtActionProc action_proc, Boolean owner_events, unsigned int event_mask, int pointer_mode, int keyboard_mode);

ARGUMENTS

       action_proc
		 Specifies the action procedure to search for in translation tables.

       action

       event

       params

       num_params
		 Specify arguments to XtGrabButton or XtGrabKey

DESCRIPTION

       XtRegisterGrabAction adds the specified action_proc to a list known to the translation manager.

SEE ALSO

       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface

X Version 11							    libXt 1.0.5 					   XtRegisterGrabAction(3)

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