ToolBarItem¶
ToolBarItem is a control item that can be added to the tool bar.
ToolBarItem Properties¶
Property | Type | Required | Default |
---|---|---|---|
Caption | string |
No | |
Clickable | boolean |
No | true |
Enabled | boolean |
No | true |
Icon | Image | No | |
ItemType | enum |
No | |
OnPress | ActionOrRule | No | |
Style | string |
No | |
SystemItem | SystemItem | No | |
Visible | boolean |
No | true |
Width | integer |
No | |
_Name | string |
No | |
_Type | const |
Yes |
Caption¶
Displayed label of the toolbar item. The default value is the same as the value of _Name
.
- type:
string
Clickable¶
Indicates if the toolbar item is clickable. If the value is false, the item cannot be enabled and behaves like a label.
- type:
boolean
- default:
true
Enabled¶
Enables or disables the toolbar item.
- type:
boolean
- default:
true
Icon¶
Adds an image to your toolbar. Overwrites Caption
, if specified.
- type: Image
ItemType¶
Indicates the item type of the toolbar item. It provides two options: Normal
(text button) and Button
(contained
button). This parameter is applicable only to Android.
- type:
enum
The value of this property must be one of the known values listed below.
ItemType Known Values¶
Value | Description |
---|---|
Button |
|
Normal |
OnPress¶
Action/Rule to be triggered when the toolbar item is pressed.
- type: ActionOrRule
- Formatter and Binding are not supported
Style¶
The string value is a style class name of Icon
.
- type:
string
SystemItem¶
Adds predefined system-supplied icon or text. Overwrites Caption
and Icon
if specified.
If you set the width but not the icon or caption, then an empty space with the specified width will be rendered.
On Android devices, the SystemItem
renders with black colored icon due to the white background.
- type: SystemItem
Visible¶
Set the visibility of this control.
- type:
boolean
- default:
true
Width¶
The width of the control in Device Independent Pixel. The DIP value will be converted to pixels of the platform (based on scale and on density for iOS and Android respectively).
Mandatory if SystemItem
is set to FixedSpace
, optional for Caption
and Icon
.
By default, the caption and icon widths are calculated automatically.
- type:
integer
_Name¶
- type:
string
_Type¶
- type:
const
The value of this property must be:
"Control.Type.ToolbarItem"