Button

Last Updated On 2021-07-16

Button with the ability to detect clicks. Many aspects of its appearance can be changed, as well as whether it is clickable (Enabled), can be changed in the Designer or in the Blocks Editor.

Properties

You can set the below properties in the UI part of the builder.

BackgroundColor - it's a color value which is set to &h00000000 by default.
CustomFontTypeFace - it's a asset value which is set to blank by default.
Enabled - it's a boolean value which is set to true by default.
FontBold - it's a boolean value which is set to false by default.
FontItalic - it's a boolean value which is set to false by default.
FontSize - it's a non negative float value which is set to 14.0 by default.
FontTypeface - it's a typeface value which is set to 0 by default.
HeihMargin - it's a four value which is set to 0,0,0,0 by default.
HeihPadding - it's a four value which is set to 10,10,0,0 by default.
Image - it's a asset value which is set to blank by default.
MarginBottom - it's a non negative float value which is set to 0 by default.
MarginLeft - it's a non negative float value which is set to 0 by default.
MarginRight - it's a non negative float value which is set to 0 by default.
MarginTop - it's a non negative float value which is set to 0 by default.
Opacity - it's a integer value which is set to 0 by default.
PaddingBottom - it's a non negative float value which is set to 0 by default.
PaddingLeft - it's a non negative float value which is set to 0 by default.
PaddingRight - it's a non negative float value which is set to 0 by default.
PaddingTop - it's a non negative float value which is set to 0 by default.
Shape - it's a button shape value which is set to 0 by default.
ShowFeedback - it's a boolean value which is set to true by default.
Text - it's a string value which is set to blank by default.
TextAlignment - it's a textalignment value which is set to 1 by default.
TextColor - it's a color value which is set to &h00000000 by default.
Visible - it's a visibility value which is set to true by default.

Block Properties

You can set the below blocks properties in the blocks section of the builder.

BackgroundColor

Returns the button's background color

CustomFontTypeFace

Sets the custom font

Enabled

If set, user can tap Button to cause action.

FontBold

If set, Button text is displayed in bold.

FontItalic

If set, Button text is displayed in italics.

Height

Specifies the vertical height of the Button, measured in pixels.

HeightPercent

Specifies the vertical height of the Button as a percentage of the height of the Screen.

Image

Image to display on button.

MarginBottom

Property for MarginBottom

MarginLeft

Property for MarginLeft

MarginRight

Property for MarginRight

MarginTop

Property for MarginTop

Opacity

Set opacity value between 1 to 10

PaddingBottom

Property for PaddingBottom

PaddingLeft

Property for PaddingLeft

PaddingRight

Property for PaddingRight

PaddingTop

Property for PaddingTop

ShowFeedback

Specifies if a visual feedback should be shown for a Button that has an image as background.

Text

Text to display on Button.

TextColor

Color for button text.

Visible

Specifies whether the Button should be visible on the screen. Value is true if the Button is showing and false if hidden.

Width

Specifies the horizontal width of the Button, measured in pixels.

WidthPercent

Specifies the horizontal width of the Button as a percentage of the width of the Screen.

Methods

You can set the below method blocks in the blocks section of the builder.

PerformClick

Method for PerformClick

Events

You can set the below event blocks in the blocks section of the builder.

Click

User tapped and released the button.

GotFocus

Indicates the cursor moved over the Button so it is now possible to click it.

LongClick

User held the button down.

LostFocus

Indicates the cursor moved away from the Button so it is now no longer possible to click it.

TouchDown

Indicates that the Button was pressed down.

TouchUp

Indicates that the Button has been released.