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 subresources that describe the MWM-specific look and feel.  It also manages the MWM-specific communication needed by all VendorShell subclasses. See the mwm(1X) man page for more information. 

Setting XmNheight, XmNwidth, or XmNborderWidth for either a VendorShell or its child sets that resource to the same value in both the parent and the child.  An application should always specify these resources for the child, not the parent. 

For a child of a VendorShell, setting XmNx or XmNy sets the corresponding resource of the parent but does not change the child’s position relative to the parent.  XtGetValues for the child’s XmNx or XmNy yields the value of the corresponding resource in the parent.  The x and y coordinates of the child’s upper left outside corner relative to the parent’s upper left inside corner are both zero minus the value of XmNborderWidth. 

Note that the Inter-Client Communication Conventions Manual allows a window manager to change or control the border width of a reparented top-level window. 

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 subresource 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 subresource in a .Xdefaults file, remove the Xm prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words).  The codes in the access column indicate if the given subresource can be set at creation time (C), set by using XtSetValues (S), retrieved by using XtGetValues (G), or is not applicable (N/A). 

XmNdefaultFontList
Specifies a default font list for its children.  This font list is used whenever a font list is not specifically set for a Text, Label or Button child of the VendorShell.

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. 

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. Possible values are XmEXPLICIT, specifying a click-to-type policy, and XmPOINTER, specifying a pointer-driven policy. 

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 string contains 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 of a font unit.  The value to be used for the font unit is determined in one of three ways:

•The application can use XmSetFontUnits to specify the font unit values. 

•If the application has not called XmSetFontUnits, the font units can be derived from a font.  The user specifies this font by using the font resource in a defaults file or on the command line, or by using the standard command line options −fn and −font. 

•If the application has not called XmSetFontUnits and the user has not specified a font resource, the horizontal and vertical font units default to 10. 

A horizontal font unit is derived from a font as follows:

•If the font has an AVERAGE_WIDTH property, the horizontal font unit is the AVERAGE_WIDTH property divided by 10. 

•If the font has no AVERAGE_WIDTH property but has a QUAD_WIDTH property, the horizontal font unit is the QUAD_WIDTH property. 

•If the font has no AVERAGE_WIDTH or QUAD_WIDTH property, the horizontal font unit is the sum of the font struct’s min_bounds.width and max_bounds.width divided by 2.3. 

A vertical font unit is derived from a font as follows:

•If the font has a PIXEL_SIZE property, the vertical font unit is the PIXEL_SIZE property divided by 1.8. 

•If the font has no PIXEL_SIZE property but has POINT_SIZE and RESOLUTION_Y properties, the vertical font unit is the product of the POINT_SIZE and RESOLUTION_Y properties divided by 1400. 

•If the font has no PIXEL_SIZE, POINT_SIZE, or RESOLUTION_Y properties, the vertical font unit is the sum of the font struct’s max_bounds.ascent and max_bounds.descent divided by 2.2. 

XmNuseAsyncGeometry
Specifies whether the geometry manager should wait for confirmation of a geometry request to the window manager. When the value of this resource is True, the geometry manager forces XmNwaitForWm to False and XmNwmTimeout to 0, and it relies on asynchronous notification.  When the value of this resource is False, XmNwaitForWm and XmNwmTimeout are unaffected.  The default is False. 

Inherited Resources

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

Translations

There are no translations for VendorShell. 

RELATED INFORMATION

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

March 13, 1992