LessTif Manual Page - Widget Classes

XmDrawnButton

Synopsis

Description

The DrawnButton does not manage its own Expose and ConfigureNotify events. Like the DrawingArea widget, these events are handled with Expose and Resize callbacks.

In addition, the DrawnButton also supports an optional three-dimensional shadow border. This can be used to make the widget look like a PushButton widget.

New Resources

XmNmultiClick

The multiClick resource specifies the action to be taken if the user clicks on the button twice within the timespan specified by the display`s multiclick time. Possible values are:

• XmMULTI_CLICK_KEEP
• XmMULTI_CLICK_DISCARD

XmNpushButtonEnabled

The pushButtonEnabled resource specifies whether or not the widget displays a three-dimensional(shadow) border.

XmNshadowType

The shadowType resource specifies the type of three-dimensional border to be displayed when XmNpushButtonEnabled is set to True. Possible values are:

• XmSHADOW_IN
• XmSHADOW_OUT
• XmSHADOW_ETCHED_IN
• XmSHADOW_ETCHED_OUT

• XmLabel
  

  Resources

  Name	Class	Type	Default	Access
  XmNaccelerator	XmCAccelerator	XmString	XmUNSPECIFIED	CSG
  XmNacceleratorText	XmCAcceleratorText	XmString	XmUNSPECIFIED	CSG
  XmNalignment	XmCAlignment	unsigned char	XmALIGNMENT_CENTER	CSG
  XmNfontList	XmCFontList	XmRFontlist	XmUNSPECIFIED	CSG
  XmNlabelInsensitivePixmap	XmCLabelInsensitivePixmap	XmRPixmap	XmUNSPECIFIED_PIXMAP	CSG
  XmNlabelPixmap	XmCLabelPixmap	XmRPixmap	XmUNSPECIFIED_PIXMAP	CSG
  XmNlabelString	XmCLabelString	XmString	XmUNSPECIFIED	CSG
  XmNlabelType	XmCLabelType	XmRLabelType	XmSTRING	CSG
  XmNmarginBottom	XmCMarginBottom	XmRDimension	0	CSG
  XmNmarginHeight	XmCMarginHeight	XmRDimension	2	CSG
  XmNmarginLeft	XmCMarginLeft	XmRDimension	0	CSG
  XmNmarginRight	XmCMarginRight	XmRDimension	0	CSG
  XmNmarginTop	XmCMarginTop	XmRDimension	0	CSG
  XmNmarginWidth	XmCMarginWidth	XmRDimension	2	CSG
  XmNmnemonicCharSet	XmCMnemonicCharSet	XmString	XmFONTLIST_DEFAULT_TAG	CSG
  XmNrecomputeSize	XmCRecomputeSize	XmRBoolean	True	CSG
  XmNstringDirection	XmCStringDirection	XmStringDirection	NULL	CSG
  XmNtraversalOn	XmCTraversalOn	Boolean	False	CSG
  XmNhighlightOnEnter	XmCHighlightOnEnter	Boolean	False	CSG

  
  
• XmPrimitive
  

  XmPrimitive Resources

  Name	Type	Default	Access
  XmNforeground	Pixel	_XmForegroundColorDefault	CSG
  XtNbackground	Pixel	_XmBackgroundColorDefault	CSG
  XmNbottomShadowColor	Pixel	_XmBottomShadowColorDefault	CSG
  XmNbottomShadowPixmap	Pixmap	XmUNSPECIFIED_PIXMAP	CSG
  XmNtopShadowColor	Pixel	_XmTopShadowColorDefault	CSG
  XmNtopShadowPixmap	Pixmap	XmUNSPECIFIED_PIXMAP	CSG
  XmNshadowThickness	Dimension	2	CSG
  XmNhighlightColor	Pixel	_XmHighlightColorDefault	CSG
  XmNhighlightOnEnter	Boolean	False	CSG
  XmNhighlightPixmap	Pixmap	XmUNSPECIFIED_PIXMAP	CSG
  XmNhighlightThickness	Dimension	2	CSG
  XmNnavigationType	XmNavigationType	XmNONE	CSG
  XmNtraversalOn	Boolean	True	CSG
  XmNunitType	unsigned char	0	CSG
  XmNuserData	XtPointer	NULL	CSG
  XmNhelpCallback	XtCallbackList	NULL	C

  
  
• Core
  

  Core Resources

  Name	Type	Default	Access
  XmNaccelerators	XmString	XmUNSPECIFIED	CSG
  XmNancestorSensitive	Boolean	TRUE	G
  XmNbackground	Pixel	_XmBackgroundColorDefault	CSG
  XmNbackgroundPixmap	Pixmap	XmUNSPECIFIED_PIXMAP	CSG
  XmNborderColor	Pixel	Black	CSG
  XmNborderPixmap	Pixmap	XmUNSPECIFIED_PIXMAP	CSG
  XmNborderWidth	int	1	CSG
  XmNcolormap	Colormap	XmUNSPECIFIED	CG
  XmNdepth	int	1	CSG
  XmNdestroyCallback	XtCallbackList	NULL	C
  XmNheight	Dimension	0	CSG
  XmNmappedWhenManaged	Boolean	TRUE	CSG
  XmNscreen	Screen *	0	CG
  XmNsensitive	Boolean	True	CSG
  XmNtranslations	XtTranslations	NULL	CSG
  XmNwidth	Dimension	0	CSG
  XmNx	Position	0	CSG
  XmNy	Position	0	CSG

  
  

New Callback Resources

Name	Reason
XmNactivateCallback	XmCR_ACTIVATE
XmNarmCallback	XmCR_ARM
XmNdisarmCallback	XmCR_DISARM
XmNexposeCallback	XmCR_EXPOSE
XmNresizeCallback	XmCR_RESIZE

XmNactivateCallback

The activateCallback specifies a list of callback functions that is called when the widget is activated. The widget is activated by pressing and releasing BSelect on the widget.

XmNarmCallback

The armCallback specifies a list of callback functions that is called when the widget is armed. The widget is armed by pressing BSelect on the widget.

XmNdisarmCallback

The disarmCallback specifies a list of callback functions that is called when the widget is disarmed. The widget is disarmed by releasing BSelect on the widget. It is assumed that BSelect was just pressed on the widget.

XmNexposeCallback

The exposeCallback specifies a list of callbacks that is called when the widget receives an Expose event.

XmNresizeCallback

The resizeCallback specifies a list of callbacks that is called when the widget receives a Resize event.

Callback Structure

typedef struct
{
int     reason;
XEvent  *event;
Window  window;
int     click_count;
} XmDrawnButtonCallbackStruct;

Arm()

Activate()

Disarm()

ArmAndActivate()

Help()

EnterWindow()

LeaveWindow()

• Widget XmCreateDrawnButton(Widget Parent,char *Name,Arg *arglist,Cardinal count )
• XmIsDrawnButton(Widget w)

Creation Using XmCreateDrawnButton convenience function:

Widget drawnb = XmCreateDrawnButton(parent, "Less is Mo", NULL, 0);
XtManageChild(drawnb);

Widget drawnb = XtVaCreateManagedWidget(
"Less is Mo", 
xmDrawnButtonWidgetClass, 
parent,
NULL);