Button

Represents a button control that reacts to touch events.

Properties

Property	Type	Description
Background	Color	The background color of the control.
Border	Color	The color of the control's border.
BorderThickness	Float	The width of the control's border.
CornerRadius	Integer	The radius for the corners of the control's border.
Foreground	Color	The color of the control's content.
Icon	Icon	The icon for the control.
IconPosition	Enum	The position of the icon relative to the text. Possible values are Left, Right, & Top.
IconSize	Float	The size of the icon in dp pixels.
IconSpacing	Float	The spacing between the icon and text.
ShowAsMonochrome	Boolean	A value that indicates whether the Foreground color is applied to the icon.
FontSize	Float	The size of the text in dp pixels.
FontStyle	Enum	The style in which the text is rendered. Possible values are Normal & Italic.
FontWeight	Enum	The thickness of the specified font. Possible values are Thin, Light, Normal, Medium, Bold, Black
Text	String	A string that specifies the text contents of the button.
TextDecorations	Enum	A value that indicates what decorations are applied to the text. Possible values are None, Strikethrough, & Underline.
ButtonType	Enum	The type of button. Possible values are Normal, Repeat, & Toggle.
IsChecked	Boolean	A value that indicates whether the button is checked. This applies only when ButtonType is set to Toggle
IsPressed	Boolean	A value that indicates whether the button is currently in a pressed state.
RepeatInterval	Integer	The time, in milliseconds, between repetitions of the click action, as soon as repeating starts. This applies only when ButtonType is set to Repeat.
Height	Float	The suggested height of the control in dp pixels.
HorizontalAlignment	Enum	The horizontal alignment characteristics that are applied to the control when it is composed in a parent layout panel, such as a Grid.
HorizontalContentAlignment	Enum	The horizontal alignment of the control's content.
Margin	Thickness	The outer margin that is applied to the control when it is composed in a parent layout panel, such as a Grid.
Padding	Thickness	The amount of space between the content of the control and its border.
Rotation	Integer	The rotation about the Z-axis in degrees.
VerticalAlignment	Enum	The vertical alignment characteristics that are applied to the control when it is composed in a parent layout panel, such as a Grid.
VerticalContentAlignment	Enum	The vertical alignment of the control's content
Width	Float	The suggested width of the control in dp pixels.
IsEnabled	Boolean	A value that indicates whether the user can interact with the control.
IsHitTestVisible	Boolean	A value that indicates whether the contained area of the control can return true values for hit testing.
IsVisible	Boolean	A value that indicates whether the control should be visible.
Opacity	Float	A value between 0 and 1.0 that declares the opacity factor, with 1.0 meaning full opacity and 0 meaning transparent.

Events

Event	Description
Loaded	Occurs when the element is laid out, rendered, and ready for interaction.
Unloaded	Occurs when the element is no longer rendered on the screen.
Clicked	Occurs when the button control is clicked.
Pressed	Occurs when the button control is pressed.
Released	Occurs when the button control is released.
Canceled	Occurs when the button control click is canceled.
Checked	Occurs when the button is checked. This applies only when ButtonType is set to Toggle.
Unchecked	Occurs when the button is unchecked. This applies only when ButtonType is set to Toggle.