xtcreatepoa(3) [hpux man page]

XtCreatePopupChildProc()												  XtCreatePopupChildProc()

Name
  XtCreatePopupChildProc - interface definition for an XtNcreatePopupChildProc
  procedure.

Synopsis
  typedef void (*XtCreatePopupChildProc)(Widget);
	 Widget shell;

Inputs
  shell     Specifies the shell which is being popped up.

Description
  An  XtCreatePopupChildProc  is  registered  as  the  value of the XtNcreatePopupChildProc resource of a shell widget.  It will be called by
  XtPopup() just before the shell is popped up, and is intended to provide an opportunity for the application to create the  popup  child  of
  the shell.  See XtPopup(1) and Shell(3) for more information.

Usage
  None	of  the standard MIT clients make use of the XtNcreatePopupChildProc resource, and most applications will probably find it simpler to
  either create both popup shell and popup child in advance, or to delay creation of both until just before XtPopup() is called.   Note  that
  XtPopup()  also calls the procedures on a shell's XtNpopupCallback list, and a callback on this list can be used for the same purpose as an
  XtNcreatePopupChildProc.

  Note that an XtNcreatePopupChildProc procedure is not a widget class method.	It could be considered an "instance  method"  rather  than  a
  "class method."  In this way it is similar to the XtNinsertPosition procedure of the Composite widget class.

See Also
  XtPopup(1),
  Shell(3).

Xt - Pop Ups														  XtCreatePopupChildProc()

XtCallbackNone()														  XtCallbackNone()

Name
  XtCallbackNone - callback function to pop up a widget.

Synopsis
  void XtCallbackNone(w, client_data, call_data)
	 Widget w;
	 XtPointer client_data;
	 XtPointer call_data;

Inputs
  w	    Specifies the widget.

  client_data
	    Specifies the popup shell.

  call_data Specifies the callback data, which is not used by this procedure.

Description
  XtCallbackNone()  calls  XtPopup() on the widget passed in the client_data argument with grab_mode set to XtGrabNone.  Then it calls XtSet-
  Sensitive() on w to make that widget insensitive.

  XtCallbackNone() is a convenience procedure designed to be registered on a widget's callback list (which is why  it  has  a  third,  unused
  argument).   The  widget  to	be  popped  up should be registered as client_data for the callback.  The reason that this callback makes its
  invoking widget insensitive is so that the user cannot request to popup the shell again while it is already up.

Usage
  To popup a shell with an exclusive grab or with no grab at all, you can use XtCallbackExclusive() or XtCallbackNone().  To popdown a	shell
  from a callback, use XtCallbackPopdown().

  Note that this function does not attempt to place the popup shell at any particular location, and for that reason may not be appropriate in
  many circumstances.

  It is also possible to pop up a shell with the XtMenuPopup action.

Example
  To arrange for the shell pshell to be popped up when the user clicks on the button widget button, you would use code like the following:

	 XtAddCallback(button,XtNcallback,XtCallbackNone,pshell);

  A companion example is presented on the XtCallbackPopdown() reference page.

See Also
  XtCallbackExclusive(1), XtCallbackNonexclusive(1), XtCallbackPopdown(1), XtMenuPopdown(1), XtMenuPopup(1), XtPopdown(1), XtPopup(1), XtSet-
  Sensitive(1).

Xt - Pop Ups															  XtCallbackNone()