|
Packit |
b099d7 |
'\" t
|
|
Packit |
b099d7 |
...\" Display.sgm /main/17 1996/09/08 20:39:22 rws $
|
|
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 "XmDisplay" "library call"
|
|
Packit |
b099d7 |
.SH "NAME"
|
|
Packit |
b099d7 |
\fBXmDisplay\fP \(em The Display widget class
|
|
Packit |
b099d7 |
.iX "XmDisplay"
|
|
Packit |
b099d7 |
.iX "widget class" "XmDisplay"
|
|
Packit |
b099d7 |
.SH "SYNOPSIS"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
#include <Xm/Display\&.h>
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.SH "DESCRIPTION"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The XmDisplay object is used by the Motif widgets to store information
|
|
Packit |
b099d7 |
that is specific to a display\&. It also allows the toolkit to access
|
|
Packit |
b099d7 |
certain information on widget hierarchies that would otherwise be
|
|
Packit |
b099d7 |
unavailable\&. Each client has one XmDisplay object for each display
|
|
Packit |
b099d7 |
it accesses\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
An XmDisplay object is automatically created when the application
|
|
Packit |
b099d7 |
creates the first shell on a display (usually accomplished by a call to
|
|
Packit |
b099d7 |
\fBXtAppInitialize\fP or \fBXtAppCreateShell\fP)\&.
|
|
Packit |
b099d7 |
It is not necessary to create an XmDisplay object by any other means\&.
|
|
Packit |
b099d7 |
An application can use the function \fBXmGetXmDisplay\fP to obtain the
|
|
Packit |
b099d7 |
widget ID of the XmDisplay object for a given display\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
An application cannot supply initial values for XmDisplay resources as
|
|
Packit |
b099d7 |
arguments to a call to any function that creates widgets\&.
|
|
Packit |
b099d7 |
The application or user can supply initial values in a resource file\&.
|
|
Packit |
b099d7 |
After creating the first shell on the display, the application can use
|
|
Packit |
b099d7 |
\fBXmGetXmDisplay\fP to obtain the widget ID of the XmDisplay object and
|
|
Packit |
b099d7 |
then call \fBXtSetValues\fP to set the XmDisplay resources\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
XmDisplay resources specify the drag protocol style for a client
|
|
Packit |
b099d7 |
participating in drag and drop transactions\&. The two basic
|
|
Packit |
b099d7 |
protocol types are preregister and dynamic\&. When a preregister protocol
|
|
Packit |
b099d7 |
is used, the toolkit handles any communication between the initiator
|
|
Packit |
b099d7 |
and receiver clients and displays the appropriate drag-over and
|
|
Packit |
b099d7 |
drag-under visual effects\&. A client registers its drop sites in
|
|
Packit |
b099d7 |
advance and this information is stored in a property for each
|
|
Packit |
b099d7 |
top-level window\&. When the drag pointer enters a top-level window,
|
|
Packit |
b099d7 |
the drop site information is read by the initiator\&. A dynamic
|
|
Packit |
b099d7 |
protocol allows the source and destination clients to dynamically
|
|
Packit |
b099d7 |
communicate drag and drop state information between each other, and
|
|
Packit |
b099d7 |
to update their respective visuals accordingly\&. The toolkit provides
|
|
Packit |
b099d7 |
drop site information as the pointer passes over any given drop site\&.
|
|
Packit |
b099d7 |
In this mode, a receiver can supply a procedure to generate its
|
|
Packit |
b099d7 |
own drag-under effects\&.
|
|
Packit |
b099d7 |
.SS "Classes"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Display inherits behavior and resources from \fBCore\fP, \fBComposite\fP,
|
|
Packit |
b099d7 |
\fBShell\fP, \fBWMShell\fP, \fBVendorShell\fP, \fBTopLevelShell\fP, and
|
|
Packit |
b099d7 |
\fBApplicationShell\fP classes\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class pointer is \fBxmDisplayClass\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class name is \fBXmDisplay\fP\&.
|
|
Packit |
b099d7 |
.SS "New Resources"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The following table defines a set of widget resources used by the
|
|
Packit |
b099d7 |
programmer to specify data\&. The programmer can also set the resource
|
|
Packit |
b099d7 |
values for the inherited classes to set attributes for this widget\&.
|
|
Packit |
b099d7 |
To reference a resource by name or by class in a \fB\&.Xdefaults\fP file,
|
|
Packit |
b099d7 |
remove the \fBXmN\fP or \fBXmC\fP prefix and use the remaining letters\&.
|
|
Packit |
b099d7 |
To specify one of the defined values for a resource in a \fB\&.Xdefaults\fP
|
|
Packit |
b099d7 |
file, remove the \fBXm\fP prefix and use the remaining letters (in
|
|
Packit |
b099d7 |
either lowercase or uppercase, but include any underscores between
|
|
Packit |
b099d7 |
words)\&. The codes in the access column indicate if the given resource
|
|
Packit |
b099d7 |
can be set at creation time (C), set by using XtSetValues
|
|
Packit |
b099d7 |
(S), retrieved by using XtGetValues (G), or is not
|
|
Packit |
b099d7 |
applicable (N/A)\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c s s s s
|
|
Packit |
b099d7 |
l| l| l| l| l.
|
|
Packit |
b099d7 |
\fBXmDisplay Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNdefaultButtonEmphasis?XmCDefaultButtonEmphasis?XtEnum?XmEXTERNAL_HIGHLIGHT?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNdefaultVirtualBindings?XmCDefaultVirtualBindings?String?dynamic?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNdragInitiatorProtocolStyle?XmCDragInitiatorProtocolStyle?unsigned char?XmDRAG_PREFER_RECEIVER?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNdragReceiverProtocolStyle?XmCDragReceiverProtocolStyle?unsigned char?XmDRAG_PREFER_DYNAMIC?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNdragStartCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNenableBtn1Transfer?XmCEnableBtn1Transfer?XtEnum?XmOFF?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNenableButtonTab?XmCEnableButtonTab?Boolean?False?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNenableDragIcon?XmCEnableDragIcon?Boolean?False?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNenableEtchedInMenu?XmCEnableEtchedInMenu?Boolean?False?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNenableToggleColor?XmCEnableToggleColor?Boolean?False?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNenableToggleVisual?XmCEnableToggleVisual?Boolean?False?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNenableUnselectableDrag?XmCEnableUnselectableDrag?Boolean?True?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNenableWarp?XmCEnableWarp?XtEnum?True?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmotifVersion?XmCMotifVersion?int?XmVERSION?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNnoFontCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNnoRenditionCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNuserData?XmCUserData?XtPointer?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.IP "\fBXmNdefaultButtonEmphasis\fP" 10
|
|
Packit |
b099d7 |
Specifies whether to change the look of the PushButton widget and
|
|
Packit |
b099d7 |
gadget that have the \fBXmNshowAsDefault\fP resource set\&. When the
|
|
Packit |
b099d7 |
PushButton is the default, it has an etched out button which is
|
|
Packit |
b099d7 |
enclosed with another etched in border\&. The
|
|
Packit |
b099d7 |
\fBXmNdefaultButtonEmphasis\fP has the follow possible values, which
|
|
Packit |
b099d7 |
affect the location cursor:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmINTERNAL_HIGHLIGHT\fP" 10
|
|
Packit |
b099d7 |
Causes the location cursor to appear in between the two etched borders
|
|
Packit |
b099d7 |
to minimize the space required\&.
|
|
Packit |
b099d7 |
.IP "\fBXmEXTERNAL_HIGHLIGHT\fP" 10
|
|
Packit |
b099d7 |
Causes the PushButton to draw the location cursor outside the second border\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "\fBXmNdefaultVirtualBindings\fP" 10
|
|
Packit |
b099d7 |
Specifies the default virtual bindings for the display\&.
|
|
Packit |
b099d7 |
Following is an example of a specification for the
|
|
Packit |
b099d7 |
\fBdefaultVirtualBindings\fP resource in a resource file:
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
\f(CW*defaultVirtualBindings: \e
|
|
Packit |
b099d7 |
osfBackSpace: <Key>BackSpace \en\e
|
|
Packit |
b099d7 |
osfInsert: <Key>InsertChar \en\e
|
|
Packit |
b099d7 |
osfDelete: <Key>DeleteChar \en\e
|
|
Packit |
b099d7 |
\&.\&.\&.
|
|
Packit |
b099d7 |
osfLeft: <Key>left, Ctrl<Key>H\fR
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.IP "\fBXmNdragInitiatorProtocolStyle\fP" 10
|
|
Packit |
b099d7 |
Specifies the drag and drop protocol requirements or preference when
|
|
Packit |
b099d7 |
the client is an initiator\&. The possible values are
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_PREREGISTER\fP" 10
|
|
Packit |
b099d7 |
As an initiator, this client does not use the dynamic protocol and
|
|
Packit |
b099d7 |
can only arrange visual effects with receivers who provide
|
|
Packit |
b099d7 |
preregistered information\&.
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_DYNAMIC\fP" 10
|
|
Packit |
b099d7 |
As an initiator, this client does not make use of any preregistered
|
|
Packit |
b099d7 |
drop site information made available by other clients, and can only
|
|
Packit |
b099d7 |
arrange visual effects with receivers who use the dynamic protocol\&.
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_NONE\fP" 10
|
|
Packit |
b099d7 |
Specifies that drag and drop is disabled for this client\&.
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_DROP_ONLY\fP" 10
|
|
Packit |
b099d7 |
As an initiator, this client does not use either the preregistered
|
|
Packit |
b099d7 |
drop site information or the dynamic protocol\&. It supports dragging,
|
|
Packit |
b099d7 |
and any time the cursor is over a client that supports drag and
|
|
Packit |
b099d7 |
drop, valid feedback is provided\&. There are no other visual effects\&.
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_PREFER_DYNAMIC\fP" 10
|
|
Packit |
b099d7 |
As an initiator, this client can support both the preregister and
|
|
Packit |
b099d7 |
dynamic protocols, but prefers to use dynamic protocols whenever
|
|
Packit |
b099d7 |
possible in order to provide high-quality drag-under feedback\&.
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_PREFER_PREREGISTER\fP" 10
|
|
Packit |
b099d7 |
As an initiator, this client can support both the preregister and
|
|
Packit |
b099d7 |
dynamic protocols, but prefers to use the preregister protocol
|
|
Packit |
b099d7 |
whenever possible in order to accommodate performance needs or to
|
|
Packit |
b099d7 |
provide consistent drag-over feedback\&.
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_PREFER_RECEIVER\fP" 10
|
|
Packit |
b099d7 |
Indicates that this client can support both preregister and dynamic
|
|
Packit |
b099d7 |
protocols, but will defer to the preference of the receiver client\&.
|
|
Packit |
b099d7 |
This value is valid only for the \fBXmNdragInitiatorProtocolStyle\fP
|
|
Packit |
b099d7 |
resource, and is its default value\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "\fBXmNdragReceiverProtocolStyle\fP" 10
|
|
Packit |
b099d7 |
Specifies the drag and drop protocol requirements or preference
|
|
Packit |
b099d7 |
when this client is a receiver\&. The values are
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_PREREGISTER\fP" 10
|
|
Packit |
b099d7 |
As a receiver, this client preregisters drop site information and
|
|
Packit |
b099d7 |
does not use the dynamic protocol\&. It can only arrange visual
|
|
Packit |
b099d7 |
effects with initiators who make use of the preregistered information\&.
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_DYNAMIC\fP" 10
|
|
Packit |
b099d7 |
As a receiver, this client uses the dynamic protocol and does
|
|
Packit |
b099d7 |
not preregister drop site information\&. It can only arrange visual
|
|
Packit |
b099d7 |
effects with initiators who use the dynamic protocol\&.
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_NONE\fP" 10
|
|
Packit |
b099d7 |
Specifies that drag and drop is disabled for this client\&.
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_DROP_ONLY\fP" 10
|
|
Packit |
b099d7 |
As a receiver, this client neither uses the dynamic protocol
|
|
Packit |
b099d7 |
nor preregisters drop site information\&. It supports
|
|
Packit |
b099d7 |
dropping, and when dragging over this client, valid feedback
|
|
Packit |
b099d7 |
is always provided, but there are no other visual effects\&.
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_PREFER_DYNAMIC\fP" 10
|
|
Packit |
b099d7 |
As a receiver, this client can support both the preregister and
|
|
Packit |
b099d7 |
dynamic protocols, but prefers to use the dynamic protocol whenever
|
|
Packit |
b099d7 |
possible in order to provide high-quality drag-under feedback\&.
|
|
Packit |
b099d7 |
.IP "\fBXmDRAG_PREFER_PREREGISTER\fP" 10
|
|
Packit |
b099d7 |
As a receiver, this client can support both the preregister and
|
|
Packit |
b099d7 |
dynamic protocols, but prefers to use the preregister protocol
|
|
Packit |
b099d7 |
whenever possible in order to accommodate performance
|
|
Packit |
b099d7 |
needs\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
The default value of this resource is dependent on the capabilities of
|
|
Packit |
b099d7 |
the display\&. If the display supports the shape extension, allowing the
|
|
Packit |
b099d7 |
dynamic protocol to use arbitrarily sized drag cursors, the default of
|
|
Packit |
b099d7 |
this resource is \fBXmDRAG_PREFER_DYNAMIC\fP, otherwise the default is
|
|
Packit |
b099d7 |
\fBXmDRAG_PREFER_PREREGISTER\fP\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
The actual protocol used between an initiator and a receiver
|
|
Packit |
b099d7 |
is based on the protocol style of the receiver and initiator\&. The
|
|
Packit |
b099d7 |
decision matrix is described in the following table\&.
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
c| c s s s c
|
|
Packit |
b099d7 |
^| l| l| l| l l.
|
|
Packit |
b099d7 |
\fBDrag Initiator
|
|
Packit |
b099d7 |
Protocol Style\fP?\fBDrag Receiver Protocol Style\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?_?
|
|
Packit |
b099d7 |
?\fBPreregister\fP?\fBPrefer Preregister\fP?\fBPrefer Dynamic\fP?\fBDynamic\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?_?
|
|
Packit |
b099d7 |
\fBPreregister\fP?Preregister?Preregister?Preregister?Drop Only
|
|
Packit |
b099d7 |
_?_?_?_?_?_?
|
|
Packit |
b099d7 |
\fBPrefer Preregister\fP?Preregister?Preregister?Preregister?Dynamic
|
|
Packit |
b099d7 |
_?_?_?_?_?_?
|
|
Packit |
b099d7 |
\fBPrefer Receiver\fP?Preregister?Preregister?Dynamic?Dynamic
|
|
Packit |
b099d7 |
_?_?_?_?_?_?
|
|
Packit |
b099d7 |
\fBPrefer Dynamic\fP?Preregister?Dynamic?Dynamic?Dynamic
|
|
Packit |
b099d7 |
_?_?_?_?_?_?
|
|
Packit |
b099d7 |
\fBDynamic\fP?Drop Only?Dynamic?Dynamic?Dynamic
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
The value \fBXmDRAG_NONE\fP does not appear in the
|
|
Packit |
b099d7 |
matrix\&. When specified for either the initiator or receiver side,
|
|
Packit |
b099d7 |
\fBXmDRAG_NONE\fP implies that drag and drop transactions are not
|
|
Packit |
b099d7 |
supported\&. A value of \fBXmDRAG_DROP_ONLY\fP (Drop Only) results
|
|
Packit |
b099d7 |
when an initiator and receiver cannot compromise protocol styles,
|
|
Packit |
b099d7 |
that is, one client requires dynamic mode while the other
|
|
Packit |
b099d7 |
can only support preregister mode, or if either explicitly has
|
|
Packit |
b099d7 |
specified \fBXmDRAG_DROP_ONLY\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNdragStartCallback\fP" 10
|
|
Packit |
b099d7 |
Specifies the list of callbacks that are invoked when the
|
|
Packit |
b099d7 |
\fBXmDragStart\fP function is called\&. The type of structure whose
|
|
Packit |
b099d7 |
address is passed to this callback is \fBXmDragStartCallbackStruct\fR\&.
|
|
Packit |
b099d7 |
The callback reason
|
|
Packit |
b099d7 |
is \fBXmCR_DRAG_START\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNenableBtn1Transfer\fP" 10
|
|
Packit |
b099d7 |
Specifies if selection and transfer actions are integrated on Btn1
|
|
Packit |
b099d7 |
and extend actions are activated on Btn2\&. This resource
|
|
Packit |
b099d7 |
can take the following values:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmOFF\fP" 10
|
|
Packit |
b099d7 |
Disables integration and selection activation on Btn1\&.
|
|
Packit |
b099d7 |
.IP "\fBXmBUTTON2_TRANSFER\fP" 10
|
|
Packit |
b099d7 |
Enables integration and selection activation on Btn1 and transfer on Btn2\&.
|
|
Packit |
b099d7 |
.IP "\fBXmBUTTON2_ADJUST\fP" 10
|
|
Packit |
b099d7 |
Enables integration and selection activation on Btn1 and adjust on Btn2\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
This
|
|
Packit |
b099d7 |
resource affects the actions of Text, TextField, List, and Container\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNenableButtonTab\fP" 10
|
|
Packit |
b099d7 |
Specifies if the action for the
|
|
Packit |
b099d7 |
\fB<Tab>\fP key (\fBKNextField\fP and \fBKPrevField\fP actions) is to be modified\&.
|
|
Packit |
b099d7 |
A value of True modifies the key to move as an arrow key until the
|
|
Packit |
b099d7 |
boundary of a tab group is reached\&. Then, at the boundary of the
|
|
Packit |
b099d7 |
tab group, \fBKNextField\fP and \fBKPrevField\fP will move to the next
|
|
Packit |
b099d7 |
or previous tab group, respectively\&. A value of False does not cause
|
|
Packit |
b099d7 |
modification\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNenableDragIcon\fP" 10
|
|
Packit |
b099d7 |
Specifies which set of icons are to be used for system default cursors
|
|
Packit |
b099d7 |
during drag and drop operations\&. A value of False specifies that
|
|
Packit |
b099d7 |
earlier versions of Motif release icons are used, a value of True
|
|
Packit |
b099d7 |
specifies that
|
|
Packit |
b099d7 |
alternate icons are used\&. This resource affects both the 16x16 and
|
|
Packit |
b099d7 |
the 32x32 icons that the system defaults for each of the Screen
|
|
Packit |
b099d7 |
objects associated with this display\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNenableEtchedInMenu\fP" 10
|
|
Packit |
b099d7 |
Specifies the shadowing of the button widgets and gadgets in menus
|
|
Packit |
b099d7 |
when the control is activated\&. A value of True causes the selected
|
|
Packit |
b099d7 |
menu to be drawn with the shadow etched in; this shadow style is
|
|
Packit |
b099d7 |
consistent with the selected appearance of other button widgets
|
|
Packit |
b099d7 |
outside of menus\&. A value of False causes
|
|
Packit |
b099d7 |
the selected menu to be draw with the shadow etched out\&. This
|
|
Packit |
b099d7 |
resource affects the actions of PushButton, ToggleButton, and
|
|
Packit |
b099d7 |
CascadeButton widgets and gadgets when they are children of Menu\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
When this resource is set, the background of a button in a menu
|
|
Packit |
b099d7 |
uses the \fBXmNselectColor\fP
|
|
Packit |
b099d7 |
(derived from the \fBXmNselectPixel\fP) when armed
|
|
Packit |
b099d7 |
as a default\&. A \fBPushButton\fP
|
|
Packit |
b099d7 |
uses the \fBXmNarmColor\fP
|
|
Packit |
b099d7 |
if it is defined\&. A \fBToggleButton\fP
|
|
Packit |
b099d7 |
uses the \fBXmNselectColor\fP
|
|
Packit |
b099d7 |
if \fBXmNindicatorOn\fP
|
|
Packit |
b099d7 |
is \fBFalse\fP and \fBXmNfillOnSelect\fP
|
|
Packit |
b099d7 |
is \fBTrue\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNenableToggleColor\fP" 10
|
|
Packit |
b099d7 |
Specifies how to determine the default value of the
|
|
Packit |
b099d7 |
\fBXmNselectColor\fP resource of ToggleButton and ToggleButtonGadget\&.
|
|
Packit |
b099d7 |
A value of True causes the default value of \fBXmNselectColor\fP
|
|
Packit |
b099d7 |
to be set to the value of \fBXmNhighlightColor\fP\&.
|
|
Packit |
b099d7 |
A value of False causes the default value of \fBXmNselectColor\fP
|
|
Packit |
b099d7 |
to be set to the value of \fBXmNbackground\fP\&.
|
|
Packit |
b099d7 |
This resource only affects the appearance of ToggleButton
|
|
Packit |
b099d7 |
widgets and gadgets that are in \fBXmONE_OF_MANY\fP or
|
|
Packit |
b099d7 |
\fBXmONE_OF_MANY_ROUND\fP mode\&. In addition, \fBXmNenableToggleColor\fP
|
|
Packit |
b099d7 |
only influences the default value of \fBXmNselectColor\fP\&. That is,
|
|
Packit |
b099d7 |
if the user or application sets a value for \fBXmNselectColor\fP,
|
|
Packit |
b099d7 |
then \fBXmNenableToggleColor\fP is ignored\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNenableToggleVisual\fP" 10
|
|
Packit |
b099d7 |
Specifies the visual appearance of the ToggleButton widget and/or
|
|
Packit |
b099d7 |
gadget\&. This resource affects the default value of the ToggleButton[Gadget]
|
|
Packit |
b099d7 |
\fBXmNindicatorType\fP and \fBXmNindicatorOn\fP resources\&. When the
|
|
Packit |
b099d7 |
ToggleButton is in a RadioBox, a value of True causes the
|
|
Packit |
b099d7 |
\fBXmONE_OF_MANY_ROUND\fP (a shadowed circle) to be the default\&.
|
|
Packit |
b099d7 |
Otherwise, when this resource is True, the ToggleButton
|
|
Packit |
b099d7 |
\fBXmNindicatorOn\fP resource causes a default of \fBXmN_OF_MANY\fP,
|
|
Packit |
b099d7 |
which will be a shadowed square with a check mark (check box)\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
A value of False causes the following:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmONE_OF_MANY\fP" 10
|
|
Packit |
b099d7 |
Is a shadowed diamond\&.
|
|
Packit |
b099d7 |
.IP "\fBXmN_OF_MANY\fP" 10
|
|
Packit |
b099d7 |
Is a shadowed square\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "\fBXmNenableUnselectableDrag\fP" 10
|
|
Packit |
b099d7 |
Specifies whether or not it is possible to drag from Label and Scale\&.
|
|
Packit |
b099d7 |
A value of True enables the drag; a value of False disables it\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNenableWarp\fP" 10
|
|
Packit |
b099d7 |
Specifies if an application is allowed to warp the pointer
|
|
Packit |
b099d7 |
from the user\&. A value of True enables warping, a value of False does not\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNmotifVersion\fP" 10
|
|
Packit |
b099d7 |
Specifies the current version of Motif that the current implementation
|
|
Packit |
b099d7 |
is supposed to
|
|
Packit |
b099d7 |
behave like\&. By default, this resource gets its value from release
|
|
Packit |
b099d7 |
values in \fBXm\&.h\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNnoFontCallback\fP" 10
|
|
Packit |
b099d7 |
This callback is called whenever a rendition attempts to load a font
|
|
Packit |
b099d7 |
or fontset and fails\&. This can happen on creation if the font is
|
|
Packit |
b099d7 |
specified as \fBXmLOAD_IMMEDIATE\fP or when an attempt is made to
|
|
Packit |
b099d7 |
render an \fBXmString\fR using a font specified as
|
|
Packit |
b099d7 |
\fBXmLOAD_DEFERRED\fP\&. An application can have this callback attempt
|
|
Packit |
b099d7 |
to remedy this problem by calling \fBXmRenditionUpdate\fP on the input
|
|
Packit |
b099d7 |
rendition to provide a font for the widget to use\&. This may be done by
|
|
Packit |
b099d7 |
either providing an an alternative font name to be loaded using the
|
|
Packit |
b099d7 |
\fBXmNfontName\fP and \fBXmNfontType\fP resources or with an already
|
|
Packit |
b099d7 |
loaded font using the \fBXmNfont\fP resource\&. The callback reason is
|
|
Packit |
b099d7 |
\fBXmCR_NO_FONT\fP\&. This callback uses the
|
|
Packit |
b099d7 |
\fBXmDisplayCallbackStruct\fR structure\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNnoRenditionCallback\fP" 10
|
|
Packit |
b099d7 |
This callback is called whenever an attempt is made to render a
|
|
Packit |
b099d7 |
segment with a \fBRENDITION\fP tag which does not match any renditions
|
|
Packit |
b099d7 |
in a given render table\&. The callback reason is
|
|
Packit |
b099d7 |
\fBXmCR_NO_RENDITION\fP\&. This callback uses the
|
|
Packit |
b099d7 |
\fBXmDisplayCallbackStruct\fR structure\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
An application can have this callback attempt to remedy this problem
|
|
Packit |
b099d7 |
by creating a new
|
|
Packit |
b099d7 |
rendition with the given tag and adding it to \fBrender_table\fP\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
The \fBXmNnoRenditionCallback\fP should deallocate the render table passed in
|
|
Packit |
b099d7 |
in the \fBrender_table\fP field of the callback structure\&. Note that
|
|
Packit |
b099d7 |
the table
|
|
Packit |
b099d7 |
will automatically be deallocated if the
|
|
Packit |
b099d7 |
\fBXmRenderTableAddRenditions\fP function is
|
|
Packit |
b099d7 |
called on it\&. The callback should NOT deallocate the modified render
|
|
Packit |
b099d7 |
table that is passed back to Motif in the \fBrender_table\fP
|
|
Packit |
b099d7 |
field\&. If the
|
|
Packit |
b099d7 |
application wishes to manipulate this render table further, it should
|
|
Packit |
b099d7 |
make a copy with the \fBXmRenderTableCopy\fP function before returning
|
|
Packit |
b099d7 |
from the callback\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNuserData\fP" 10
|
|
Packit |
b099d7 |
Specifies a client data pointer for applications\&. An internally
|
|
Packit |
b099d7 |
unused resource\&.
|
|
Packit |
b099d7 |
.SS "Inherited Resources"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
All of the superclass resources inherited by XmDisplay are
|
|
Packit |
b099d7 |
designated N/A (not applicable)\&.
|
|
Packit |
b099d7 |
.SS "Callback Information"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
A pointer to the following structure is passed to the
|
|
Packit |
b099d7 |
\fBXmNdragStartCallback\fP callback:
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
typedef struct
|
|
Packit |
b099d7 |
{
|
|
Packit |
b099d7 |
int \fIreason\fP;
|
|
Packit |
b099d7 |
XEvent *\fIevent\fP;
|
|
Packit |
b099d7 |
Widget \fItimeStamp\fP;
|
|
Packit |
b099d7 |
Boolean \fIdoit\fP;
|
|
Packit |
b099d7 |
}XmDragStartCallbackStruct;
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.IP "\fIreason\fP" 10
|
|
Packit |
b099d7 |
Indicates why the callback was invoked
|
|
Packit |
b099d7 |
.IP "\fIevent\fP" 10
|
|
Packit |
b099d7 |
Points to the \fBXEvent\fP that triggered the callback
|
|
Packit |
b099d7 |
.IP "\fIwidget\fP" 10
|
|
Packit |
b099d7 |
Indicates the ID of the widget from which the drag was initiated\&.
|
|
Packit |
b099d7 |
.IP "\fIdoit\fP" 10
|
|
Packit |
b099d7 |
Is an IN/OUT member that allows the callback to determine whether to
|
|
Packit |
b099d7 |
continue with the drag or cancel\&. Setting \fIdoit\fP to
|
|
Packit |
b099d7 |
False will cancel the drag\&. The default value is NULL\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
A pointer to the following structure is passed to the
|
|
Packit |
b099d7 |
\fBXmNnoFontCallback\fP and \fBXmNnoRenditionCallback\fP callbacks:
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
typedef struct
|
|
Packit |
b099d7 |
{
|
|
Packit |
b099d7 |
int \fIreason\fP;
|
|
Packit |
b099d7 |
XEvent *\fIevent\fP;
|
|
Packit |
b099d7 |
XmRendition \fIrendition\fP;
|
|
Packit |
b099d7 |
char *\fIfont_name\fP;
|
|
Packit |
b099d7 |
XmRenderTable \fIrender_table\fP;
|
|
Packit |
b099d7 |
XmStringTag \fItag\fP;
|
|
Packit |
b099d7 |
}XmDisplayCallbackStruct;
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.IP "\fIreason\fP" 10
|
|
Packit |
b099d7 |
Indicates why the callback was invoked\&.
|
|
Packit |
b099d7 |
.IP "\fIevent\fP" 10
|
|
Packit |
b099d7 |
Points to the \fBXEvent\fP that triggered the callback\&. It can be NULL\&.
|
|
Packit |
b099d7 |
.IP "\fIrendition\fP" 10
|
|
Packit |
b099d7 |
Specifies the rendition with the missing font\&.
|
|
Packit |
b099d7 |
.IP "\fIfont_name\fP" 10
|
|
Packit |
b099d7 |
Specifies the name of the font or font set which could not be loaded\&.
|
|
Packit |
b099d7 |
.IP "\fBrender_table\fP" 10
|
|
Packit |
b099d7 |
Specifies the render table with the missing rendition\&.
|
|
Packit |
b099d7 |
.IP "\fItag\fP" 10
|
|
Packit |
b099d7 |
Specifies the tag of the missing rendition\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The following table describes the reasons for which the individual
|
|
Packit |
b099d7 |
callback structure fields are valid\&.
|
|
Packit |
b099d7 |
.TS
|
|
Packit |
b099d7 |
tab(?) box;
|
|
Packit |
b099d7 |
l| l.
|
|
Packit |
b099d7 |
\fBReason\fP?\fBValid Fields\fP
|
|
Packit |
b099d7 |
_?_?
|
|
Packit |
b099d7 |
XmCR_NO_FONT?\fIrendition, font_name\fP
|
|
Packit |
b099d7 |
_?_?
|
|
Packit |
b099d7 |
XmCR_NO_RENDITION?\fIrender_table, tag\fP
|
|
Packit |
b099d7 |
_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.SH "RELATED"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
\fBApplicationShell\fP(3),
|
|
Packit |
b099d7 |
\fBComposite\fP(3),
|
|
Packit |
b099d7 |
\fBCore\fP(3),
|
|
Packit |
b099d7 |
\fBTopLevelShell\fP(3),
|
|
Packit |
b099d7 |
\fBVendorShell\fP(3),
|
|
Packit |
b099d7 |
\fBWMShell\fP(3),
|
|
Packit |
b099d7 |
\fBXmGetXmDisplay\fP(3), and
|
|
Packit |
b099d7 |
\fBXmScreen\fP(3)\&.
|
|
Packit |
b099d7 |
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:22
|