VendorShell(3X) UNIX System V VendorShell(3X)
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
10/89 Page 1
VendorShell(3X) UNIX System V VendorShell(3X)
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).
_______________________________________________________________________________________
| VendorShell Resource Set |
|______________________|________________________|_______________|____________|________|
|Name | Class | Type | Default | Access|
|______________________|________________________|_______________|____________|________|
|______________________|________________________|_______________|____________|________|
|XmNdefaultFontList | XmCDefaultFontList | XmFontList | dynamic | C |
|______________________|________________________|_______________|____________|________|
|XmNdeleteResponse | XmCDeleteResponse | unsigned char| XmDESTROY | CSG |
|______________________|________________________|_______________|____________|________|
|XmNkeyboardFocusPolicy| XmCKeyboardFocusPolicy| unsigned char| XmEXPLICIT| CSG |
|______________________|________________________|_______________|____________|________|
|XmNmwmDecorations | XmCMwmDecorations | int | -1 | CSG |
|______________________|________________________|_______________|____________|________|
|XmNmwmFunctions | XmCMwmFunctions | int | -1 | CSG |
|______________________|________________________|_______________|____________|________|
|XmNmwmInputMode | XmCMwmInputMode | int | -1 | CSG |
|______________________|________________________|_______________|____________|________|
|XmNmwmMenu | XmCMwmMenu | String | NULL | CSG |
|______________________|________________________|_______________|____________|________|
|XmNshellUnitType | XmCShellUnitType | unsigned char| XmPIXELS | CSG |
|______________________|________________________|_______________|____________|________|
|XmNuseAsyncGeometry | XmCUseAsyncGeometry | Boolean | False | CSG |
|______________________|________________________|_______________|____________|________|
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.
Page 2 10/89
VendorShell(3X) UNIX System V VendorShell(3X)
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.
10/89 Page 3
VendorShell(3X) UNIX System V VendorShell(3X)
⊕ 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.
Page 4 10/89
VendorShell(3X) UNIX System V VendorShell(3X)
________________________________________________________________________________
WMShell Resource Set
________________________________________________________________________________
Name Class Type Default Access
________________________________________________________________________________
________________________________________________________________________________
XmNbaseHeight XmCBaseHeight int XtUnspecifiedShellInt CSG
________________________________________________________________________________
XmNbaseWidth XmCBaseWidth int XtUnspecifiedShellInt CSG
________________________________________________________________________________
XmNheightInc XmCHeightInc int XtUnspecifiedShellInt CSG
________________________________________________________________________________
XmNiconMask XmCIconMask Pixmap NULL CSG
________________________________________________________________________________
XmNiconPixmap XmCIconPixmap Pixmap NULL CSG
________________________________________________________________________________
XmNiconWindow XmCIconWindow Window NULL CSG
________________________________________________________________________________
XmNiconX XmCIconX int -1 CSG
________________________________________________________________________________
XmNiconY XmCIconY int -1 CSG
________________________________________________________________________________
XmNinitialState XmCInitialState int NormalState CSG
________________________________________________________________________________
XmNinput XmCInput Boolean True CSG
________________________________________________________________________________
XmNmaxAspectX XmCMaxAspectX int XtUnspecifiedShellInt CSG
________________________________________________________________________________
XmNmaxAspectY XmCMaxAspectY int XtUnspecifiedShellInt CSG
________________________________________________________________________________
XmNmaxHeight XmCMaxHeight int XtUnspecifiedShellInt CSG
________________________________________________________________________________
XmNmaxWidth XmCMaxWidth int XtUnspecifiedShellInt CSG
________________________________________________________________________________
XmNminAspectX XmCMinAspectX int XtUnspecifiedShellInt CSG
________________________________________________________________________________
XmNminAspectY XmCMinAspectY int XtUnspecifiedShellInt CSG
________________________________________________________________________________
XmNminHeight XmCMinHeight int XtUnspecifiedShellInt CSG
________________________________________________________________________________
XmNminWidth XmCMinWidth int XtUnspecifiedShellInt CSG
________________________________________________________________________________
XmNtitle XmCTitle String dynamic CSG
________________________________________________________________________________
XmNtitleEncoding XmCTitleEncoding Atom XA_STRING CSG
________________________________________________________________________________
XmNtransient XmCTransient Boolean False CSG
________________________________________________________________________________
XmNwaitForWm XmCWaitForWm Boolean True CSG
________________________________________________________________________________
XmNwidthInc XmCWidthInc int XtUnspecifiedShellInt CSG
________________________________________________________________________________
10/89 Page 5
VendorShell(3X) UNIX System V VendorShell(3X)
| XmNwindowGroup | XmCWindowGroup | Window | dynamic | CSG |
|_________________|__________________|_________|_______________________|________|
| XmNwinGravity | XmCWinGravity | int | dynamic | CSG |
|_________________|__________________|_________|_______________________|________|
| XmNwmTimeout | XmCWmTimeout | int | 5000 ms | CSG |
|_________________|__________________|_________|_______________________|________|
______________________________________________________________________________________________
| Shell Resource Set |
|_______________________|_________________________|________________|________________|________|
|Name | Class | Type | Default | Access|
|_______________________|_________________________|________________|________________|________|
|_______________________|_________________________|________________|________________|________|
|XmNallowShellResize | XmCAllowShellResize | Boolean | False | CG |
|_______________________|_________________________|________________|________________|________|
|XmNcreatePopupChildProc| XmCCreatePopupChildProc| (*)() | NULL | CSG |
|_______________________|_________________________|________________|________________|________|
|XmNgeometry | XmCGeometry | String | NULL | CSG |
|_______________________|_________________________|________________|________________|________|
|XmNoverrideRedirect | XmCOverrideRedirect | Boolean | False | CSG |
|_______________________|_________________________|________________|________________|________|
|XmNpopdownCallback | XmCCallback | XtCallbackList| NULL | C |
|_______________________|_________________________|________________|________________|________|
|XmNpopupCallback | XmCCallback | XtCallbackList| NULL | C |
|_______________________|_________________________|________________|________________|________|
|XmNsaveUnder | XmCSaveUnder | Boolean | False | CSG |
|_______________________|_________________________|________________|________________|________|
|XmNvisual | XmCVisual | Visual * | CopyFromParent| CSG |
|_______________________|_________________________|________________|________________|________|
_______________________________________________________________________
| Composite Resource Set |
|__________________|___________________|____________|_________|________|
| Name | Class | Type | Default| Access|
|__________________|___________________|____________|_________|________|
|__________________|___________________|____________|_________|________|
| XmNchildren | XmCReadOnly | WidgetList| NULL | G |
|__________________|___________________|____________|_________|________|
| XmNinsertPosition| XmCInsertPosition| (*)() | NULL | CSG |
|__________________|___________________|____________|_________|________|
| XmNnumChildren | XmCReadOnly | Cardinal | 0 | G |
|__________________|___________________|____________|_________|________|
Page 6 10/89
VendorShell(3X) UNIX System V VendorShell(3X)
________________________________________________________________________________________________________________
| Core Resource Set |
|_____________________________|_______________________________|________________|______________________|________|
|Name | Class | Type | Default | Access|
|_____________________________|_______________________________|________________|______________________|________|
|_____________________________|_______________________________|________________|______________________|________|
|XmNaccelerators | XmCAccelerators | XtAccelerators| dynamic | CSG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNancestorSensitive | XmCSensitive | Boolean | dynamic | G |
|_____________________________|_______________________________|________________|______________________|________|
|XmNbackground | XmCBackground | Pixel | dynamic | CSG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNbackgroundPixmap | XmCPixmap | Pixmap | XmUNSPECIFIED_PIXMAP| CSG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNborderColor | XmCBorderColor | Pixel | XtDefaultForeground | CSG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNborderPixmap | XmCPixmap | Pixmap | XmUNSPECIFIED_PIXMAP| CSG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNborderWidth | XmCBorderWidth | Dimension | 1 | CSG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNcolormap | XmCColormap | Colormap | dynamic | CG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNdepth | XmCDepth | int | dynamic | CG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNdestroyCallback | XmCCallback | XtCallbackList| NULL | C |
|_____________________________|_______________________________|________________|______________________|________|
|XmNheight | XmCHeight | Dimension | dynamic | CSG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNinitialResourcesPersistent| XmCInitialResourcesPersistent| Boolean | True | C |
|_____________________________|_______________________________|________________|______________________|________|
|XmNmappedWhenManaged | XmCMappedWhenManaged | Boolean | True | CSG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNscreen | XmCScreen | Screen * | dynamic | CG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNsensitive | XmCSensitive | Boolean | True | CSG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNtranslations | XmCTranslations | XtTranslations| dynamic | CSG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNwidth | XmCWidth | Dimension | dynamic | CSG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNx | XmCPosition | Position | 0 | CSG |
|_____________________________|_______________________________|________________|______________________|________|
|XmNy | XmCPosition | Position | 0 | CSG |
|_____________________________|_______________________________|________________|______________________|________|
Translations
There are no translations for VendorShell.
RELATED INFORMATION
Composite(3X), Core(3X), mwm(1X), Shell(3X), WMShell(3X),
XmActivateProtocol(3X), XmActivateWMProtocol(3X),
10/89 Page 7
VendorShell(3X) UNIX System V VendorShell(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).
Page 8 10/89