Blame doc/man/man3/VendorShell.3

Packit b099d7
'\" t
Packit b099d7
...\" Vendor.sgm /main/16 1996/10/29 11:40:55 cdedoc $
Packit b099d7
.de P!
Packit b099d7
.fl
Packit b099d7
\!!1 setgray
Packit b099d7
.fl
Packit b099d7
\\&.\"
Packit b099d7
.fl
Packit b099d7
\!!0 setgray
Packit b099d7
.fl			\" force out current output buffer
Packit b099d7
\!!save /psv exch def currentpoint translate 0 0 moveto
Packit b099d7
\!!/showpage{}def
Packit b099d7
.fl			\" prolog
Packit b099d7
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
Packit b099d7
\!!psv restore
Packit b099d7
.
Packit b099d7
.de pF
Packit b099d7
.ie     ?\\*(f1?? .ds f1 \\n(.f
Packit b099d7
.el .ie ?\\*(f2?? .ds f2 \\n(.f
Packit b099d7
.el .ie ?\\*(f3?? .ds f3 \\n(.f
Packit b099d7
.el .ie ?\\*(f4?? .ds f4 \\n(.f
Packit b099d7
.el .tm ? font overflow
Packit b099d7
.ft \\$1
Packit b099d7
..
Packit b099d7
.de fP
Packit b099d7
.ie     !?\\*(f4?? \{\
Packit b099d7
.	ft \\*(f4
Packit b099d7
.	ds f4\"
Packit b099d7
'	br \}
Packit b099d7
.el .ie !?\\*(f3?? \{\
Packit b099d7
.	ft \\*(f3
Packit b099d7
.	ds f3\"
Packit b099d7
'	br \}
Packit b099d7
.el .ie !?\\*(f2?? \{\
Packit b099d7
.	ft \\*(f2
Packit b099d7
.	ds f2\"
Packit b099d7
'	br \}
Packit b099d7
.el .ie !?\\*(f1?? \{\
Packit b099d7
.	ft \\*(f1
Packit b099d7
.	ds f1\"
Packit b099d7
'	br \}
Packit b099d7
.el .tm ? font underflow
Packit b099d7
..
Packit b099d7
.ds f1\"
Packit b099d7
.ds f2\"
Packit b099d7
.ds f3\"
Packit b099d7
.ds f4\"
Packit b099d7
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
Packit b099d7
.TH "VendorShell" "library call"
Packit b099d7
.SH "NAME"
Packit b099d7
\fBVendorShell\fP \(em The VendorShell widget class
Packit b099d7
.iX "VendorShell"
Packit b099d7
.iX "widget class" "VendorShell"
Packit b099d7
.SH "SYNOPSIS"
Packit b099d7
.PP
Packit b099d7
.nf
Packit b099d7
#include <Xm/Xm\&.h>
Packit b099d7
#include <X11/Shell\&.h>
Packit b099d7
.fi
Packit b099d7
.SH "DESCRIPTION"
Packit b099d7
.PP
Packit b099d7
VendorShell is a Motif widget class used as a supporting superclass for
Packit b099d7
all shell classes that are visible to the window manager and that are
Packit b099d7
not override redirect\&.
Packit b099d7
It contains resources that describe the MWM-specific look and feel\&.
Packit b099d7
It also manages the MWM-specific communication needed by all VendorShell
Packit b099d7
subclasses\&.
Packit b099d7
See the \fBmwm\fP reference page for more information\&.
Packit b099d7
.PP
Packit b099d7
It is also responsible for managing toolTips. All \fBXmPrimitive\fP and
Packit b099d7
\fBXmGadget\fP
Packit b099d7
subclasses have an \fBXmNtoolTipString\fP resource. If \fBXmNtoolTipEnable\fP
Packit b099d7
is True, and
Packit b099d7
the pointer enters a Primitive or Gadget that has traversal enabled, and the
Packit b099d7
XmNtoolTipString is not NULL, the \fBXmNtoolTipString\fP will be displayed according
Packit b099d7
to the VendorShell resources for controlling toolTips. VendorShell displays
Packit b099d7
the XmNtooTipString in an XmLabel that is a child of a transientShell. The name
Packit b099d7
of the transientShell is TipShell, and the name of the XmLabel is TipLabel.
Packit b099d7
The appearance of the tip can be controlled by specifing resources on these
Packit b099d7
widgets.
Packit b099d7
.PP
Packit b099d7
If an application uses the \fBXmNmwmDecorations\fP,
Packit b099d7
\fBXmNmwmFunctions\fP, or \fBXmNmwmInputMode\fP resource, it should
Packit b099d7
include the file \fBXm/MwmUtil\&.h\fP\&.
Packit b099d7
.PP
Packit b099d7
Setting \fBXmNheight\fP, \fBXmNwidth\fP, or \fBXmNborderWidth\fP for
Packit b099d7
either a VendorShell or its managed child usually sets that resource to the
Packit b099d7
same value in both the parent and the child\&. When an off-the-spot input
Packit b099d7
method exists, the height and width of the shell may be greater than
Packit b099d7
those of the managed child in order to accommodate the input method\&.
Packit b099d7
In this case, setting \fBXmNheight\fP or \fBXmNwidth\fP for the
Packit b099d7
shell does not necessarily set that resource to the same value in
Packit b099d7
the managed child, and setting \fBXmNheight\fP or \fBXmNwidth\fP
Packit b099d7
for the child does not necessarily set that resource to the same
Packit b099d7
value in the shell\&.
Packit b099d7
.PP
Packit b099d7
For the managed child of a VendorShell, regardless of the value
Packit b099d7
of the shell\&'s \fBXmNallowShellResize\fP, setting \fBXmNx\fP or
Packit b099d7
\fBXmNy\fP sets the corresponding resource of the parent but does
Packit b099d7
not change the child\&'s position relative to the parent\&.
Packit b099d7
\fBXtGetValues\fP for the child\&'s \fBXmNx\fP or \fBXmNy\fP yields the
Packit b099d7
value of the corresponding resource in the parent\&.
Packit b099d7
The x and y-coordinates of the child\&'s upper left outside
Packit b099d7
corner relative to the parent\&'s upper left inside corner are both 0 (zero)
Packit b099d7
minus the value of \fBXmNborderWidth\fP\&.
Packit b099d7
.PP
Packit b099d7
Note that the \fIInter-Client Communication Conventions Manual\fP (ICCCM)
Packit b099d7
allows a window manager to change or control the border width of a reparented
Packit b099d7
top-level window\&.
Packit b099d7
.PP
Packit b099d7
VendorShell holds the \fBXmQTspecifyRenderTable\fP trait\&.
Packit b099d7
.SS "Classes"
Packit b099d7
.PP
Packit b099d7
VendorShell inherits behavior, resources, and traits from the \fBCore\fP,
Packit b099d7
\fBComposite\fP, \fBShell\fP, and
Packit b099d7
\fBWMShell\fP classes\&.
Packit b099d7
.PP
Packit b099d7
The class pointer is \fBvendorShellWidgetClass\fP\&.
Packit b099d7
.PP
Packit b099d7
The class name is \fBVendorShell\fP\&.
Packit b099d7
.SS "New Resources"
Packit b099d7
.PP
Packit b099d7
The following table defines a set of widget resources used by the programmer
Packit b099d7
to specify data\&. The programmer can also set the resource values for the
Packit b099d7
inherited classes to set attributes for this widget\&. To reference a
Packit b099d7
subresource by name or by class in a \fB\&.Xdefaults\fP file, remove the \fBXmN\fP or
Packit b099d7
\fBXmC\fP prefix and use the remaining letters\&. To specify one of the defined
Packit b099d7
values for a subresource in a \fB\&.Xdefaults\fP file, remove the \fBXm\fP prefix and use
Packit b099d7
the remaining letters (in either lowercase or uppercase, but include any
Packit b099d7
underscores between words)\&.
Packit b099d7
The codes in the access column indicate if the given subresource can be
Packit b099d7
set at creation time (C),
Packit b099d7
set by using \fBXtSetValues\fP (S),
Packit b099d7
retrieved by using \fBXtGetValues\fP (G), or is not applicable (N/A)\&.
Packit b099d7
.TS
Packit b099d7
tab(?) box;
Packit b099d7
c s s s s
Packit b099d7
l| l| l| l| l.
Packit b099d7
\fBVendorShell Resource Set\fP
Packit b099d7
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNaudibleWarning?XmCAudibleWarning?unsigned char?XmBELL?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNbuttonFontList?XmCButtonFontList?XmFontList?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNbuttonRenderTable?XmCButtonRenderTable?XmRenderTable?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNdefaultFontList?XmCDefaultFontList?XmFontList?dynamic?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNdeleteResponse?XmCDeleteResponse?unsigned char?XmDESTROY?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNinputMethod?XmCInputMethod?string?NULL?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNinputPolicy?XmCInputPolicy?XmInputPolicy?XmPER_SHELL?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNkeyboardFocusPolicy?XmCKeyboardFocusPolicy?unsigned char?XmEXPLICIT?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNlabelFontList?XmCLabelFontList?XmFontList?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNlabelRenderTable?XmCLabelRenderTabel?XmRenderTable?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNlayoutDirection?XmCLayoutDirection?XmDirection?XmLEFT_TO_RIGHT?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmwmDecorations?XmCMwmDecorations?int?-1?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmwmFunctions?XmCMwmFunctions?int?-1?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmwmInputMode?XmCMwmInputMode?int?-1?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmwmMenu?XmCMwmMenu?String?NULL?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNpreeditType?XmCPreeditType?String?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNverifyPreedit?XmCVerifyPreedit?Boolean?False?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNshellUnitType?XmCShellUnitType?unsigned char?XmPIXELS?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtextFontList?XmCTextFontList?XmFontList?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtextRenderTable?XmCTextRenderTable?XmRenderTable?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtoolTipPostDelay?XmCToolTipPostDelay?int?5000?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtoolTipPostDuration?XmCToolTipPostDuration?int?5000?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtoolTipEnable?XmCToolTipEnable?Boolean?False?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNunitType?XmCUnitType?unsigned char?XmPIXELS?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNuseAsyncGeometry?XmCUseAsyncGeometry?Boolean?False?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
.TE
Packit b099d7
.IP "\fBXmNaudibleWarning\fP" 10
Packit b099d7
Determines whether an action activates its associated audible cue\&.
Packit b099d7
The possible values are \fBXmBELL\fP and \fBXmNONE\fP\&.
Packit b099d7
.IP "\fBXmNbuttonFontList\fP" 10
Packit b099d7
Specifies the font list used for button descendants\&. See the
Packit b099d7
\fBXmNbuttonRenderTable\fP resource\&.
Packit b099d7
.IP "\fBXmNbuttonRenderTable\fP" 10
Packit b099d7
Specifies the render table used for VendorShell\&'s button descendants\&.
Packit b099d7
If this value is NULL at initialization and if the value of
Packit b099d7
\fBXmNdefaultFontList\fP is not NULL, \fBXmNbuttonRenderTable\fP
Packit b099d7
is initialized to the value of \fBXmNdefaultFontList\fP\&. If
Packit b099d7
the value of \fBXmNdefaultFontList\fP is NULL,
Packit b099d7
the parent hierarchy of the widget is searched for
Packit b099d7
an ancestor that holds the \fBXmQTspecifyRenderTable\fP trait\&.
Packit b099d7
If such an ancestor is found,
Packit b099d7
\fBXmNbuttonRenderTable\fP is initialized to the
Packit b099d7
\fBXmBUTTON_RENDER_TABLE\fP value
Packit b099d7
of the ancestor widget\&. If no such ancestor is found, the default
Packit b099d7
is implementation dependent\&. Refer to
Packit b099d7
\fBXmRenderTable\fP(3) for more information on the creation and structure
Packit b099d7
of a render table\&.
Packit b099d7
.IP "\fBXmNdefaultFontList\fP" 10
Packit b099d7
Specifies a default font list for VendorShell\&'s descendants\&.
Packit b099d7
This resource is obsolete and exists for compatibility with
Packit b099d7
earlier releases\&. It has been replaced by \fBXmNbuttonFontList\fP,
Packit b099d7
\fBXmNlabelFontList\fP, and \fBXmNtextFontList\fP\&.
Packit b099d7
.IP "\fBXmNdeleteResponse\fP" 10
Packit b099d7
Determines what action the shell takes in response to a
Packit b099d7
\fBWM_DELETE_WINDOW\fP message\&.
Packit b099d7
The setting can be one of three values: \fBXmDESTROY\fP, \fBXmUNMAP\fP,
Packit b099d7
and \fBXmDO_NOTHING\fP\&.
Packit b099d7
The resource is scanned, and the appropriate action is taken after the
Packit b099d7
\fBWM_DELETE_WINDOW\fP callback list (if any) that is registered with
Packit b099d7
the Protocol manager has been called\&.
Packit b099d7
.IP "\fBXmNinputMethod\fP" 10
Packit b099d7
Specifies the string that sets the locale modifier for the input
Packit b099d7
method\&.
Packit b099d7
When \fBXtGetValues\fP is called on this resource, the returned value
Packit b099d7
is a pointer to the actual resource value and
Packit b099d7
should not be freed\&.
Packit b099d7
.IP "\fBXmNinputPolicy\fP" 10
Packit b099d7
Specifies the policy to follow for creating an
Packit b099d7
Input Context (IC) for this shell\&. This resource can have the
Packit b099d7
following values:
Packit b099d7
.RS
Packit b099d7
.IP "\fBXmPER_SHELL\fP" 10
Packit b099d7
Specifies that only one XIC is created per shell\&.
Packit b099d7
.IP "\fBXmPER_WIDGET\fP" 10
Packit b099d7
Specifies that one XIC is created for each widget\&.
Packit b099d7
.RE
Packit b099d7
.IP "\fBXmNkeyboardFocusPolicy\fP" 10
Packit b099d7
Determines allocation of keyboard focus within the widget hierarchy rooted
Packit b099d7
at this shell\&. The X keyboard focus must be directed to somewhere in the
Packit b099d7
hierarchy for this client-side focus management to take effect\&.
Packit b099d7
Possible values are \fBXmEXPLICIT\fP, specifying a click-to-type policy,
Packit b099d7
and \fBXmPOINTER\fP, specifying a pointer-driven policy\&.
Packit b099d7
.IP "\fBXmNlabelFontList\fP" 10
Packit b099d7
Specifies the font list used for label descendants\&. See the
Packit b099d7
\fBXmNlabelRenderTable\fP resource\&.
Packit b099d7
.IP "\fBXmNlabelRenderTable\fP" 10
Packit b099d7
Specifies the font list used for VendorShell\&'s label descendants
Packit b099d7
(Labels and LabelGadgets)\&. If this value is NULL at initialization
Packit b099d7
and if the value of \fBXmNdefaultFontList\fP is not NULL,
Packit b099d7
\fBXmNlabelFontList\fP is initialized to the value of
Packit b099d7
\fBXmNdefaultFontList\fP\&. If the value of \fBXmNdefaultFontList\fP is
Packit b099d7
NULL, the parent hierarchy of the widget is searched
Packit b099d7
for an ancestor that holds the \fBXmQTspecifyRenderTable\fP trait\&.
Packit b099d7
If such
Packit b099d7
an ancestor is found, \fBXmNlabelRenderTable\fP is initialized to the
Packit b099d7
\fBXmLABEL_RENDER_TABLE\fP of the ancestor widget\&. If no such ancestor
Packit b099d7
is found, the default is implementation dependent\&. Refer to
Packit b099d7
\fBXmRenderTable\fP(3) for more information on the creation and structure
Packit b099d7
of a render table\&.
Packit b099d7
.IP "\fBXmNlayoutDirection\fP" 10
Packit b099d7
Specifies the direction in which the subwidgets, children of a
Packit b099d7
widget, or other visual components are to be laid out\&. This policy
Packit b099d7
will apply as the default layout policy for all descendants of this
Packit b099d7
VendorShell\&.
Packit b099d7
.IP "\fBXmNmwmDecorations\fP" 10
Packit b099d7
Specifies the decoration flags (specific decorations to add or remove
Packit b099d7
from the window manager frame) for the \fB_MOTIF_WM_HINTS\fP property\&.
Packit b099d7
If any decoration flags are specified by the \fB_MOTIF_WM_HINTS\fP
Packit b099d7
property, only decorations indicated by both that property and the MWM
Packit b099d7
\fBclientDecoration\fP and \fBtransientDecoration\fP resources are displayed\&.
Packit b099d7
If no decoration flags are specified by the \fB_MOTIF_WM_HINTS\fP property,
Packit b099d7
decorations indicated by the MWM \fBclientDecoration\fP and
Packit b099d7
\fBtransientDecoration\fP resources are displayed\&.
Packit b099d7
The default for the \fBXmNmwmDecorations\fP resource
Packit b099d7
is not to specify any decoration flags for the \fB_MOTIF_WM_HINTS\fP property\&.
Packit b099d7
.IP "" 10
Packit b099d7
The value of this resource is the bitwise inclusive OR of one or more
Packit b099d7
flag bits\&.
Packit b099d7
The possible flag bit constants, defined in the include
Packit b099d7
file \fBXm/MwmUtil\&.h\fP, are
Packit b099d7
.RS
Packit b099d7
.IP "\fBMWM_DECOR_ALL\fP" 10
Packit b099d7
All decorations \fIexcept\fP those specified by
Packit b099d7
other flag bits that are set
Packit b099d7
.IP "\fBMWM_DECOR_BORDER\fP" 10
Packit b099d7
Client window border
Packit b099d7
.IP "\fBMWM_DECOR_RESIZEH\fP" 10
Packit b099d7
Resize frame handles
Packit b099d7
.IP "\fBMWM_DECOR_TITLE\fP" 10
Packit b099d7
Title bar
Packit b099d7
.IP "\fBMWM_DECOR_MENU\fP" 10
Packit b099d7
Window menu button
Packit b099d7
.IP "\fBMWM_DECOR_MINIMIZE\fP" 10
Packit b099d7
Minimize window button
Packit b099d7
.IP "\fBMWM_DECOR_MAXIMIZE\fP" 10
Packit b099d7
Maximize window button
Packit b099d7
.RE
Packit b099d7
.IP "\fBXmNmwmFunctions\fP" 10
Packit b099d7
Specifies the function flags (specific window manager functions to
Packit b099d7
apply or not apply to the client window) for the \fB_MOTIF_WM_HINTS\fP
Packit b099d7
property\&.
Packit b099d7
If any function flags are specified by the \fB_MOTIF_WM_HINTS\fP
Packit b099d7
property, only functions indicated by both that property and the MWM
Packit b099d7
\fBclientFunctions\fP and \fBtransientFunctions\fP resources are
Packit b099d7
applied\&.
Packit b099d7
If no function flags are specified by the \fB_MOTIF_WM_HINTS\fP
Packit b099d7
property, functions indicated by the MWM \fBclientFunctions\fP and
Packit b099d7
\fBtransientFunctions\fP resources are applied\&.
Packit b099d7
The default for the \fBXmNmwmFunctions\fP resource is not to specify any
Packit b099d7
function flags for the \fB_MOTIF_WM_HINTS\fP property\&.
Packit b099d7
.IP "" 10
Packit b099d7
The value of this resource is the bitwise inclusive OR of one or more
Packit b099d7
flag bits\&.
Packit b099d7
The possible flag bit constants, defined in the include
Packit b099d7
file \fBXm/MwmUtil\&.h\fP, are
Packit b099d7
.RS
Packit b099d7
.IP "\fBMWM_FUNC_ALL\fP" 10
Packit b099d7
All functions \fIexcept\fP those specified by
Packit b099d7
other flag bits that are set
Packit b099d7
.IP "\fBMWM_FUNC_RESIZE\fP" 10
Packit b099d7
\fBf\&.resize\fP
Packit b099d7
.IP "\fBMWM_FUNC_MOVE\fP" 10
Packit b099d7
\fBf\&.move\fP
Packit b099d7
.IP "\fBMWM_FUNC_MINIMIZE\fP" 10
Packit b099d7
\fBf\&.minimize\fP
Packit b099d7
.IP "\fBMWM_FUNC_MAXIMIZE\fP" 10
Packit b099d7
\fBf\&.maximize\fP
Packit b099d7
.IP "\fBMWM_FUNC_CLOSE\fP" 10
Packit b099d7
\fBf\&.kill\fP
Packit b099d7
.RE
Packit b099d7
.IP "\fBXmNmwmInputMode\fP" 10
Packit b099d7
Specifies the input mode flag (application modal or system modal input
Packit b099d7
constraints) for the \fB_MOTIF_WM_HINTS\fP property\&.
Packit b099d7
If no input mode flag is specified by the \fB_MOTIF_WM_HINTS\fP
Packit b099d7
property, no input constraints are applied, and input goes to any
Packit b099d7
window\&.
Packit b099d7
The default for the \fBXmNmwmInputMode\fP resource is not to specify any
Packit b099d7
input mode flag for the \fB_MOTIF_WM_HINTS\fP property\&.
Packit b099d7
.IP "" 10
Packit b099d7
An application that sets input constraints on a dialog usually uses the
Packit b099d7
BulletinBoard\&'s \fBXmNdialogStyle\fP resource rather than the parent
Packit b099d7
DialogShell\&'s \fBXmNmwmInputMode\fP resource\&.
Packit b099d7
.IP "" 10
Packit b099d7
The possible values for this resource, defined in the
Packit b099d7
include file \fBXm/MwmUtil\&.h\fP, are
Packit b099d7
.RS
Packit b099d7
.IP "\fBMWM_INPUT_MODELESS\fP" 10
Packit b099d7
Input goes to any window\&.
Packit b099d7
.IP "\fBMWM_INPUT_PRIMARY_APPLICATION_MODAL\fP" 10
Packit b099d7
Input does not
Packit b099d7
go to ancestors of this window\&.
Packit b099d7
.IP "\fBMWM_INPUT_SYSTEM_MODAL\fP" 10
Packit b099d7
Input goes only to this window\&.
Packit b099d7
.IP "\fBMWM_INPUT_FULL_APPLICATION_MODAL\fP" 10
Packit b099d7
Input does not go to other
Packit b099d7
windows in this application\&.
Packit b099d7
.RE
Packit b099d7
.IP "\fBXmNmwmMenu\fP" 10
Packit b099d7
Specifies the menu items that the Motif window manager should add to the end
Packit b099d7
of the window menu\&. The string contains a list of items separated
Packit b099d7
by \fB\n\fP with the following format:
Packit b099d7
.PP
Packit b099d7
.nf
Packit b099d7
\fIlabel [mnemonic] [accelerator] function\fP
Packit b099d7
.fi
Packit b099d7
.IP "" 10
Packit b099d7
If more than one item is specified, the items should be separated by a
Packit b099d7
newline character\&.
Packit b099d7
.IP "" 10
Packit b099d7
When \fBXtGetValues\fP is called on this resource, the returned value
Packit b099d7
is a pointer to the actual resource value and
Packit b099d7
should not be freed\&.
Packit b099d7
.IP "\fBXmNpreeditType\fP" 10
Packit b099d7
Specifies the input method style or styles available to the input
Packit b099d7
manager\&. The resource can be a comma-separated list of the following
Packit b099d7
values:
Packit b099d7
.TS
Packit b099d7
tab(?) allbox;
Packit b099d7
c s
Packit b099d7
l| l|.
Packit b099d7
\fBPreedit Values\fP
Packit b099d7
\fBPreedit Value\fP?\fBXIM Style\fP
Packit b099d7
_?_?
Packit b099d7
OffTheSpot?XIMPreeditArea
Packit b099d7
_?_?
Packit b099d7
Root?XIMPreeditNothing
Packit b099d7
_?_?
Packit b099d7
None?XIMPreeditNone
Packit b099d7
_?_?
Packit b099d7
OverTheSpot?XIMPreeditPosition
Packit b099d7
_?_?
Packit b099d7
OnTheSpot?XIMPreeditCallbacks
Packit b099d7
_?_?
Packit b099d7
.TE
Packit b099d7
.IP "" 10
Packit b099d7
When \fBXtGetValues\fP is called on this resource, the returned value
Packit b099d7
is a pointer to the actual resource value and
Packit b099d7
should not be freed\&.
Packit b099d7
.IP "\fBXmNshellUnitType\fP" 10
Packit b099d7
This resource is obsolete, and is included only for compatibility with
Packit b099d7
earlier releases of Motif\&. Use the \fBXmNunitType\fP resource
Packit b099d7
instead\&.
Packit b099d7
.IP "\fBXmNtextFontList\fP" 10
Packit b099d7
Specifies the font list used for text descendants\&. See the
Packit b099d7
\fBXmNtextRenderTable\fP resource\&.
Packit b099d7
.IP "\fBXmNtextRenderTable\fP" 10
Packit b099d7
Specifies the render table used for VendorShell\&'s Text and List
Packit b099d7
descendants\&. If this value is NULL at initialization
Packit b099d7
and if the value of \fBXmNdefaultFontList\fP is not NULL,
Packit b099d7
\fBXmNtextRenderTable\fP is initialized to the value of
Packit b099d7
\fBXmNdefaultFontList\fP\&. If the value of \fBXmNdefaultFontList\fP is
Packit b099d7
NULL, the parent hierarchy of the widget is searched
Packit b099d7
for an ancestor that holds the \fBXmQTspecifyRenderTable\fP trait\&.
Packit b099d7
If such
Packit b099d7
an ancestor is found, \fBXmNtextRenderTable\fP is initialized to the
Packit b099d7
\fBXmTEXT_RENDER_TABLE\fP value of the ancestor widget\&. If no such ancestor
Packit b099d7
is found, the default is implementation dependent\&.
Packit b099d7
Refer to
Packit b099d7
\fBXmRenderTable\fP(3) for more information on the creation and structure
Packit b099d7
of a render table\&.
Packit b099d7
.IP "\fBXmNtoolTipEnable\fP" 10
Packit b099d7
Specifies whether toolTips are enabled for this shell or not.
Packit b099d7
Packit b099d7
.IP "\fBXmNtoolTipPostDelay\fP" 10
Packit b099d7
Specifies the time, in milliseconds, to wait after the pointer enters
Packit b099d7
a widget before posting the toolTip associated with this widget.
Packit b099d7
Packit b099d7
.IP "\fBXmNtoolTipPostDuration\fP" 10
Packit b099d7
Specifies the time, in milliseconds, that the toolTip is displayed. A value
Packit b099d7
of 0 will display the tip indefinitely.
Packit b099d7
Packit b099d7
.IP "\fBXmNunitType\fP" 10
Packit b099d7
Provides the basic support for resolution independence\&. It defines
Packit b099d7
the type of units a widget uses with sizing and positioning resources\&.
Packit b099d7
The resource has a default unit type of \fBXmPIXELS\fP\&.
Packit b099d7
.IP "" 10
Packit b099d7
The unit type can also be specified in resource files, with the
Packit b099d7
following format:
Packit b099d7
.PP
Packit b099d7
.nf
Packit b099d7
\f(CW\fI<floating value><unit>\fP\fR
Packit b099d7
.fi
Packit b099d7
.PP
Packit b099d7
.IP "" 10
Packit b099d7
where:
Packit b099d7
.RS
Packit b099d7
.IP "\fIunit\fP" 10
Packit b099d7
is <" ", pixels, inches, centimeters, millimeters, points, font units>
Packit b099d7
.IP "\fIpixels\fP" 10
Packit b099d7
is <\fIpix\fP, \fIpixel\fP, \fIpixels\fP>
Packit b099d7
.IP "\fIinches\fP" 10
Packit b099d7
is <\fIin\fP, \fIinch\fP, \fIinches\fP>
Packit b099d7
.IP "\fIcentimeter\fP" 10
Packit b099d7
is <\fIcm\fP, \fIcentimeter\fP, \fIcentimeters\fP>
Packit b099d7
.IP "\fImillimeters\fP" 10
Packit b099d7
is <\fImm\fP, \fImillimeter\fP, \fImillimeters\fP>
Packit b099d7
.IP "\fBpoints\fP" 10
Packit b099d7
is <\fIpt\fP, \fIpoint\fP, \fIpoints\fP>
Packit b099d7
.IP "\fBfont units\fP" 10
Packit b099d7
is <\fIfu\fP, \fBfont_unit\fP, \fBfont_units\fP>
Packit b099d7
.IP "\fIfloat\fP" 10
Packit b099d7
is {"+"|"-"}{{<"0"-"9">*}\&.}<"0"-"9">*
Packit b099d7
.IP "" 10
Packit b099d7
Note that the type Dimension must always be positive\&.
Packit b099d7
.RE
Packit b099d7
.IP "" 10
Packit b099d7
For example,
Packit b099d7
.PP
Packit b099d7
.nf
Packit b099d7
\f(CWxmfonts*XmMainWindow\&.height: 10\&.4cm
Packit b099d7
*PostIn\&.width: 3inches\fR
Packit b099d7
.fi
Packit b099d7
.PP
Packit b099d7
.IP "" 10
Packit b099d7
\fBXmNunitType\fP can have the following values:
Packit b099d7
.RS
Packit b099d7
.IP "\fBXmPIXELS\fP" 10
Packit b099d7
All values provided to the widget are treated as normal
Packit b099d7
pixel values\&.
Packit b099d7
.IP "\fBXmMILLIMETERS\fP" 10
Packit b099d7
All values provided to the widget are treated as normal millimeter
Packit b099d7
values\&.
Packit b099d7
.IP "\fBXm100TH_MILLIMETERS\fP" 10
Packit b099d7
All values provided to the widget are treated
Packit b099d7
as 1/100 of a millimeter\&.
Packit b099d7
.IP "\fBXmCENTIMETERS\fP" 10
Packit b099d7
All values provided to the widget are treated as normal centimeter
Packit b099d7
values\&.
Packit b099d7
.IP "\fBXmINCHES\fP" 10
Packit b099d7
All values provided to the widget are treated as normal inch
Packit b099d7
values\&.
Packit b099d7
.IP "\fBXm1000TH_INCHES\fP" 10
Packit b099d7
All values provided to the widget are treated as
Packit b099d7
1/1000 of an inch\&.
Packit b099d7
.IP "\fBXmPOINTS\fP" 10
Packit b099d7
All values provided to the widget are treated as normal point
Packit b099d7
values\&. A point is a unit used in text processing
Packit b099d7
applications and is defined as 1/72 of an inch\&.
Packit b099d7
.IP "\fBXm100TH_POINTS\fP" 10
Packit b099d7
All values provided to the widget are treated as
Packit b099d7
1/100 of a point\&. A point is a unit used in text processing
Packit b099d7
applications and is defined as 1/72 of an inch\&.
Packit b099d7
.IP "\fBXmFONT_UNITS\fP" 10
Packit b099d7
All values provided to the widget are treated as normal font
Packit b099d7
units\&. A font unit has horizontal and vertical components\&.
Packit b099d7
These are the values of the XmScreen resources \fBXmNhorizontalFontUnit\fP
Packit b099d7
and \fBXmNverticalFontUnit\fP\&.
Packit b099d7
.IP "\fBXm100TH_FONT_UNITS\fP" 10
Packit b099d7
All values provided to the widget are treated as 1/100 of a font unit\&.
Packit b099d7
A font unit has horizontal and vertical components\&. These are the
Packit b099d7
values of the \fBXmScreen\fP resources \fBXmNhorizontalFontUnit\fP and
Packit b099d7
\fBXmNverticalFontUnit\fP\&.
Packit b099d7
.RE
Packit b099d7
.IP "" 10
Packit b099d7
For more information about units, refer to the \fBXmConvertUnits\fP
Packit b099d7
reference page\&.
Packit b099d7
.IP "\fBXmNuseAsyncGeometry\fP" 10
Packit b099d7
Specifies whether the geometry manager should wait for confirmation of a
Packit b099d7
geometry request to the window manager\&.
Packit b099d7
When the value of this resource is True, the geometry manager forces
Packit b099d7
\fBXmNwaitForWm\fP to False and \fBXmNwmTimeout\fP to 0, and it relies
Packit b099d7
on asynchronous notification\&.
Packit b099d7
When the value of this resource is False, \fBXmNwaitForWm\fP and
Packit b099d7
\fBXmNwmTimeout\fP are unaffected\&.
Packit b099d7
The default is False\&.
Packit b099d7
Packit b099d7
.SS "Inherited Resources"
Packit b099d7
.PP
Packit b099d7
VendorShell inherits behavior and resources from the
Packit b099d7
superclasses described in the following tables\&.
Packit b099d7
For a complete description of each resource, refer to the
Packit b099d7
reference page for that superclass\&.
Packit b099d7
.TS
Packit b099d7
tab(?) box;
Packit b099d7
c s s s s
Packit b099d7
l| l| l| l| l.
Packit b099d7
\fBWMShell Resource Set\fP
Packit b099d7
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNbaseHeight?XmCBaseHeight?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNbaseWidth?XmCBaseWidth?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNheightInc?XmCHeightInc?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNiconMask?XmCIconMask?Pixmap?NULL?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNiconPixmap?XmCIconPixmap?Pixmap?NULL?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNiconWindow?XmCIconWindow?Window?NULL?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNiconX?XmCIconX?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNiconY?XmCIconY?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNinitialState?XmCInitialState?int?NormalState?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNinput?XmCInput?Boolean?True?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmaxAspectX?XmCMaxAspectX?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmaxAspectY?XmCMaxAspectY?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmaxHeight?XmCMaxHeight?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmaxWidth?XmCMaxWidth?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNminAspectX?XmCMinAspectX?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNminAspectY?XmCMinAspectY?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNminHeight?XmCMinHeight?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNminWidth?XmCMinWidth?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtitle?XmCTitle?String?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtitleEncoding?XmCTitleEncoding?Atom?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtransient?XmCTransient?Boolean?False?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNwaitForWm?XmCWaitForWm?Boolean?True?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNwidthInc?XmCWidthInc?int?XtUnspecifiedShellInt?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNwindowGroup?XmCWindowGroup?Window?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
mNwinGravity?XmCWinGravity?int?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNwmTimeout?XmCWmTimeout?int?5000 ms?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
.TE
Packit b099d7
.TS
Packit b099d7
tab(?) box;
Packit b099d7
c s s s s
Packit b099d7
l| l| l| l| l.
Packit b099d7
\fBShell Resource Set\fP
Packit b099d7
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNallowShellResize?XmCAllowShellResize?Boolean?False?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNcreatePopupChildProc?XmCCreatePopupChildProc?XtCreatePopupChildProc?NULL?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNgeometry?XmCGeometry?String?NULL?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNoverrideRedirect?XmCOverrideRedirect?Boolean?False?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNpopdownCallback?XmCCallback?XtCallbackList?NULL?C
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNpopupCallback?XmCCallback?XtCallbackList?NULL?C
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNsaveUnder?XmCSaveUnder?Boolean?False?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNvisual?XmCVisual?Visual *?CopyFromParent?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
.TE
Packit b099d7
.TS
Packit b099d7
tab(?) box;
Packit b099d7
c s s s s
Packit b099d7
l| l| l| l| l.
Packit b099d7
\fBComposite Resource Set\fP
Packit b099d7
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNchildren?XmCReadOnly?WidgetList?NULL?G
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNinsertPosition?XmCInsertPosition?XtOrderProc?NULL?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNnumChildren?XmCReadOnly?Cardinal?0?G
Packit b099d7
_?_?_?_?_?
Packit b099d7
.TE
Packit b099d7
.TS
Packit b099d7
tab(?) box;
Packit b099d7
c s s s s
Packit b099d7
l| l| l| l| l.
Packit b099d7
\fBCore Resource Set\fP
Packit b099d7
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNaccelerators?XmCAccelerators?XtAccelerators?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNancestorSensitive?XmCSensitive?Boolean?dynamic?G
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNbackground?XmCBackground?Pixel?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNbackgroundPixmap?XmCPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNborderColor?XmCBorderColor?Pixel?XtDefaultForeground?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNborderPixmap?XmCPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNborderWidth?XmCBorderWidth?Dimension?0?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNcolormap?XmCColormap?Colormap?dynamic?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNdepth?XmCDepth?int?dynamic?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNdestroyCallback?XmCCallback?XtCallbackList?NULL?C
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNheight?XmCHeight?Dimension?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNinitialResourcesPersistent?XmCInitialResourcesPersistent?Boolean?True?C
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNmappedWhenManaged?XmCMappedWhenManaged?Boolean?True?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNscreen?XmCScreen?Screen *?dynamic?CG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNsensitive?XmCSensitive?Boolean?True?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNtranslations?XmCTranslations?XtTranslations?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNwidth?XmCWidth?Dimension?dynamic?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNx?XmCPosition?Position?0?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
XmNy?XmCPosition?Position?0?CSG
Packit b099d7
_?_?_?_?_?
Packit b099d7
.TE
Packit b099d7
.SS "Translations"
Packit b099d7
.PP
Packit b099d7
There are no translations for VendorShell\&.
Packit b099d7
.SH "RELATED"
Packit b099d7
.PP
Packit b099d7
\fBComposite\fP(3),
Packit b099d7
\fBCore\fP(3),
Packit b099d7
\fBmwm\fP(1),
Packit b099d7
\fBShell\fP(3),
Packit b099d7
\fBWMShell\fP(3),
Packit b099d7
\fBXmActivateProtocol\fP(3),
Packit b099d7
\fBXmActivateWMProtocol\fP(3),
Packit b099d7
\fBXmAddProtocolCallback\fP(3),
Packit b099d7
\fBXmAddWMProtocolCallback\fP(3),
Packit b099d7
\fBXmAddProtocols\fP(3),
Packit b099d7
\fBXmAddWMProtocols\fP(3),
Packit b099d7
\fBXmDeactivateProtocol\fP(3),
Packit b099d7
\fBXmDeactivateWMProtocol\fP(3),
Packit b099d7
\fBXmGetAtomName\fP(3),
Packit b099d7
\fBXmInternAtom\fP(3),
Packit b099d7
\fBXmIsMotifWMRunning\fP(3),
Packit b099d7
\fBXmRemoveProtocolCallback\fP(3),
Packit b099d7
\fBXmRemoveWMProtocolCallback\fP(3),
Packit b099d7
\fBXmRemoveProtocols\fP(3),
Packit b099d7
\fBXmRemoveWMProtocols\fP(3),
Packit b099d7
\fBXmScreen\fP(3),
Packit b099d7
\fBXmSetProtocolHooks\fP(3),
Packit b099d7
and \fBXmSetWMProtocolHooks\fP(3)\&.
Packit b099d7
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:16