|
Packit |
b099d7 |
'\" t
|
|
Packit |
b099d7 |
...\" Label.sgm /main/9 1996/09/08 20:49:33 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 "XmLabel" "library call"
|
|
Packit |
b099d7 |
.SH "NAME"
|
|
Packit |
b099d7 |
\fBXmLabel\fP \(em The Label widget class
|
|
Packit |
b099d7 |
.iX "XmLabel"
|
|
Packit |
b099d7 |
.iX "widget class" "Label"
|
|
Packit |
b099d7 |
.SH "SYNOPSIS"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
#include <Xm/Label\&.h>
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.SH "DESCRIPTION"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Label is an instantiable widget and is also used as a superclass for
|
|
Packit |
b099d7 |
other button widgets, such as PushButton and ToggleButton\&. The Label
|
|
Packit |
b099d7 |
widget does not accept any button or key input, and the help
|
|
Packit |
b099d7 |
callback is the only callback defined\&. Label also receives enter
|
|
Packit |
b099d7 |
and leave events\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Label can contain either text or a pixmap\&. Label text is a
|
|
Packit |
b099d7 |
compound string\&. Refer to the \fIMotif Programmer\&'s Guide\fP
|
|
Packit |
b099d7 |
for more information on compound strings\&.
|
|
Packit |
b099d7 |
The text can be multilingual,
|
|
Packit |
b099d7 |
multiline, and/or multifont\&. When a Label is insensitive, its text is
|
|
Packit |
b099d7 |
stippled, or the user-supplied insensitive pixmap is displayed\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Label supports both accelerators and mnemonics primarily for use in
|
|
Packit |
b099d7 |
Label subclass widgets that are contained in menus\&.
|
|
Packit |
b099d7 |
Mnemonics are available in a menu system when the button is visible\&.
|
|
Packit |
b099d7 |
Accelerators in a menu system are accessible even when the button is not
|
|
Packit |
b099d7 |
visible\&.
|
|
Packit |
b099d7 |
The Label widget displays the mnemonic by underlining the first matching
|
|
Packit |
b099d7 |
character in the text string\&.
|
|
Packit |
b099d7 |
The accelerator is displayed
|
|
Packit |
b099d7 |
as a text string adjacent to the label text or pixmap, depending on
|
|
Packit |
b099d7 |
the layout direction\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Label consists of many margin fields surrounding the text or pixmap\&.
|
|
Packit |
b099d7 |
These margin fields are resources that may
|
|
Packit |
b099d7 |
be set by the user, but Label subclasses and Manager parents also
|
|
Packit |
b099d7 |
modify some of these fields\&. They tend to modify the
|
|
Packit |
b099d7 |
\fBXmNmarginLeft\fP, \fBXmNmarginRight\fP, \fBXmNmarginTop\fP, and
|
|
Packit |
b099d7 |
\fBXmNmarginBottom\fP resources and leave the \fBXmNmarginWidth\fP and
|
|
Packit |
b099d7 |
\fBXmNmarginHeight\fP resources as set by the application\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Label takes into account \fBXmNshadowThickness\fP in determining
|
|
Packit |
b099d7 |
its layout but does not draw the shadow\&. That is, if \fBXmNshadowThickness\fP
|
|
Packit |
b099d7 |
is greater than 0 (zero), Label leaves space for the shadow, but the shadow
|
|
Packit |
b099d7 |
does not appear\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
In a Label, \fBXmNtraversalOn\fP and \fBXmNhighlightOnEnter\fP are forced
|
|
Packit |
b099d7 |
to False inside Popup menu panes, Pulldown menu panes, and OptionMenus\&.
|
|
Packit |
b099d7 |
Otherwise, these resources default to False\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Label uses the \fBXmQTmenuSystem\fP and \fBXmQTspecifyRenderTable\fP
|
|
Packit |
b099d7 |
traits, and
|
|
Packit |
b099d7 |
holds the \fBXmQTaccessTextual\fP, \fBXmQTmenuSavvy\fP, and
|
|
Packit |
b099d7 |
\fBXmQTtransfer\fP traits\&.
|
|
Packit |
b099d7 |
.SS "Data Transfer Behavior"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Label and it subclasses, except when used in a menu system, support
|
|
Packit |
b099d7 |
dragging of the label contents from the Label\&.
|
|
Packit |
b099d7 |
However, the label contents are draggable only if
|
|
Packit |
b099d7 |
the \fBXmNenableUnselectableDrag\fP resource of \fBXmDisplay\fP
|
|
Packit |
b099d7 |
is set to True\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
As a source of data, Label and its subclasses support the following
|
|
Packit |
b099d7 |
targets and associated conversions of data to these targets:
|
|
Packit |
b099d7 |
.IP "\fIlocale\fP" 10
|
|
Packit |
b099d7 |
If the \fIlocale\fP target matches the widget\&'s locale, the widget
|
|
Packit |
b099d7 |
transfers \fBXmNlabelString\fP in the encoding of the locale\&.
|
|
Packit |
b099d7 |
This target is supported when \fBXmNlabelType\fP is \fBXmSTRING\fP or
|
|
Packit |
b099d7 |
\fBXmPIXMAP_AND_STRING\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBCOMPOUND_TEXT\fP" 10
|
|
Packit |
b099d7 |
The widget transfers \fBXmNlabelString\fP as type \fBCOMPOUND_TEXT\fP\&.
|
|
Packit |
b099d7 |
This target is supported when \fBXmNlabelType\fP is \fBXmSTRING\fP or
|
|
Packit |
b099d7 |
\fBXmPIXMAP_AND_STRING\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBUTF8_STRING\fP" 10
|
|
Packit |
b099d7 |
The widget transfers \fBXmNlabelString\fP as type \fBUTF8_STRING\fP\&.
|
|
Packit |
b099d7 |
This target is supported when \fBXmNlabelType\fP is \fBXmSTRING\fP or
|
|
Packit |
b099d7 |
\fBXmPIXMAP_AND_STRING\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBPIXMAP\fP" 10
|
|
Packit |
b099d7 |
The widget transfers \fBXmNlabelPixmap\fP as type \fBDRAWABLE\fP\&.
|
|
Packit |
b099d7 |
This target is supported when \fBXmNlabelType\fP is \fBXmPIXMAP\fP or
|
|
Packit |
b099d7 |
\fBXmPIXMAP_AND_STRING\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBSTRING\fP" 10
|
|
Packit |
b099d7 |
The widget transfers \fBXmNlabelString\fP as type \fBSTRING\fP\&.
|
|
Packit |
b099d7 |
This target is supported when \fBXmNlabelType\fP is \fBXmSTRING\fP or
|
|
Packit |
b099d7 |
\fBXmPIXMAP_AND_STRING\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBTEXT\fP" 10
|
|
Packit |
b099d7 |
If \fBXmNlabelString\fP is fully convertible to the encoding of the
|
|
Packit |
b099d7 |
locale, the widget transfers \fBXmNlabelString\fP in the encoding of
|
|
Packit |
b099d7 |
the locale\&.
|
|
Packit |
b099d7 |
Otherwise, the widget transfers \fBXmNlabelString\fP as type
|
|
Packit |
b099d7 |
\fBCOMPOUND_TEXT\fP\&.
|
|
Packit |
b099d7 |
This target is supported only when \fBXmNlabelType\fP is \fBXmSTRING\fP or
|
|
Packit |
b099d7 |
\fBXmPIXMAP_AND_STRING\fP\&.
|
|
Packit |
b099d7 |
.IP "\fB_MOTIF_CLIPBOARD_TARGETS\fP" 10
|
|
Packit |
b099d7 |
The widget transfers, as type \fBATOM\fP, a list of the targets it
|
|
Packit |
b099d7 |
supports for the \fBCLIPBOARD\fP selection\&.
|
|
Packit |
b099d7 |
When \fBXmNlabelType\fP is \fBXmSTRING\fP or \fBXmPIXMAP_AND_STRING\fP,
|
|
Packit |
b099d7 |
these include the following targets:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
\fB_MOTIF_COMPOUND_STRING\fP
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
\fBCOMPOUND_TEXT\fP
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
\fBUTF8_STRING\fP
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
The encoding of the locale, if \fBXmNlabelString\fP is fully convertible
|
|
Packit |
b099d7 |
to the encoding of the locale
|
|
Packit |
b099d7 |
.IP " \(bu" 6
|
|
Packit |
b099d7 |
\fBSTRING\fP, if \fBXmNlabelString\fP is fully convertible to
|
|
Packit |
b099d7 |
\fBSTRING\fP
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
When \fBXmNlabelType\fP is \fBXmPIXMAP\fP or \fBXmPIXMAP_AND_STRING\fP,
|
|
Packit |
b099d7 |
the targets include \fBPIXMAP\fP\&.
|
|
Packit |
b099d7 |
.IP "\fB_MOTIF_COMPOUND_STRING\fP" 10
|
|
Packit |
b099d7 |
The widget transfers \fBXmNlabelString\fP as a compound string in
|
|
Packit |
b099d7 |
Byte Stream format\&.
|
|
Packit |
b099d7 |
This target is supported when \fBXmNlabelType\fP is \fBXmSTRING\fP or
|
|
Packit |
b099d7 |
\fBXmPIXMAP_AND_STRING\fP\&.
|
|
Packit |
b099d7 |
.IP "\fB_MOTIF_EXPORT_TARGETS\fP" 10
|
|
Packit |
b099d7 |
The widget transfers, as type \fBATOM\fP, a list of the targets to be
|
|
Packit |
b099d7 |
used as the value of the DragContext\&'s \fBXmNexportTargets\fP in a
|
|
Packit |
b099d7 |
drag-and-drop transfer\&.
|
|
Packit |
b099d7 |
When \fBXmNlabelType\fP is \fBXmSTRING\fP or \fBXmPIXMAP_AND_STRING\fP,
|
|
Packit |
b099d7 |
these include
|
|
Packit |
b099d7 |
\fB_MOTIF_COMPOUND_STRING\fP, \fBCOMPOUND_TEXT\fP, \fBUTF8_STRING\fP,
|
|
Packit |
b099d7 |
the encoding of the locale, \fBSTRING\fP, \fBTEXT\fP, \fBBACKGROUND\fP, and
|
|
Packit |
b099d7 |
\fBFOREGROUND\fP\&.
|
|
Packit |
b099d7 |
When \fBXmNlabelType\fP is \fBXmPIXMAP\fP or \fBXmPIXMAP_AND_STRING\fP,
|
|
Packit |
b099d7 |
these include \fBPIXMAP\fP,
|
|
Packit |
b099d7 |
\fBBACKGROUND\fP, and \fBFOREGROUND\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
As a source of data, Label also supports the following standard Motif
|
|
Packit |
b099d7 |
targets:
|
|
Packit |
b099d7 |
.IP "\fBBACKGROUND\fP" 10
|
|
Packit |
b099d7 |
The widget transfers \fBXmNbackground\fP as type \fBPIXEL\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBCLASS\fP" 10
|
|
Packit |
b099d7 |
The widget finds the first shell in the widget hierarchy that has a
|
|
Packit |
b099d7 |
\fBWM_CLASS\fP property and transfers the contents as text in the
|
|
Packit |
b099d7 |
current locale\&.
|
|
Packit |
b099d7 |
.IP "\fBCLIENT_WINDOW\fP" 10
|
|
Packit |
b099d7 |
The widget finds the first shell in the widget hierarchy and transfers
|
|
Packit |
b099d7 |
its window as type \fBWINDOW\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBCOLORMAP\fP" 10
|
|
Packit |
b099d7 |
The widget transfers \fBXmNcolormap\fP as type \fBCOLORMAP\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBFOREGROUND\fP" 10
|
|
Packit |
b099d7 |
The widget transfers \fBXmNforeground\fP as type \fBPIXEL\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBNAME\fP" 10
|
|
Packit |
b099d7 |
The widget finds the first shell in the widget hierarchy that has a
|
|
Packit |
b099d7 |
\fBWM_NAME\fP property and transfers the contents as text in the current
|
|
Packit |
b099d7 |
locale\&.
|
|
Packit |
b099d7 |
.IP "\fBTARGETS\fP" 10
|
|
Packit |
b099d7 |
The widget transfers, as type \fBATOM\fP, a list of the targets it
|
|
Packit |
b099d7 |
supports\&.
|
|
Packit |
b099d7 |
These include the standard targets in this list\&.
|
|
Packit |
b099d7 |
When \fBXmNlabelType\fP is \fBXmSTRING\fP or \fBXmPIXMAP_AND_STRING\fP,
|
|
Packit |
b099d7 |
these also include
|
|
Packit |
b099d7 |
\fB_MOTIF_COMPOUND_STRING\fP, \fBCOMPOUND_TEXT\fP, \fBUTF8_STRING\fP,
|
|
Packit |
b099d7 |
the encoding of the locale, \fBSTRING\fP, and \fBTEXT\fP\&.
|
|
Packit |
b099d7 |
When \fBXmNlabelType\fP is \fBXmPIXMAP\fP or \fBXmPIXMAP_AND_STRING\fP,
|
|
Packit |
b099d7 |
these also include \fBPIXMAP\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBTIMESTAMP\fP" 10
|
|
Packit |
b099d7 |
The widget transfers the timestamp used to acquire the selection as type
|
|
Packit |
b099d7 |
\fBINTEGER\fP\&.
|
|
Packit |
b099d7 |
.IP "\fB_MOTIF_RENDER_TABLE\fP" 10
|
|
Packit |
b099d7 |
The widget transfers \fBXmNrenderTable\fP if it exists, or else the
|
|
Packit |
b099d7 |
default text render table, as type \fBSTRING\fP\&.
|
|
Packit |
b099d7 |
.IP "\fB_MOTIF_ENCODING_REGISTRY\fP" 10
|
|
Packit |
b099d7 |
The widget transfers its encoding registry as type \fBSTRING\fP\&.
|
|
Packit |
b099d7 |
The value is a list of NULL separated items in the
|
|
Packit |
b099d7 |
form of tag encoding pairs\&.
|
|
Packit |
b099d7 |
This target symbolizes the transfer target for the
|
|
Packit |
b099d7 |
Motif Segment Encoding Registry\&.
|
|
Packit |
b099d7 |
Widgets and applications can use this Registry to register
|
|
Packit |
b099d7 |
text encoding formats for specified render table tags\&.
|
|
Packit |
b099d7 |
Applications access this Registry by calling
|
|
Packit |
b099d7 |
\fBXmRegisterSegmentEncoding\fP and \fBXmMapSegmentEncoding\fP\&.
|
|
Packit |
b099d7 |
.SS "Classes"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Label inherits behavior, resources, and traits from
|
|
Packit |
b099d7 |
\fBCore\fP and \fBXmPrimitive\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class pointer is \fBxmLabelWidgetClass\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class name is \fBXmLabel\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 |
resource 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 resource 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 resource 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),
|
|
Packit |
b099d7 |
or is not 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 |
\fBXmLabel Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNaccelerator?XmCAccelerator?String?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNacceleratorText?XmCAcceleratorText?XmString?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNalignment?XmCAlignment?unsigned char?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNfontList?XmCFontList?XmFontList?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNlabelInsensitivePixmap?XmCLabelInsensitivePixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNlabelPixmap?XmCLabelPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNlabelString?XmCXmString?XmString?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNlabelType?XmCLabelType?unsigned char?XmSTRING?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmarginBottom?XmCMarginBottom?Dimension?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmarginHeight?XmCMarginHeight?Dimension?2?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmarginLeft?XmCMarginLeft?Dimension?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmarginRight?XmCMarginRight?Dimension?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmarginTop?XmCMarginTop?Dimension?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmarginWidth?XmCMarginWidth?Dimension?2?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmnemonic?XmCMnemonic?KeySym?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmnemonicCharSet?XmCMnemonicCharSet?String?XmFONTLIST_DEFAULT_TAG?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNpixmapPlacement?XmCPixmapPlacement?unsigned int?XmPIXMAP_LEFT?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNpixmapTextPadding?XmCSpace?Dimension?2?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNrecomputeSize?XmCRecomputeSize?Boolean?True?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNrenderTable?XmCRenderTable?XmRenderTable?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNstringDirection?XmCStringDirection?XmStringDirection?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.IP "\fBXmNaccelerator\fP" 10
|
|
Packit |
b099d7 |
Sets the accelerator on a button widget in a menu, which
|
|
Packit |
b099d7 |
activates a visible or invisible, but managed, button from the keyboard\&.
|
|
Packit |
b099d7 |
This resource is a string that describes a set of modifiers
|
|
Packit |
b099d7 |
and the key that may be used to select the button\&.
|
|
Packit |
b099d7 |
The format of this string
|
|
Packit |
b099d7 |
is identical to that used by the translations manager, with the exception
|
|
Packit |
b099d7 |
that only a single event may be specified and only \fBKeyPress\fP events are
|
|
Packit |
b099d7 |
allowed\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
Accelerators for buttons are supported only for
|
|
Packit |
b099d7 |
PushButtons and ToggleButtons in Pulldown and Popup menu panes\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNacceleratorText\fP" 10
|
|
Packit |
b099d7 |
Specifies the text displayed
|
|
Packit |
b099d7 |
for the accelerator\&.
|
|
Packit |
b099d7 |
The text is displayed
|
|
Packit |
b099d7 |
adjacent to the label string or pixmap\&. The direction of its layout depends on
|
|
Packit |
b099d7 |
the \fBXmNlayoutDirection\fP resource of the widget\&.
|
|
Packit |
b099d7 |
Accelerator text for buttons is displayed only for
|
|
Packit |
b099d7 |
PushButtons and ToggleButtons in Pulldown and Popup Menus\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNalignment\fP" 10
|
|
Packit |
b099d7 |
Specifies the label alignment for text or pixmap\&.
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmALIGNMENT_BEGINNING\fP (left alignment)" 10
|
|
Packit |
b099d7 |
Causes the left sides of
|
|
Packit |
b099d7 |
the lines of text to be vertically aligned with the
|
|
Packit |
b099d7 |
left edge of the widget window\&. For a pixmap, its left side is vertically
|
|
Packit |
b099d7 |
aligned with the left edge of the widget window\&.
|
|
Packit |
b099d7 |
.IP "\fBXmALIGNMENT_CENTER\fP (center alignment)" 10
|
|
Packit |
b099d7 |
Causes the centers of the lines of text to be vertically aligned
|
|
Packit |
b099d7 |
in the center of the widget window\&. For a pixmap, its center is vertically aligned with the
|
|
Packit |
b099d7 |
center of the widget window\&.
|
|
Packit |
b099d7 |
.IP "\fBXmALIGNMENT_END\fP (right alignment)" 10
|
|
Packit |
b099d7 |
Causes the right sides of the
|
|
Packit |
b099d7 |
lines of text to be vertically aligned with the
|
|
Packit |
b099d7 |
right edge of the widget window\&. For a pixmap, its right side is vertically
|
|
Packit |
b099d7 |
aligned with the right edge of the widget window\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
The preceding descriptions for text are correct when
|
|
Packit |
b099d7 |
\fBXmNlayoutDirection\fP is \fBXmLEFT_TO_RIGHT\fP\&. When that resource
|
|
Packit |
b099d7 |
is \fBXmRIGHT_TO_LEFT\fP, the descriptions for
|
|
Packit |
b099d7 |
\fBXmALIGNMENT_BEGINNING\fP and \fBXmALIGNMENT_END\fP are switched\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
If the parent is a RowColumn whose \fBXmNisAligned\fP resource is True,
|
|
Packit |
b099d7 |
\fBXmNalignment\fP is forced to the same value as the RowColumn\&'s
|
|
Packit |
b099d7 |
\fBXmNentryAlignment\fP if the RowColumn\&'s \fBXmNrowColumnType\fP is
|
|
Packit |
b099d7 |
\fBXmWORK_AREA\fP or if the widget is a subclass of XmLabel\&.
|
|
Packit |
b099d7 |
Otherwise, the default is \fBXmALIGNMENT_CENTER\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNfontList\fP" 10
|
|
Packit |
b099d7 |
Specifies the font of the text used in the widget\&. \fBXmNfontList\fP
|
|
Packit |
b099d7 |
is obsolete and exists for compatibility with previous releases\&. You
|
|
Packit |
b099d7 |
should now use \fBXmNrenderTable\fP instead of \fBXmNfontList\fP\&. If
|
|
Packit |
b099d7 |
both are specified, the render table will take precedence\&. If
|
|
Packit |
b099d7 |
\fBXmNfontList\fP is NULL at initialization, Label searches its parent
|
|
Packit |
b099d7 |
hierarchy for an ancestor that is a subclass of the XmBulletinBoard,
|
|
Packit |
b099d7 |
VendorShell, or XmMenuShell widget class\&. If such an ancestor is
|
|
Packit |
b099d7 |
found, Label initializes \fBXmNfontList\fP to the
|
|
Packit |
b099d7 |
\fBXmNlabelFontList\fP of the ancestor widget\&. Similarly, button
|
|
Packit |
b099d7 |
subclasses of Label initialize \fBXmNfontList\fP to the
|
|
Packit |
b099d7 |
\fBXmNbuttonFontList\fP of the ancestor widget\&. (Currently, all
|
|
Packit |
b099d7 |
subclasses of Label are button subclasses\&.) If no such ancestor is
|
|
Packit |
b099d7 |
found, the default is implementation dependent\&. Refer to
|
|
Packit |
b099d7 |
\fBXmFontList\fP(3) for more information on the creation and
|
|
Packit |
b099d7 |
structure of a font list\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNlabelInsensitivePixmap\fP" 10
|
|
Packit |
b099d7 |
Specifies a pixmap used as the button face if \fBXmNlabelType\fP is
|
|
Packit |
b099d7 |
\fBXmPIXMAP\fP and the button is insensitive\&.
|
|
Packit |
b099d7 |
The default value, \fBXmUNSPECIFIED_PIXMAP\fP, displays an empty label\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNlabelPixmap\fP" 10
|
|
Packit |
b099d7 |
Specifies the pixmap when \fBXmNlabelType\fP is
|
|
Packit |
b099d7 |
\fBXmPIXMAP\fP or \fBXmPIXMAP_AND_STRING\fP\&.
|
|
Packit |
b099d7 |
The default value, \fBXmUNSPECIFIED_PIXMAP\fP, displays an empty label\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNlabelString\fP" 10
|
|
Packit |
b099d7 |
Specifies the compound string when \fBXmNlabelType\fP is
|
|
Packit |
b099d7 |
\fBXmSTRING\fP or \fBXmPIXMAP_AND_STRING\fP\&.
|
|
Packit |
b099d7 |
If this value is NULL, it is initialized by converting the name
|
|
Packit |
b099d7 |
of the widget to a compound string\&.
|
|
Packit |
b099d7 |
Refer to \fBXmString\fP(3)
|
|
Packit |
b099d7 |
for more information on the
|
|
Packit |
b099d7 |
creation and structure of compound strings\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNlabelType\fP" 10
|
|
Packit |
b099d7 |
Specifies the label type\&.
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmSTRING\fP" 10
|
|
Packit |
b099d7 |
Displays text using \fBXmNlabelString\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmPIXMAP\fP" 10
|
|
Packit |
b099d7 |
Displays pixmap using \fBXmNlabelPixmap\fP or
|
|
Packit |
b099d7 |
.IP "\fBXmPIXMAP_AND_STRING\fP" 10
|
|
Packit |
b099d7 |
Displays text and pixmap using \fBXmNlabelPixmap\fP or
|
|
Packit |
b099d7 |
\fBXmNlabelInsensitivePixmap\fP and \fBXmNlabelString\fP\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.IP "\fBXmNmarginBottom\fP" 10
|
|
Packit |
b099d7 |
Specifies the amount of spacing between the bottom of the label text
|
|
Packit |
b099d7 |
and the top of the bottom margin specified by \fBXmNmarginHeight\fP\&.
|
|
Packit |
b099d7 |
This may be modified by Label\&'s
|
|
Packit |
b099d7 |
subclasses\&. For example, CascadeButton may increase this field to make
|
|
Packit |
b099d7 |
room for the cascade pixmap\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNmarginHeight\fP" 10
|
|
Packit |
b099d7 |
Specifies an equal amount of spacing above the margin
|
|
Packit |
b099d7 |
defined by \fBXmNmarginTop\fP and below the margin defined by
|
|
Packit |
b099d7 |
\fBXmNmarginBottom\fP\&. \fBXmNmarginHeight\fP specifies the amount
|
|
Packit |
b099d7 |
of spacing between the top edge of the margin set by \fBXmNmarginTop\fP
|
|
Packit |
b099d7 |
and the bottom edge of the top shadow, and the amount of spacing between
|
|
Packit |
b099d7 |
the bottom edge of the margin specified by \fBXmNmarginBottom\fP and the
|
|
Packit |
b099d7 |
top edge of the bottom shadow\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNmarginLeft\fP" 10
|
|
Packit |
b099d7 |
Specifies the amount of spacing between the left edge of the label text
|
|
Packit |
b099d7 |
and the right side of the left margin (specified by \fBXmNmarginWidth\fP)\&.
|
|
Packit |
b099d7 |
This may be modified by Label\&'s
|
|
Packit |
b099d7 |
subclasses\&. For example, ToggleButton may increase this field to make room
|
|
Packit |
b099d7 |
for the toggle indicator and for spacing between the indicator and label\&.
|
|
Packit |
b099d7 |
Whether this actually applies to the left or right side of the label
|
|
Packit |
b099d7 |
depends on the value of
|
|
Packit |
b099d7 |
the \fBXmNlayoutDirection\fP resource\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNmarginRight\fP" 10
|
|
Packit |
b099d7 |
Specifies the amount of spacing between the right edge of the label text
|
|
Packit |
b099d7 |
and the left side of the right margin (specified by \fBXmNmarginWidth\fP)\&.
|
|
Packit |
b099d7 |
This may be modified by Label\&'s
|
|
Packit |
b099d7 |
subclasses\&. For example, CascadeButton may increase this field to make room
|
|
Packit |
b099d7 |
for the cascade pixmap\&.
|
|
Packit |
b099d7 |
Whether this actually applies to the left or right side of the label
|
|
Packit |
b099d7 |
depends on the value of
|
|
Packit |
b099d7 |
the \fBXmNlayoutDirection\fP resource\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNmarginTop\fP" 10
|
|
Packit |
b099d7 |
Specifies the amount of spacing between the top of the label text and
|
|
Packit |
b099d7 |
the bottom of the top margin specified by \fBXmNmarginHeight\fP\&.
|
|
Packit |
b099d7 |
This may be modified by Label\&'s subclasses\&. For example, CascadeButton
|
|
Packit |
b099d7 |
may increase this field to make room for the cascade pixmap\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNmarginWidth\fP" 10
|
|
Packit |
b099d7 |
Specifies an equal amount of spacing to the left of the margin defined
|
|
Packit |
b099d7 |
by \fBXmNmarginLeft\fP and to the right of the margin defined by
|
|
Packit |
b099d7 |
\fBXmNmarginRight\fP\&. \fBXmNmarginWidth\fP specifies the amount
|
|
Packit |
b099d7 |
of spacing between the left edge of the margin set by \fBXmNmarginLeft\fP
|
|
Packit |
b099d7 |
and the right edge of the left shadow, and the amount of spacing between
|
|
Packit |
b099d7 |
the right edge of the margin specified by \fBXmNmarginRight\fP and the
|
|
Packit |
b099d7 |
left edge of the right shadow\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNmnemonic\fP" 10
|
|
Packit |
b099d7 |
Provides the user with an alternate means of activating a button\&.
|
|
Packit |
b099d7 |
A button in a MenuBar, a Popup menu pane, or a Pulldown
|
|
Packit |
b099d7 |
menu pane can have a mnemonic\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
This resource contains a keysym as listed in the X11 keysym table\&.
|
|
Packit |
b099d7 |
The first character in the label string that exactly matches
|
|
Packit |
b099d7 |
the mnemonic in the character set specified in
|
|
Packit |
b099d7 |
\fBXmNmnemonicCharSet\fP
|
|
Packit |
b099d7 |
is underlined when the button is displayed\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
When a mnemonic has been specified, the user activates the button by
|
|
Packit |
b099d7 |
pressing the mnemonic key while the button is visible\&.
|
|
Packit |
b099d7 |
If the button is a CascadeButton in a MenuBar and the MenuBar does not
|
|
Packit |
b099d7 |
have the focus, the user must use the \fBMAlt\fP modifier while
|
|
Packit |
b099d7 |
pressing the mnemonic\&.
|
|
Packit |
b099d7 |
The user can activate the button by pressing either the shifted or the
|
|
Packit |
b099d7 |
unshifted mnemonic key\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNmnemonicCharSet\fP" 10
|
|
Packit |
b099d7 |
Specifies the character set of the mnemonic for the label\&.
|
|
Packit |
b099d7 |
The default is \fBXmFONTLIST_DEFAULT_TAG\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNpixmapPlacement\fP" 10
|
|
Packit |
b099d7 |
The location of the pixmap with respect to the text label. This resource
|
|
Packit |
b099d7 |
can take one of the following values: \fBXmPIXMAP_TOP\fP, \fBXmPIXMAP_BOTTOM\fP,
|
|
Packit |
b099d7 |
\fBXmPIXMAP_LEFT\fP, and \fBXmPIXMAP_RIGHT\fP. A type converter has been
|
|
Packit |
b099d7 |
registered that converts the following strings: "top", "bottom", "left", and
|
|
Packit |
b099d7 |
"right".
|
|
Packit |
b099d7 |
.IP "\fBXmNpixmapTextPadding\fP" 10
|
|
Packit |
b099d7 |
The amount of space to be left between the pixmap and the label string.
|
|
Packit |
b099d7 |
.IP "\fBXmNrecomputeSize\fP" 10
|
|
Packit |
b099d7 |
Specifies a Boolean value that indicates whether the widget
|
|
Packit |
b099d7 |
shrinks or expands to accommodate its contents (label string or
|
|
Packit |
b099d7 |
pixmap) as a result of an \fBXtSetValues\fP resource value that
|
|
Packit |
b099d7 |
would change the size of the widget\&. If True, the widget shrinks
|
|
Packit |
b099d7 |
or expands to exactly fit the label string or pixmap\&.
|
|
Packit |
b099d7 |
If False, the widget never attempts to change size on its own\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNrenderTable\fP" 10
|
|
Packit |
b099d7 |
Specifies the render table associated with the \fBlabelString\fP\&. If
|
|
Packit |
b099d7 |
this value is NULL at initialization, Label searches its parent
|
|
Packit |
b099d7 |
hierarchy for an ancestor that holds the \fBXmQTspecifyRenderTable\fP trait\&.
|
|
Packit |
b099d7 |
If such an ancestor is
|
|
Packit |
b099d7 |
found, Label initializes \fBXmNrenderTable\fP to the
|
|
Packit |
b099d7 |
\fBXmLABEL_RENDER_TABLE\fP value of the ancestor widget\&. Similarly, button
|
|
Packit |
b099d7 |
subclasses of Label initialize \fBXmNrenderTable\fP to the
|
|
Packit |
b099d7 |
\fBXmBUTTON_RENDER_TABLE\fP value of the ancestor widget\&. (Note that all
|
|
Packit |
b099d7 |
current subclasses of Label are button subclasses\&.) If no such
|
|
Packit |
b099d7 |
ancestor is found, the default is implementation dependent\&. If a font
|
|
Packit |
b099d7 |
list and a render table are both sepcified, the render table will take
|
|
Packit |
b099d7 |
precedence\&. Refer to \fBXmRenderTable\fP(3) for more information on
|
|
Packit |
b099d7 |
the creation and structure of a render table\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNstringDirection\fP" 10
|
|
Packit |
b099d7 |
Is a synthetic resource for setting \fBXmNlayoutDirection\fP\&.
|
|
Packit |
b099d7 |
The values for this resource are \fBXmSTRING_DIRECTION_L_TO_R\fP and
|
|
Packit |
b099d7 |
\fBXmSTRING_DIRECTION_R_TO_L\fP\&. Refer to the
|
|
Packit |
b099d7 |
\fBXmNlayoutDirection\fP resource description\&. The
|
|
Packit |
b099d7 |
\fBXmNstringDirection\fP resource is obsoleted by
|
|
Packit |
b099d7 |
\fBXmNlayoutDirection\fP, but is kept here for backward compatibility\&.
|
|
Packit |
b099d7 |
.SS "Inherited Resources"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Label inherits behavior and resources from the following
|
|
Packit |
b099d7 |
superclasses\&. For a complete description of each resource, refer to the
|
|
Packit |
b099d7 |
reference page for that superclass\&.
|
|
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 |
\fBXmPrimitive Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbottomShadowColor?XmCBottomShadowColor?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNbottomShadowPixmap?XmCBottomShadowPixmap?Pixmap?XmUNSPECIFIED_PIXMAP?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNconvertCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNforeground?XmCForeground?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNhelpCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNhighlightColor?XmCHighlightColor?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNhighlightOnEnter?XmCHighlightOnEnter?Boolean?False?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNhighlightPixmap?XmCHighlightPixmap?Pixmap?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNhighlightThickness?XmCHighlightThickness?Dimension?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNlayoutDirection?XmCLayoutDirection?XmDirection?dynamic?CG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNnavigationType?XmCNavigationType?XmNavigationType?XmNONE?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNpopupHandlerCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNshadowThickness?XmCShadowThickness?Dimension?0?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNtopShadowColor?XmCTopShadowColor?Pixel?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNtopShadowPixmap?XmCTopShadowPixmap?Pixmap?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNtraversalOn?XmCTraversalOn?Boolean?False?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNunitType?XmCUnitType?unsigned char?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNuserData?XmCUserData?XtPointer?NULL?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
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 |
\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 |
XmLabel includes translations from Primitive\&.
|
|
Packit |
b099d7 |
The XmLabel translations are described in the following list\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The following key names are listed in the
|
|
Packit |
b099d7 |
X standard key event translation table syntax\&.
|
|
Packit |
b099d7 |
This format is the one used by Motif to
|
|
Packit |
b099d7 |
specify the widget actions corresponding to a given key\&.
|
|
Packit |
b099d7 |
A brief overview of the format is provided under
|
|
Packit |
b099d7 |
\fBVirtualBindings\fP(3)\&.
|
|
Packit |
b099d7 |
For a complete description of the format, please refer to the
|
|
Packit |
b099d7 |
X Toolkit Instrinsics Documentation\&.
|
|
Packit |
b099d7 |
.IP "\fB<Btn2Down>\fP:" 10
|
|
Packit |
b099d7 |
ProcessDrag()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfHelp>\fP:" 10
|
|
Packit |
b099d7 |
Help()
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The translations used by subclasses of XmLabel for menu
|
|
Packit |
b099d7 |
traversal are described in the following list\&.
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfCancel>\fP:" 10
|
|
Packit |
b099d7 |
MenuEscape()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfLeft>\fP:" 10
|
|
Packit |
b099d7 |
MenuTraverseLeft()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfRight>\fP:" 10
|
|
Packit |
b099d7 |
MenuTraverseRight()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfUp>\fP:" 10
|
|
Packit |
b099d7 |
MenuTraverseUp()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfDown>\fP:" 10
|
|
Packit |
b099d7 |
MenuTraverseDown()
|
|
Packit |
b099d7 |
.SS "Action Routines"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The \fBXmLabel\fP action routines are
|
|
Packit |
b099d7 |
.IP "Help():" 10
|
|
Packit |
b099d7 |
In a Popup or Pulldown MenuPane, unposts all menus in the menu hierarchy
|
|
Packit |
b099d7 |
and, when the shell\&'s keyboard focus policy is \fBXmEXPLICIT\fP,
|
|
Packit |
b099d7 |
restores keyboard focus to the widget that had the focus before the
|
|
Packit |
b099d7 |
menu system was entered\&.
|
|
Packit |
b099d7 |
Calls the callbacks for \fBXmNhelpCallback\fP if any exist\&.
|
|
Packit |
b099d7 |
If there are no help
|
|
Packit |
b099d7 |
callbacks for this widget, this action calls the help callbacks
|
|
Packit |
b099d7 |
for the nearest ancestor that has them\&.
|
|
Packit |
b099d7 |
.IP "MenuEscape():" 10
|
|
Packit |
b099d7 |
In a MenuBar, disarms the CascadeButton and the menu and, when the
|
|
Packit |
b099d7 |
shell\&'s keyboard focus policy is \fBXmEXPLICIT\fP, restores keyboard
|
|
Packit |
b099d7 |
focus to the widget that had the focus before the menu was entered\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
In a top-level Pulldown MenuPane from a MenuBar, unposts the menu,
|
|
Packit |
b099d7 |
disarms the MenuBar CascadeButton and the MenuBar, and, when the shell\&'s
|
|
Packit |
b099d7 |
keyboard focus policy is \fBXmEXPLICIT\fP, restores keyboard focus to
|
|
Packit |
b099d7 |
the widget that had the focus before the MenuBar was entered\&.
|
|
Packit |
b099d7 |
In other Pulldown MenuPanes, unposts the menu and moves the focus
|
|
Packit |
b099d7 |
to its CascadeButton\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
In a Popup MenuPane, unposts the menu and, when the shell\&'s keyboard
|
|
Packit |
b099d7 |
focus policy is \fBXmEXPLICIT\fP, restores keyboard focus to the widget
|
|
Packit |
b099d7 |
from which the menu was posted\&.
|
|
Packit |
b099d7 |
.IP "MenuTraverseDown():" 10
|
|
Packit |
b099d7 |
If the current menu item has a submenu and is in a MenuBar, then this
|
|
Packit |
b099d7 |
action posts the submenu, disarms the current menu item, and arms
|
|
Packit |
b099d7 |
the submenu\&'s first traversable menu item\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
If the current menu item is in a MenuPane, then this action disarms the
|
|
Packit |
b099d7 |
current menu item and arms the item below it\&. This action wraps within the
|
|
Packit |
b099d7 |
MenuPane\&. The direction of the wrapping depends on the
|
|
Packit |
b099d7 |
\fBXmNlayoutDirection\fP resource\&.
|
|
Packit |
b099d7 |
.IP "MenuTraverseLeft():" 10
|
|
Packit |
b099d7 |
When the current menu item is in a MenuBar, then this action disarms the
|
|
Packit |
b099d7 |
current item and arms the MenuBar item to the left\&.
|
|
Packit |
b099d7 |
This action wraps within the MenuBar\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
In MenuPanes, if the current menu item is not at the left edge of a MenuPane,
|
|
Packit |
b099d7 |
this action disarms the current item and arms the item to its left\&.
|
|
Packit |
b099d7 |
If the current menu item is at the left edge of a submenu attached to a
|
|
Packit |
b099d7 |
MenuBar item, then this action unposts the submenu and traverses to the
|
|
Packit |
b099d7 |
MenuBar item to the left, wrapping if necessary\&. If that MenuBar item
|
|
Packit |
b099d7 |
has a submenu, it posts the submenu and arms the first traversable
|
|
Packit |
b099d7 |
item in the submenu\&.
|
|
Packit |
b099d7 |
If the current menu item is at the left edge of a submenu not directly
|
|
Packit |
b099d7 |
attached to a MenuBar item, then this action unposts the current submenu only\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
In Popup or Torn-off MenuPanes, when the current menu item is at the
|
|
Packit |
b099d7 |
left edge, this action wraps within the MenuPane\&. If the current menu
|
|
Packit |
b099d7 |
item is at the left edge of the MenuPane and not in the top row, this
|
|
Packit |
b099d7 |
action wraps to the rightmost menu item in the row above\&. If the current
|
|
Packit |
b099d7 |
menu item is in the upper, leftmost corner, this action wraps
|
|
Packit |
b099d7 |
to the tear-off control, if present, or else it wraps to the bottom,
|
|
Packit |
b099d7 |
rightmost menu item in the MenuPane\&.
|
|
Packit |
b099d7 |
The preceding description applies when the \fBXmNlayoutDirection\fP horizontal
|
|
Packit |
b099d7 |
direction is \fBXmLEFT_TO_RIGHT\fP\&. If the \fBXmNlayoutDirection\fP horizontal
|
|
Packit |
b099d7 |
direction is \fBXmRIGHT_TO_LEFT\fP, then the following applies\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
If the current menu item is in a MenuBar, then this action disarms the
|
|
Packit |
b099d7 |
current item and arms the MenuBar item to the left\&.
|
|
Packit |
b099d7 |
This action wraps within the MenuBar\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
In MenuPanes, if the current menu item is a CascadeButton, then this
|
|
Packit |
b099d7 |
action posts its associated submenu\&.
|
|
Packit |
b099d7 |
If the current menu item is not a CascadeButton and is not at the left
|
|
Packit |
b099d7 |
edge of a MenuPane, this action disarms the current item and arms the
|
|
Packit |
b099d7 |
item to its left, wrapping if necessary\&.
|
|
Packit |
b099d7 |
If the current menu item is not a CascadeButton and is at the left edge of a
|
|
Packit |
b099d7 |
submenu that is a descendent of a MenuBar, then this action unposts all
|
|
Packit |
b099d7 |
submenus and traverses to the MenuBar item to the left\&.
|
|
Packit |
b099d7 |
If that MenuBar item has a submenu, it posts the submenu and arms
|
|
Packit |
b099d7 |
the submenu\&'s first traversable item\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
In Popup or Torn-off menus, if the current menu item is not a
|
|
Packit |
b099d7 |
CascadeButton and is at the left edge of a row (except the
|
|
Packit |
b099d7 |
bottom row), this action wraps to the rightmost menu item in the
|
|
Packit |
b099d7 |
row below\&. If the current menu item is not a CascadeButton and
|
|
Packit |
b099d7 |
is in the bottom, leftmost corner of a Popup or Pulldown MenuPane, this
|
|
Packit |
b099d7 |
action wraps to the tear-off control, if present, or else it wraps to
|
|
Packit |
b099d7 |
the top, rightmost menu item of the MenuPane\&.
|
|
Packit |
b099d7 |
.IP "MenuTraverseRight():" 10
|
|
Packit |
b099d7 |
If the current menu item is in a MenuBar, then this action disarms the
|
|
Packit |
b099d7 |
current item and arms the MenuBar item to the right\&.
|
|
Packit |
b099d7 |
This action wraps within the MenuBar\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
In MenuPanes, if the current menu item is a CascadeButton, then this
|
|
Packit |
b099d7 |
action posts its associated submenu\&.
|
|
Packit |
b099d7 |
If the current menu item is not a CascadeButton and is not at the right
|
|
Packit |
b099d7 |
edge of a MenuPane, this action disarms the current item and arms the
|
|
Packit |
b099d7 |
item to its right, wrapping if necessary\&.
|
|
Packit |
b099d7 |
If the current menu item is not a CascadeButton and is at the right edge of a
|
|
Packit |
b099d7 |
submenu that is a descendent of a MenuBar, then this action unposts all
|
|
Packit |
b099d7 |
submenus and traverses to the MenuBar item to the right\&.
|
|
Packit |
b099d7 |
If that MenuBar item has a submenu, it posts the submenu and arms
|
|
Packit |
b099d7 |
the submenu\&'s first traversable item\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
In Popup or Torn-off menus, if the current menu item is not a
|
|
Packit |
b099d7 |
CascadeButton and is at the right edge of a row (except the
|
|
Packit |
b099d7 |
bottom row), this action wraps to the leftmost menu item in the
|
|
Packit |
b099d7 |
row below\&. If the current menu item is not a CascadeButton and
|
|
Packit |
b099d7 |
is in the bottom, rightmost corner of a Popup or Pulldown MenuPane, this
|
|
Packit |
b099d7 |
action wraps to the tear-off control, if present, or else it wraps to
|
|
Packit |
b099d7 |
the top, leftmost menu item of the MenuPane\&.
|
|
Packit |
b099d7 |
The preceding description applies when the \fBXmNlayoutDirection\fP horizontal
|
|
Packit |
b099d7 |
direction is \fBXmLEFT_TO_RIGHT\fP\&. If the \fBXmNlayoutDirection\fP horizontal
|
|
Packit |
b099d7 |
direction is \fBXmRIGHT_TO_LEFT\fP, then the following applies\&.
|
|
Packit |
b099d7 |
When the current menu item is in a MenuBar, then this action disarms the
|
|
Packit |
b099d7 |
current item and arms the MenuBar item to the left\&.
|
|
Packit |
b099d7 |
This action wraps within the MenuBar\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
In MenuPanes, if the current menu item is not at the right edge of a MenuPane,
|
|
Packit |
b099d7 |
this action disarms the current item and arms the item to its right\&.
|
|
Packit |
b099d7 |
If the current menu item is at the right edge of a submenu attached to a
|
|
Packit |
b099d7 |
MenuBar item, then this action unposts the submenu and traverses to the
|
|
Packit |
b099d7 |
MenuBar item to the right, wrapping if necessary\&. If that MenuBar item
|
|
Packit |
b099d7 |
has a submenu, it posts the submenu and arms the first traversable
|
|
Packit |
b099d7 |
item in the submenu\&.
|
|
Packit |
b099d7 |
If the current menu item is at the right edge of a submenu not directly
|
|
Packit |
b099d7 |
attached to a MenuBar item, then this action unposts the current submenu only\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
In Popup or Torn-off MenuPanes, when the current menu item is at the
|
|
Packit |
b099d7 |
right edge, this action wraps within the MenuPane\&. If the current menu
|
|
Packit |
b099d7 |
item is at the right edge of the MenuPane and not in the top row, this
|
|
Packit |
b099d7 |
action wraps to the leftmost menu item in the row above\&. If the current
|
|
Packit |
b099d7 |
menu item is in the upper, rightmost corner, this action wraps
|
|
Packit |
b099d7 |
to the tear-off control, if present, or else it wraps to the bottom,
|
|
Packit |
b099d7 |
leftmost menu item in the MenuPane\&.
|
|
Packit |
b099d7 |
.IP "MenuTraverseUp():" 10
|
|
Packit |
b099d7 |
When the current menu item is in a MenuPane, then
|
|
Packit |
b099d7 |
this action disarms the current menu item and arms the item above it\&.
|
|
Packit |
b099d7 |
This action wraps within the MenuPane\&. The direction of the wrapping
|
|
Packit |
b099d7 |
depends on the \fBXmNlayoutDirection\fP resource\&.
|
|
Packit |
b099d7 |
.IP "ProcessDrag():" 10
|
|
Packit |
b099d7 |
Drags the contents of a Label, identified when \fBBTransfer\fP is
|
|
Packit |
b099d7 |
pressed\&.
|
|
Packit |
b099d7 |
This action sets the \fBXmNconvertProc\fP of the DragContext to a
|
|
Packit |
b099d7 |
function that calls the \fBXmNconvertCallback\fP procedures, possibly
|
|
Packit |
b099d7 |
multiple times, for the \fB_MOTIF_DROP\fP selection\&.
|
|
Packit |
b099d7 |
This action is undefined for Labels used in a menu system\&.
|
|
Packit |
b099d7 |
.SS "Virtual Bindings"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The bindings for virtual keys are vendor specific\&.
|
|
Packit |
b099d7 |
For information about bindings for virtual buttons and keys, see
|
|
Packit |
b099d7 |
\fBVirtualBindings\fP(3)\&.
|
|
Packit |
b099d7 |
.SH "RELATED"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
\fBCore\fP(3),
|
|
Packit |
b099d7 |
\fBXmCreateLabel\fP(3),
|
|
Packit |
b099d7 |
\fBXmFontListAppendEntry\fP(3),
|
|
Packit |
b099d7 |
\fBXmStringCreate\fP(3),
|
|
Packit |
b099d7 |
\fBXmStringCreateLtoR\fP(3),
|
|
Packit |
b099d7 |
\fBXmPrimitive\fP(3),
|
|
Packit |
b099d7 |
\fBXmVaCreateLabel\fP(3), and
|
|
Packit |
b099d7 |
\fBXmVaCreateManagedLabel\fP(3)\&.
|