| Platform | Since |
|---|---|
| iPhone | 0.8 |
| iPad | 0.8 |
A set of constants for the system button styles that can be used for the button style property.
These constants represent standard iOS system button styles that affect the Button, ButtonBar, and TabbedBar UI elements.
The different styles are used in different places. For normal buttons which are not contained in a nav bar, toolbar, button bar or tabbed bar, the following styles apply:
BORDERED. Simple button style with a rounded border and a white background.
The default style for normal buttons.DONE. Like the bordered button, but with a blue background. Button style for a button
that indicates completion, such as OK, Save, or Go. PLAIN Button style for an undecorated button. Note that if you specify the PLAIN style, you must style the button using the
other button properties. For example, there is no indication that the button has been
pressed unless you set other properties for the selected state, such as
backgroundSelectedImage and selectedColor.
When you add a button to a Toolbar, the styles have a slightly different effect:
PLAIN Button style for an undecorated button with large text and a glow effect
when the button is pressed. Default style for buttons in toolbars.BORDERED. Simple button style with a rounded border and a light blue background. DONE. Like the bordered button, but with a dark blue background. For TabbedBar and ButtonBar controls, styles have the following meaning:
PLAIN. Default style for ButtonBar and TabbedBar.BORDERED. Creates a bar like the PLAIN bar, but with a heavier border.BAR. Used on ButtonBar and TabbedBar controls to produce a more compact bar with
translucent buttons that allow the bar's background color to show through.| Name | Summary |
|---|---|
| addEventListener |
Adds the specified callback as an event listener for the named event. |
| fireEvent |
Fires a synthesized event to any registered listeners. |
| removeEventListener |
Removes the specified callback as an event listener for the named event. |
| Name | Type | Summary |
|---|---|---|
| BAR | Number |
Used with ButtonBar or TabbedBar only, to use the more condensed style used in nav bars and tool bars. read-only |
| BORDERED | Number |
A simple button style with a border. read-only |
| DONE | Number |
The style for a Done button--for example, a button that completes some task and returns to the previous view. read-only |
| PLAIN | Number |
Specifies a borderless button, the default style for toolbars, button bars, and tabbed bars. read-only |
