WkImageButtonView

WkImageButtonViews provide a mechanism to initiate an action when clicked on. They call their clicked event when they are pressed and released. Image buttons may have an image and/or text string for a label. The image and text labels may be layed out either vertically or horizontally. Different images and labels can be specified for the up state, the pressed state and the disabled state.

Protocol

alignment: resourceValue
Sets the horizontal alignment for the widget's image.

Default: XmALIGNMENTBEGINNING (Left)

Valid resource values:

XmALIGNMENTBEGINNING (Left) - Causes the center of the image to be horizontally aligned with the left edge of the widget's window.

XmALIGNMENTCENTER (Center) - Causes the center of the image to be horizontally aligned in the center of the widget's window.

XmALIGNMENTEND (Right) - Causes the center of the image to be horizontally aligned with the right edge of the widget's window.

 

click
Programatically click the button.

 

disabledGraphicsDescriptor: aGraphicsDescriptor
Specifies the graphics descriptor which draws on the face of the widget when it is disabled.

 

disabledLabelString: aString
Specifies the renderable object (string) which draws on the face of the widget when it is disabled.

 

drawPolicy: anInteger
Specifies the drawing policy used in rendering buttons. The drawing policy determines two things for a button:

1. how the button draws itself so it looks like a button;
2. how the button animates when pressed.

Default: XmFLATDRAWPOLICY (Flat)

Valid resource values:

XmSHADOWEDTWOSTATEDRAWPOLICY (Shadowed Two State) - Buttons are drawn with a 3D shadowed outline and exhibit a simple 2-state (OFF and ON) state rendering.

XmSHADOWEDTHREESTATEDRAWPOLICY (Shadowed Three State) - Buttons are drawn with a 3D shadowed outline and exhibit a 3-state (OFF, ON, and PRESSED) state rendering.

XmOUTLINEDRAWPOLICY (Outlined) - Buttons are drawn with a simple etched (non-shadowed) outline and exhibit a 2-state (OFF and ON) state rendering.

XmFLATDRAWPOLICY (Flat) - Buttons are drawn flat without a 3D shadow.

 

graphicsDescriptor: aGraphicsDescriptor
Specifies the graphics descriptor which draws on the face of the widget.

 

labelString: aString
Specifies the renderable object (string) which draws on the face of the widget.

 

mnemonic: aCharacter
Provides the user with alternate means for selecting a button.

 

orientation: anInteger
Specifies whether the image and label are displayed vertically or horizontally.

Default: XmHORIZONTAL (Horizontal)

Valid resource values:

XmVERTICAL (Vertical) - Displays the image and label vertically.

XmHORIZONTAL (Horizontal) - Displays the image and label horizontally.

 

pressedGraphicsDescriptor: aGraphicsDescriptor
Specifies the graphics descriptor which draws on the face of the widget when it is pressed.

 

pressedLabelString: aString
Specifies the renderable object (string) which draws on the face of the widget when it is pressed.

 

showAsDefault: aBoolean
Specifies whether the PushButton should be visually marked as a default button.

 

verticalAlignment: anInteger
Specifies the vertical alignment for the widget's image.

Default: XmALIGNMENTCENTER (Center)

Valid resource values:

XmALIGNMENTCENTER (Center) - Causes the center of the image to be vertically aligned in the center of the widget's window.

XmALIGNMENTTOP (Top) - Causes the top edge of the image to be vertically aligned with the top edge of the widget's window.

XmALIGNMENTBOTTOM (Bottom) - Causes the center of the image to be vertically aligned in the center of the widget's window.

Events

Clicked
These events are triggered when the button has been clicked. Buttons are clicked when the mouse is clicked and released within the button. Buttons may also be clicked via the space bar when the button has focus or via a carriage return when a button is a default button.

 

Default Action Requested
These events are triggered when the widget is double clicked.