The Button widget is used to invoke an event or action when it is clicked.
Property | Description |
---|---|
id | The id is the identifier for the widget. |
buttonType | The following types of buttons can be specified
for the button type property:
|
text | Is the text that is displayed on the button for a user if a value has not been assigned for it. |
visibility | The visibility property
defines how a widget is displayed on a GUI. The following values can
be specified for this property:
|
disabled | Disabled elements cannot have focus, do not receive or fire mouse events, cannot receive user input. If you select a value of true for the disabled property, the widget is displayed on a GUI but a user cannot interact with it. Data contained in a disabled widget is not processed when the form is submitted. The default value for the disabled property is false. |
shortcut | Shortcut is a single character from the document
character set. Pressing a shortcut assigned to a widget together with
hot key of browser gives focus to the widget. Different widget may
have different action when it receives focus. For example, when user
activates a TextBox, this TextBox is focused and all texts are selected;
when user activates a button, this button is focused and selected.
BTT supports shortcut function based on standard html access key and
browser capability. That's mean the shortcut character and the hot
key may be different in different browsers. For more information about
html access key you can refer to the following links: http://www.w3.org/TR/html4/interact/forms.html#adef-accesskey http://en.wikipedia.org/wiki/Access_key Action
for Button is: focus and select button |
hint | The hint is a description of the widget that is displayed as a tooltip for a user. The hint property has multilingual support. |
icon | The icon property specifies the relative path of the icon that is displayed on the button. This is an optional property. |
action | The action property specifies the server-side
action that is triggered when the Button widget is clicked. This property
is set in the Action tab of the Properties view.
The action property consists of the following sub-properties:
|
styleClass | The styleClass property specifies the name of the CSS style ( also known as CSS style class) associated with the widget. This property is set by selecting a style from the CSS styles table in the Style tab of the Properties view. If you do not configure the styleClass property, the default style is used instead. For more detailed information, refer to Setting CSS style to widgets. |
width | The width property specifies the width of the widget. This property is set in the Appearance tab of the Properties view. |
height | The height property specifies the height of the widget. This property is set in the Appearance tab of the Properties view. |
Event | Description |
---|---|
onClick | Is fired when the left mouse button is clicked. |
onFocus | Is fired when the widget receives focus because the user moves the mouse pointer over the widget. |
onBlur | Is fired when the widget does not receive focus, or when the user clicks outside the widget, or when the widget is hidden. |
onKeyDown | Is fired when a keyboard key is pressed. |
onKeyUp | Is fired when a keyboard key is released. |
onKeyPress | Is fired when a keyboard key is pressed or held down. |
onMouseDown | Is fired when a mouse button is clicked. |
onMouseUp | Is fired when a mouse button is released |
onMouseEnter | Is fired when the mouse pointer moves over the widget. |
onMouseLeave | Is fired when the mouse pointer moves out of the widget. |
onMouseMove | Is fired when the mouse pointer moves over nodes that are contained in the widget. |
Property | Description |
---|---|
id | The id is the identifier
for the widget. Note: This
property can be used in the Condition part
of ECA rule.
|
isValid | Submit button will only be enabled when the
isValid property is true and the form containing the button has passed
all the validations (field and cross validations). The default value
is true. Note: This property can be used in the Actions part
of ECA rule.
|
icon | The icon property specifies the relative path
of the icon that is displayed on the button. This is an optional property. Note: This
property can be used in the Condition and Actions part
of ECA rule.
|
text | The text property is the
text that is displayed on the label for a user if a value has not
been assigned for the dataName property.
This is an optional property. Note: This
property can be used in the Condition and Actions part
of ECA rule.
|
visibility | The visibility
property defines how a widget is displayed on a GUI. The following
values can be specified for this property:
Note: This property can be used in the Condition and Actions part
of ECA rule.
|
disabled | Disabled elements
cannot have focus, do not receive or fire mouse events, cannot receive
user input. If you select a value of true for the
disabled property, the widget is displayed on a GUI but a user cannot
interact with it. Data contained in a disabled widget is not processed
when the form is submitted. The default value for the disabled property
is false. Note: This property can be used in
the Condition and Actions part
of ECA rule.
|
hint | The hint is a description of the widget that
is displayed as a tooltip for a user. The hint property has multilingual
support. Note: This property can be used in the Actions part
of ECA rule.
|
styleClass | The styleClass property
specifies the name of the CSS style ( also known as CSS style class)
associated with the widget. This property is set by selecting a style
from the CSS styles table in the Style tab of the Properties view.
If you do not configure the styleClass property, the default style
is used instead. For more detailed information, refer to Setting CSS style to widgets. Note: This
property can be used in the Actions part of
ECA rule.
|
Function | Description |
---|---|
isFocusable | Returns a value of true if
a widget can be focused and a value of false if it
cannot be focused. Note: The
function can be used in the Condition part
of ECA rule.
|
focus | Specifies that the widget
should be focused. Note: The
function can be used in the Actions part of
ECA rule.
|