NAME

XmtGetShell(), XmtGetApplicationShell(), XmtGetTopLevelShell() - return shell ancestors of a widget.

SYNOPSIS

ARGUMENTS

INPUTS

w

The widget whose shell ancestor is desired.

RETURNS

The appropriate shell ancestor of w.

DESCRIPTION

XmtGetShell() returns the closest widget ancestor of w that is a shell widget-i.e. is any subclass of Shell.

XmtGetTopLevelShell() returns the closest ancestor of w that is a TopLevelShell or a subclass. Thus if w is a descendent of a dialog box, this function will skip the dialog shell and return the main window shell that is the ancestor of the dialog box.

XmtGetApplicationShell() returns the ``root'' of the widget hierarchy. This is the ancestor of w which has no ancestors of its own. This shell is usually created with XtAppInitialize() or XtAppCreateShell(), and is usually an ApplicationShell widget.

SEE ALSO

Chapter 8, Utility Functions,
Chapter 14, Windows on the Desktop,
XtIsShell(), XtIsTopLevelShell().