NAME

VendorShell — the VendorShell widget class. 

SYNOPSIS

#include <Xm/Xm.h>
#include <X11/Shell.h>

DESCRIPTION

VendorShell is a Motif widget class used as a supporting superclass for all shell classes that are visible to the window manager and that are not override redirect.  It contains the resources that describe the Mwm-specific look and feel.  It also manages the Mwm-specific communication needed by all VendorShell subclasses. See the Mwm man page for more information. 

Classes

VendorShell inherits behavior and resources from Core, Composite, Shell, and WMShell classes. 

The class pointer is vendorShellWidgetClass. 

The class name is VendorShell. 

New Resources

The following table defines a set of widget resources used by the programmer to specify data.  The programmer can also set the resource values for the inherited classes to set attributes for this widget.  To reference a resource by name or by class in a .Xdefaults file, remove the XmN or XmC prefix and use the remaining letters.  To specify one of the defined values for a resource in a .Xdefaults file, remove the Xm prefix and use the remaining letters (in either lower case or upper case, but include any underscores between words).  The codes in the access column indicate if the given resource can be set at creation time (C), set by using XtSetValues (S), retrieved by using XtGetValues (G), or is not applicable (N/A). 

XmNkeyboardFocusPolicy
Determines allocation of keyboard focus within the widget hierarchy rooted at this shell.  The X keyboard focus must be directed to somewhere in the hierarchy for this client-side focus management to take effect.

XmNdeleteResponse
Determines what action the shell takes in response to a WM_DELETE_WINDOW message.  The setting can be one of three values:  XmDESTROY, XmUNMAP, and XmDO_NOTHING.  The resource is scanned, and the appropriate action is taken, after the WM_DELETE_WINDOW callback list (if any) that is registered with the Protocol manager has been called. 

XmNmwmDecorations
Includes the decoration flags (specific decorations to add or remove from the window manager frame) for MWM_HINTS. 

XmNmwmFunctions
Includes the function flags (specific window manager functions to include or exclude from the system menu for MWM_HINTS. 

XmNmwmInputMode
Includes the input mode flag (application modal or system modal input focus constraints) for MWM_HINTS. 

XmNmwmMenu
Specifies the menu items that the Motif window manager should add to the end of the system menu.  The contents of the string are a list of items separated by \n with the following format:

label [mnemonic] [ accelerator] function

If more than one item is specified, the items should be separated by a newline character. 

XmNshellUnitType
Determines geometric resource interpretation.  The following values are allowed:

•XmPIXELS — all values provided to the widget are treated as normal pixel values. 

•Xm100TH_MILLIMETERS — all values provided to the widget are treated as 1/100 millimeter. 

•Xm1000TH_INCHES — all values provided to the widget are treated as 1/1000 inch. 

•Xm100TH_POINTS — all values provided to the widget are treated as 1/100 point.  A point is a unit used in text processing applications and is defined as 1/72 inch. 

•Xm100TH_FONT_UNITS — all values provided to the widget are treated as 1/100-font unit.  The value used for the font unit is determined in one of two ways:  The resource XmNfont can be used in a defaults file or on the command line; or, the standard command line options of -fn and -font can be used.  The font unit value is taken as the QUAD_WIDTH property of the font.  The function XmSetFontUnits allows applications to specify the font unit values. 

Inherited Resources

VendorShell inherits behavior and resources from the following superclasses.  For a complete description of these resources, refer to the man page for that superclass. 

RELATED INFORMATION

Composite(3Xm), Core(3Xm), mwm(1X), Shell(3Xm), WMShell(3Xm), XmActivateProtocol(3Xm), XmActivateWMProtocol(3Xm), XmAddProtocolCallback(3Xm), XmAddWMProtocolCallback(3Xm), XmAddProtocols(3Xm), XmAddWMProtocols(3Xm), XmDeactivateProtocol(3Xm), XmDeactivateWMProtocol(3Xm), XmGetAtomName(3Xm), XmInternAtom(3Xm), XmIsMotifWMRunning(3Xm), XmRemoveProtocolCallback(3Xm), XmRemoveWMProtocolCallback(3Xm), XmRemoveProtocols(3Xm), XmRemoveWMProtocols(3Xm), XmSetProtocolHooks(3Xm), and XmSetWMProtocolHooks(3Xm). 

7th Edition