Name

XtRemoveGrab — redirect user input from modal widget back to normal destination. 

Synopsis

void XtRemoveGrab(w)

    Widget w;

Arguments

wSpecifies the widget to remove from the modal cascade.  XtRemoveGrab does not terminate a grab requested through the server; it simply changes Xt’s event dispatching. 

Description

XtRemoveGrab removes widgets from the modal cascade (a set of widgets that lock out user input to the application except through themselves).  It issues a warning if the specified widget is not in the modal cascade. 

The modal cascade is a data structure used by XtDispatchEvent when it tries to dispatch a user event.  It is a list of widgets which have issued a request, from the Intrinsics, for events that would ordinarily be outside their jurisdiction. 

When the modal cascade is not empty, XtDispatchEvent delivers the event to the most recent modal cascade entry, with the exclusive parameter True. 

Both XtPopup and XtPopupSpringLoaded use XtAddGrab and XtRemoveGrab to constrain user events to a modal cascade.  It is unusual to call XtAddGrab or XtRemoveGrab explicitly. 

See Also

XtAddGrab(1), XtDispatchEvent(1), XtPopup(1), XtPopupSpringLoaded(1).