|
Packit |
b099d7 |
'\" t
|
|
Packit |
b099d7 |
...\" DrawnBut.sgm /main/11 1996/09/08 20:40: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 "XmDrawnButton" "library call"
|
|
Packit |
b099d7 |
.SH "NAME"
|
|
Packit |
b099d7 |
\fBXmDrawnButton\fP \(em The DrawnButton widget class
|
|
Packit |
b099d7 |
.iX "XmDrawnButton"
|
|
Packit |
b099d7 |
.iX "widget class" "DrawnButton"
|
|
Packit |
b099d7 |
.SH "SYNOPSIS"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
#include <Xm/DrawnB\&.h>
|
|
Packit |
b099d7 |
.fi
|
|
Packit |
b099d7 |
.SH "DESCRIPTION"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The DrawnButton widget consists of an empty widget window surrounded by a
|
|
Packit |
b099d7 |
shadow border\&. It provides the application developer with a graphics area
|
|
Packit |
b099d7 |
that can have PushButton input semantics\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
Callback types are defined for widget exposure and widget resize to allow the
|
|
Packit |
b099d7 |
application to redraw or reposition its graphics\&. If the DrawnButton
|
|
Packit |
b099d7 |
widget has a highlight and shadow thickness, the application should not draw
|
|
Packit |
b099d7 |
in that area\&.
|
|
Packit |
b099d7 |
To avoid drawing in the highlight and
|
|
Packit |
b099d7 |
shadow area, create the graphics context with
|
|
Packit |
b099d7 |
a clipping rectangle for drawing in the widget\&.
|
|
Packit |
b099d7 |
The clipping rectangle should
|
|
Packit |
b099d7 |
take into account the size of the widget\&'s highlight thickness and
|
|
Packit |
b099d7 |
shadow\&.
|
|
Packit |
b099d7 |
DrawnButton uses the \fBXmQTmenuSystem\fP and
|
|
Packit |
b099d7 |
\fBXmQTspecifyRenderTable\fP traits, and
|
|
Packit |
b099d7 |
holds the \fBXmQTactivatable\fP trait\&.
|
|
Packit |
b099d7 |
.SS "Classes"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
DrawnButton inherits behavior, resources, and traits
|
|
Packit |
b099d7 |
from the \fBCore\fP, \fBPrimitive\fP,
|
|
Packit |
b099d7 |
and \fBXmLabel\fP classes\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class pointer is \fBxmDrawnButtonWidgetClass\fP\&.
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The class name is \fBXmDrawnButton\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), 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 |
\fBXmDrawnButton Resource Set\fP
|
|
Packit |
b099d7 |
\fBName\fP?\fBClass\fP?\fBType\fP?\fBDefault\fP?\fBAccess\fP
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNactivateCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNarmCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNdisarmCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNexposeCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmultiClick?XmCMultiClick?unsigned char?dynamic?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNpushButtonEnabled?XmCPushButtonEnabled?Boolean?False?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNresizeCallback?XmCCallback?XtCallbackList?NULL?C
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNshadowType?XmCShadowType?unsigned char?XmSHADOW_ETCHED_IN?CSG
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
.TE
|
|
Packit |
b099d7 |
.IP "\fBXmNactivateCallback\fP" 10
|
|
Packit |
b099d7 |
Specifies the list of callbacks that is called
|
|
Packit |
b099d7 |
when the widget becomes selected\&.
|
|
Packit |
b099d7 |
The reason sent by the callback is \fBXmCR_ACTIVATE\fP\&.
|
|
Packit |
b099d7 |
This callback uses the \fBXmQTactivatable\fP trait\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNarmCallback\fP" 10
|
|
Packit |
b099d7 |
Specifies the list of callbacks that is called
|
|
Packit |
b099d7 |
when the widget becomes armed\&.
|
|
Packit |
b099d7 |
The reason sent by the callback is \fBXmCR_ARM\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNdisarmCallback\fP" 10
|
|
Packit |
b099d7 |
Specifies the list of callbacks that is called
|
|
Packit |
b099d7 |
when the widget becomes disarmed\&.
|
|
Packit |
b099d7 |
The reason sent by the callback is \fBXmCR_DISARM\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNexposeCallback\fP" 10
|
|
Packit |
b099d7 |
Specifies the list of callbacks that is called
|
|
Packit |
b099d7 |
when the widget receives an exposure event\&.
|
|
Packit |
b099d7 |
The reason sent by the callback is \fBXmCR_EXPOSE\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNmultiClick\fP" 10
|
|
Packit |
b099d7 |
If a button click is followed by another button click within the time
|
|
Packit |
b099d7 |
span specified by the display\&'s multiclick time, and this resource is
|
|
Packit |
b099d7 |
set to \fBXmMULTICLICK_DISCARD\fP, the second click is not processed\&.
|
|
Packit |
b099d7 |
If this resource is set to \fBXmMULTICLICK_KEEP\fP, the event
|
|
Packit |
b099d7 |
is processed and \fIclick_count\fP is incremented in the callback structure\&.
|
|
Packit |
b099d7 |
When the button is not in a menu, the default value is
|
|
Packit |
b099d7 |
\fBXmMULTICLICK_KEEP\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNpushButtonEnabled\fP" 10
|
|
Packit |
b099d7 |
Enables or disables the 3-dimensional shadow drawing as in
|
|
Packit |
b099d7 |
PushButton\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNresizeCallback\fP" 10
|
|
Packit |
b099d7 |
Specifies the list of callbacks that is called
|
|
Packit |
b099d7 |
when the widget receives a resize event\&.
|
|
Packit |
b099d7 |
The reason sent by the callback is \fBXmCR_RESIZE\fP\&. The event
|
|
Packit |
b099d7 |
returned for this callback is NULL\&.
|
|
Packit |
b099d7 |
.IP "\fBXmNshadowType\fP" 10
|
|
Packit |
b099d7 |
Describes the drawing style for the DrawnButton\&. This resource can have
|
|
Packit |
b099d7 |
the following values:
|
|
Packit |
b099d7 |
.RS
|
|
Packit |
b099d7 |
.IP "\fBXmSHADOW_IN\fP" 10
|
|
Packit |
b099d7 |
Draws the DrawnButton so that the shadow appears
|
|
Packit |
b099d7 |
inset\&. This means that the bottom shadow visuals and top shadow visuals
|
|
Packit |
b099d7 |
are reversed\&.
|
|
Packit |
b099d7 |
.IP "\fBXmSHADOW_OUT\fP" 10
|
|
Packit |
b099d7 |
Draws the DrawnButton
|
|
Packit |
b099d7 |
so that the shadow appears outset\&.
|
|
Packit |
b099d7 |
.IP "\fBXmSHADOW_ETCHED_IN\fP" 10
|
|
Packit |
b099d7 |
Draws the DrawnButton using a double line\&. This
|
|
Packit |
b099d7 |
gives the effect of a line etched into the window\&. The thickness of the
|
|
Packit |
b099d7 |
double line is equal to the value of \fBXmNshadowThickness\fP\&.
|
|
Packit |
b099d7 |
.IP "\fBXmSHADOW_ETCHED_OUT\fP" 10
|
|
Packit |
b099d7 |
Draws the DrawnButton using a double line\&. This
|
|
Packit |
b099d7 |
gives the effect of a line coming out of the window\&. The thickness of the
|
|
Packit |
b099d7 |
double line is equal to the value of \fBXmNshadowThickness\fP\&.
|
|
Packit |
b099d7 |
.RE
|
|
Packit |
b099d7 |
.SS "Inherited Resources"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
DrawnButton 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 |
.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?N/A
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNacceleratorText?XmCAcceleratorText?XmString?NULL?N/A
|
|
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?"\e0"?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?N/A
|
|
Packit |
b099d7 |
_?_?_?_?_?
|
|
Packit |
b099d7 |
XmNmnemonicCharSet?XmCMnemonicCharSet?String?XmFONTLIST_DEFAULT_TAG?N/A
|
|
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 |
.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?2?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?2?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?True?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 "Callback Information"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
A pointer to the following structure is passed to each callback:
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
.nf
|
|
Packit |
b099d7 |
typedef struct
|
|
Packit |
b099d7 |
{
|
|
Packit |
b099d7 |
int \fIreason\fP;
|
|
Packit |
b099d7 |
XEvent \fI* event\fP;
|
|
Packit |
b099d7 |
Window \fIwindow\fP;
|
|
Packit |
b099d7 |
int \fIclick_count\fP;
|
|
Packit |
b099d7 |
} XmDrawnButtonCallbackStruct;
|
|
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 |
This is NULL for \fBXmNresizeCallback\fP\&.
|
|
Packit |
b099d7 |
.IP "\fIwindow\fP" 10
|
|
Packit |
b099d7 |
Is set to the window ID in which the event occurred\&.
|
|
Packit |
b099d7 |
.IP "\fIclick_count\fP" 10
|
|
Packit |
b099d7 |
Contains the number of clicks in the last multiclick sequence
|
|
Packit |
b099d7 |
if the \fBXmNmultiClick\fP resource is set to \fBXmMULTICLICK_KEEP\fP,
|
|
Packit |
b099d7 |
otherwise it contains 1\&.
|
|
Packit |
b099d7 |
The activate callback is invoked for each click if \fBXmNmultiClick\fP
|
|
Packit |
b099d7 |
is set to \fBXmMULTICLICK_KEEP\fP\&.
|
|
Packit |
b099d7 |
.SS "Translations"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
XmDrawnButton includes translations from Primitive\&.
|
|
Packit |
b099d7 |
Additional XmDrawnButton translations are
|
|
Packit |
b099d7 |
described in the following list\&.
|
|
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 "\fBc<Btn1Down>\fP:" 10
|
|
Packit |
b099d7 |
ButtonTakeFocus()
|
|
Packit |
b099d7 |
.IP "\fB\(apc\fP\fB<Btn1Down>\fP:" 10
|
|
Packit |
b099d7 |
Arm()
|
|
Packit |
b099d7 |
.IP "\fB\(apc\fP\fB<Btn1Down>\fP\fB,\(apc\fP\fB<Btn1Up>\fP:" 10
|
|
Packit |
b099d7 |
Activate() Disarm()
|
|
Packit |
b099d7 |
.IP "\fB\(apc\fP\fB<Btn1Down>\fP\fB(2+)\fP:" 10
|
|
Packit |
b099d7 |
MultiArm()
|
|
Packit |
b099d7 |
.IP "\fB\(apc\fP\fB<Btn1Up>\fP\fB(2+)\fP:" 10
|
|
Packit |
b099d7 |
MultiActivate()
|
|
Packit |
b099d7 |
.IP "\fB\(apc\fP\fB<Btn1Up>\fP:" 10
|
|
Packit |
b099d7 |
Activate() Disarm()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfActivate>\fP:" 10
|
|
Packit |
b099d7 |
PrimitiveParentActivate()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfCancel>\fP:" 10
|
|
Packit |
b099d7 |
PrimitiveParentCancel()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfSelect>\fP:" 10
|
|
Packit |
b099d7 |
ArmAndActivate()
|
|
Packit |
b099d7 |
.IP "\fB:\fP\fB<Key>\fP\fB<osfHelp>\fP:" 10
|
|
Packit |
b099d7 |
Help()
|
|
Packit |
b099d7 |
.IP "\fB\(aps \(apm \(apa\fP \fB<Key>\fP\fBReturn\fP:" 10
|
|
Packit |
b099d7 |
PrimitiveParentActivate()
|
|
Packit |
b099d7 |
.IP "\fB\(aps \(apm \(apa\fP \fB<Key>\fP\fBspace\fP:" 10
|
|
Packit |
b099d7 |
ArmAndActivate()
|
|
Packit |
b099d7 |
.SS "Action Routines"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
The \fBXmDrawnButton\fP action routines are
|
|
Packit |
b099d7 |
.IP "Activate():" 10
|
|
Packit |
b099d7 |
If \fBXmNpushButtonEnabled\fP is True, redraws the shadow in the
|
|
Packit |
b099d7 |
unselected state; otherwise, redraws the shadow according to
|
|
Packit |
b099d7 |
\fBXmNshadowType\fP\&.
|
|
Packit |
b099d7 |
If the pointer is within the DrawnButton, calls the
|
|
Packit |
b099d7 |
\fBXmNactivateCallback\fP callbacks\&.
|
|
Packit |
b099d7 |
.IP "Arm():" 10
|
|
Packit |
b099d7 |
If \fBXmNpushButtonEnabled\fP is True, redraws the shadow in the
|
|
Packit |
b099d7 |
selected state; otherwise, redraws the shadow according to
|
|
Packit |
b099d7 |
\fBXmNshadowType\fP\&.
|
|
Packit |
b099d7 |
Calls the callbacks for \fBXmNarmCallback\fP\&.
|
|
Packit |
b099d7 |
.IP "ArmAndActivate():" 10
|
|
Packit |
b099d7 |
If \fBXmNpushButtonEnabled\fP is True, redraws the shadow in the
|
|
Packit |
b099d7 |
selected state; otherwise, redraws the shadow according to
|
|
Packit |
b099d7 |
\fBXmNshadowType\fP\&.
|
|
Packit |
b099d7 |
Calls the callbacks for \fBXmNarmCallback\fP\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
If \fBXmNpushButtonEnabled\fP is True, the shadow is redrawn in the
|
|
Packit |
b099d7 |
unselected state; otherwise, the shadow is redrawn according to
|
|
Packit |
b099d7 |
\fBXmNshadowType\fP\&.
|
|
Packit |
b099d7 |
The callbacks for \fBXmNactivateCallback\fP and \fBXmNdisarmCallback\fP
|
|
Packit |
b099d7 |
are called\&.
|
|
Packit |
b099d7 |
These actions happen either immediately or at a later
|
|
Packit |
b099d7 |
time\&.
|
|
Packit |
b099d7 |
.IP "ButtonTakeFocus():" 10
|
|
Packit |
b099d7 |
Causes the PushButton to take keyboard focus
|
|
Packit |
b099d7 |
when \fBCtrl<Btn1Down>\fP is pressed, without activating the widget\&.
|
|
Packit |
b099d7 |
.IP "Disarm():" 10
|
|
Packit |
b099d7 |
Marks the DrawnButton as unselected and calls the callbacks for
|
|
Packit |
b099d7 |
\fBXmNdisarmCallback\fP\&.
|
|
Packit |
b099d7 |
.IP "Help():" 10
|
|
Packit |
b099d7 |
Calls the callbacks for \fBXmNhelpCallback\fP if any exist\&.
|
|
Packit |
b099d7 |
If there are no help callbacks for this widget, this action calls the
|
|
Packit |
b099d7 |
help callbacks for the nearest ancestor that has them\&.
|
|
Packit |
b099d7 |
.IP "MultiActivate():" 10
|
|
Packit |
b099d7 |
If \fBXmNmultiClick\fP is \fBXmMULTICLICK_DISCARD\fP, this action does
|
|
Packit |
b099d7 |
nothing\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
If \fBXmNmultiClick\fP is \fBXmMULTICLICK_KEEP\fP, this action
|
|
Packit |
b099d7 |
increments \fIclick_count\fP in the callback structure\&.
|
|
Packit |
b099d7 |
If \fBXmNpushButtonEnabled\fP is True, this action redraws the shadow in the
|
|
Packit |
b099d7 |
unselected state; otherwise, it redraws the shadow according to
|
|
Packit |
b099d7 |
\fBXmNshadowType\fP\&.
|
|
Packit |
b099d7 |
If the pointer is within the DrawnButton, this action calls the
|
|
Packit |
b099d7 |
\fBXmNactivateCallback\fP callbacks and calls the
|
|
Packit |
b099d7 |
callbacks for \fBXmNdisarmCallback\fP\&.
|
|
Packit |
b099d7 |
.IP "MultiArm():" 10
|
|
Packit |
b099d7 |
If \fBXmNmultiClick\fP is \fBXmMULTICLICK_DISCARD\fP, this action does
|
|
Packit |
b099d7 |
nothing\&.
|
|
Packit |
b099d7 |
.IP "" 10
|
|
Packit |
b099d7 |
If \fBXmNmultiClick\fP is \fBXmMULTICLICK_KEEP\fP and
|
|
Packit |
b099d7 |
if \fBXmNpushButtonEnabled\fP is True, this action
|
|
Packit |
b099d7 |
redraws the shadow in the selected state;
|
|
Packit |
b099d7 |
otherwise, it redraws the shadow according to
|
|
Packit |
b099d7 |
\fBXmNshadowType\fP and
|
|
Packit |
b099d7 |
calls the callbacks for \fBXmNarmCallback\fP\&.
|
|
Packit |
b099d7 |
.SS "Additional Behavior"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
This widget has the following additional behavior:
|
|
Packit |
b099d7 |
.IP "\fB<EnterWindow>\fP:" 10
|
|
Packit |
b099d7 |
Draws the shadow in its selected state if \fBXmNpushButtonEnabled\fP is
|
|
Packit |
b099d7 |
True and if the cursor leaves and re-enters the window while \fBBSelect\fP is
|
|
Packit |
b099d7 |
pressed\&.
|
|
Packit |
b099d7 |
.IP "\fB<LeaveWindow>\fP:" 10
|
|
Packit |
b099d7 |
Draws the shadow in its unselected state if \fBXmNpushButtonEnabled\fP
|
|
Packit |
b099d7 |
is True and if the cursor leaves the window while \fBBSelect\fP is pressed\&.
|
|
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 \fBVirtualBindings\fP(3)\&.
|
|
Packit |
b099d7 |
.SH "RELATED"
|
|
Packit |
b099d7 |
.PP
|
|
Packit |
b099d7 |
\fBCore\fP(3), \fBXmCreateDrawnButton\fP, \fBXmLabel\fP(3),
|
|
Packit |
b099d7 |
\fBXmPrimitive\fP(3), \fBXmPushButton\fP, \fBXmSeparator\fP(3),
|
|
Packit |
b099d7 |
\fBXmVaCreateDrawnButton\fP,
|
|
Packit |
b099d7 |
\fBXmVaCreateManagedDrawnButton\fP\&.
|