table of contents
XtPopup(3) | XT FUNCTIONS | XtPopup(3) |
NAME¶
XtPopup, XtPopupSpringLoaded, XtCallbackNone, XtCallbackNonexclusive, XtCallbackExclusive - map a pop-upSYNTAX¶
void XtPopup(Widget popup_shell, XtGrabKind
grab_kind);
void XtPopupSpringLoaded(Widget popup_shell);
void XtCallbackNone(Widget w, XtPointer
client_data, XtPointer call_data):
void XtCallbackNonexclusive(Widget w, XtPointer
client_data, XtPointer call_data);
void XtCallbackExclusive(Widget w, XtPointer
client_data, XtPointer call_data);
void MenuPopup(String shell_name);
ARGUMENTS¶
- call_data
- Specifies the callback data, which is not used by this procedure.
- client_data
- Specifies the pop-up shell.
- grab_kind
- Specifies the way in which user events should be constrained.
- popup_shell
- Specifies the widget shell.
- w
- Specifies the widget.
DESCRIPTION¶
The XtPopup function performs the following:- •
- Calls XtCheckSubclass to ensure popup_shell is a subclass of Shell.
- •
- Generates an error if the shell's popped_up field is already True.
- •
- Calls the callback procedures on the shell's popup_callback list.
- •
- Sets the shell popped_up field to True, the shell spring_loaded field to False, and the shell grab_kind field from grab_kind.
- •
- If the shell's create_popup_child field is non-NULL, XtPopup calls it with popup_shell as the parameter.
- •
- If grab_kind is either XtGrabNonexclusive or XtGrabExclusive, it calls:
XtAddGrab(popup_shell, (grab_kind == XtGrabExclusive), False)
- •
- Calls XtRealizeWidget with popup_shell specified.
- •
- Calls XMapWindow with popup_shell specified.
- •
- Calls XtCheckSubclass to ensure popup_shell is a subclass of Shell.
- •
- Generates an error if the shell's popped_up field is already True.
- •
- Calls the callback procedures on the shell's popup_callback list.
- •
- Sets the shell popped_up field to True and the shell grab_kind and spring_loaded fields appropriately.
- •
- If the shell's create_popup_child field is non-NULL, it is called with popup_shell as the parameter.
- •
- Calls:
XtAddGrab(popup_shell, (grab_kind == XtGrabExclusive), spring_loaded)
- •
- Calls XtRealizeWidget with popup_shell specified.
- •
- Calls XMapWindow with popup_shell specified.
SEE ALSO¶
XtCreatePopupShell(3), XtPopdown(3)libXt 1.1.4 | X Version 11 |