# Titanium.UI.iOS.SystemButton

> A set of constants for creating standard iOS system buttons.

- Source: https://titaniumsdk.com/docs/sdk/13.3.0/Titanium.UI.iOS.SystemButton
- Titanium SDK version: 13.3.0
- Kind: proxy
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK iPhone 5.4.0, iPad 5.4.0, macOS 9.2.0
- Extends: Titanium.Proxy
- Inheritance: Titanium.Proxy

Most of these constants are used with the
[Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) property to define a standard
iOS system buttons for use in navigation bars and toolbars.

See [Titanium.UI.Button](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md) for more information on the `systemButton` property, including details
on where system buttons can be used. In an Alloy application you can omit the `Ti.UI.iOS.SystemButton`
namespace when assigning a value to the `<Button>` element's `systemButton` attribute,
for example:

``` xml
<Button systemButton="CAMERA"/>
<!-- Instead of -->
<Button systemButton="Titanium.UI.iOS.SystemButton.CAMERA"/>
```

A few of these constants are used with [Button.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#style) to
create standard iOS buttons that can be used in other places, including table view rows.
Note: Starting at Titanium SDK 5.0, all icons have are automatically sized in the native behavior and are not distorted any more. These standard button types are:

* [CONTACT_ADD](https://titaniumsdk.com/docs/sdk/Titanium.UI.iOS.SystemButton.md#CONTACT_ADD)
* [DISCLOSURE](https://titaniumsdk.com/docs/sdk/Titanium.UI.iOS.SystemButton.md#DISCLOSURE)
* [INFO_DARK](https://titaniumsdk.com/docs/sdk/Titanium.UI.iOS.SystemButton.md#INFO_DARK)
* [INFO_LIGHT](https://titaniumsdk.com/docs/sdk/Titanium.UI.iOS.SystemButton.md#INFO_LIGHT)

See Apple's 
[iOS Human Interface Guidelines](https://developer.apple.com/ios/human-interface-guidelines/overview/themes/) in the iOS Developer Library for details on the proper usage of iOS standard buttons and icons.

![System Icons](./system_icons.png)

## Properties

### ACTION

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify an **Action** button.

The resulting button can only be used in navigation bars and toolbars.

### ACTIVITY

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to create an activity indicator that
can be used in navigation bars and toolbars.

When visible, the activity indicator is already started.

### ADD

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify an **Add** button.

The resulting button can only be used in navigation bars and toolbars.

### BOOKMARKS

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Bookmarks** button.

The resulting button can only be used in navigation bars and toolbars.

### CAMERA

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Camera** button.

The resulting button can only be used in navigation bars and toolbars.

### CANCEL

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Cancel** button.

This button is displayed as a bordered button with localized text.

The resulting button can only be used in navigation bars and toolbars.

### COMPOSE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Compose** button.

The resulting button can only be used in navigation bars and toolbars.

### CONTACT_ADD

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#style) to specify a **ContactAdd** button.

The resulting button is not restricted to use in navigation bars and toolbars.

### DISCLOSURE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#style) to specify a **Disclosure** button.

The resulting button is not restricted to use in navigation bars and toolbars.

### DONE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Done** button.

This button is displayed as a bordered button with localized text.

The resulting button can only be used in navigation bars and toolbars.

### EDIT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify an **Edit** button.

This button is displayed as a bordered button with localized text.

The resulting button can only be used in navigation bars and toolbars.

### FAST_FORWARD

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Fast Forward** button.

The resulting button can only be used in navigation bars and toolbars.

### FIXED_SPACE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to create a fixed-width blank space 
for spacing items in toolbars.

Only the `width` property is used when this value is set.

### FLEXIBLE_SPACE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to create a flexible blank space 
for spacing items in toolbars.

The space is distributed equally between the other 
items. Other item properties are ignored when this value is set.

### INFO_DARK

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#style) to specify a dark-colored **Info** button.

The resulting button is not restricted to use in navigation bars and toolbars.

### INFO_LIGHT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#style) to specify a light-colored **Info** button.

The resulting button is not restricted to use in navigation bars and toolbars.

### ORGANIZE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify an **Organize** button.

The resulting button can only be used in navigation bars and toolbars.

### PAUSE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Pause** button.

The resulting button can only be used in navigation bars and toolbars.

### PLAY

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Play** button.

The resulting button can only be used in navigation bars and toolbars.

### REFRESH

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Refresh** button.

The resulting button can only be used in navigation bars and toolbars.

### REPLY

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Reply** button.

The resulting button can only be used in navigation bars and toolbars.

### REWIND

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Rewind** button.

The resulting button can only be used in navigation bars and toolbars.

### SAVE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Save** button.

This button is displayed as a bordered button with localized text.

The resulting button can only be used in navigation bars and toolbars.

### SPINNER

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Identical to [ACTIVITY](https://titaniumsdk.com/docs/sdk/Titanium.UI.iOS.SystemButton.md#ACTIVITY).

### STOP

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Stop** button.

The resulting button can only be used in navigation bars and toolbars.

### TRASH

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use with [Button.systemButton](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#systemButton) to specify a **Trash** button.

The resulting button can only be used in navigation bars and toolbars.

## Inherited members

6 members are inherited. Each is documented on the type that declares it.

- [Titanium.Proxy](https://titaniumsdk.com/docs/sdk/13.3.0/Titanium.Proxy.md): `addEventListener`, `apiName`, `applyProperties`, `bubbleParent`, `fireEvent`, `removeEventListener`

---

- This corpus documents Titanium SDK 13.4.1. Anything here that does not name a version describes 13.4.1.
- Titanium is maintained by TiDev. The Appcelerator toolchain is retired: there is no `appc` CLI, no Appcelerator Studio and no hosted build service. The supported CLI is `titanium` on npm, invoked as `ti`.