Power button

Typewidget
Dictionarywidget.powerbutton
LibraryPower button
Associationscom.livecode.widget.powerbutton
Summary

This widget is a highly customizable button, maintains its appearance regardless of platform or OS.

OSmac, windows, linux, ios, android, web
Platformsdesktop, mobile
Description

This widget is a highly customizable button, maintains its appearance regardless of platform or OS.

TypeNameSummarySyntax
propertybtnHighlightedIconPath

The path data displayed by the widget as icon when the button is in its highlighted state.

set the btnHighlightedIconPath of widget to <SVGPath>

get the btnHighlightedIconPath of widget

- - -btnHighlitedIcon

The name of an SVG icon, which is displayed as an icon when the button is in its highlighted state.

set the btnHighlitedIcon of widget to <IconName>

get the btnHighlitedIcon of widget

- - -btnIcon

The name of an SVG icon, which is displayed as an icon when the button is in its normal state.

set the btnIcon of widget to <IconName>

get the btnIcon of widget

- - -btnIconPath

The path data displayed by the widget as icon when the button is in its normal state.

set the btnIconPath of widget to <SVGPath>

get the btnIconPath of widget

- - -centerElements

Specifies whether the icon and label of the widget (Power button) are pushed to the center.

set the centerElements of widget to {true | false}

get the centerElements of widget

- - -fillGradient

Specifies the gradient to use to fill the PowerButton object in its normal state (Experimental)

set the fillGradient of widget to <Array>

get the fillGradient of widget

- - -highlightedIconColor

The color with which the icon is drawn, when the button is highlighted.

set the highlightedIconColor of widget to <RGB color>

get the highlightedIconColor of widget

- - -highlightedLabel

Specifies the string to display in the text label that is drawn on the widget when its state is Highlighted.

set the highlightedLabel of widget to <labelString>

get the highlightedLabel of widget

- - -highlightedLabelColor

The color with which the label is drawn, when the button is highlighted.

set the highlightedLabelColor of widget to <RGB color>

get the highlightedLabelColor of widget

- - -highlightedTransparentBackground

Specifies whether the background of a button is transparent when its state is highlighted.

set the highlightedTransparentBackground of widget to {true | false}

get the highlightedTransparentBackground of widget

- - -hiliteColor

Controls the color of the button.

get the hiliteColor of <widget>

set the hiliteColor of <widget> to <pColor>

- - -hiliteFillGradient

Specifies the gradient to use to fill the PowerButton object when it is hilited(Experimental)

set the hiliteFillGradient of widget to <Array>

get the hiliteFillGradient of widget

- - -hoverFillGradient

Specifies the gradient to use to fill the PowerButton object when the mouse is hovering (Experimental)

set the hoverFillGradient of widget to <Array>

get the hoverFillGradient of widget

- - -hoverIconColor

The color with which the icon is drawn when the pointer is over the button.

set the hoverIconColor of widget to <RGB color>

get the hoverIconColor of widget

- - -hoverLabelColor

The color with which the label is drawn when the pointer is over the button.

set the hoverLabelColor of widget to <RGB color>

get the hoverLabelColor of widget

- - -hoverTransparentBackground

Specifies whether the background of a button is transparent when the mouse pointer enters the button.

set the hoverTransparentBackground of widget to {true | false}

get the hoverTransparentBackground of widget

- - -hoverWhenHilited

Allows the mouse hover effect to be generated when the button has the toggle property active.

set the hoverWhenHilited of widget to {true | false}

get the hoverWhenHilited of widget

- - -iconColor

The color with the icon is drawn when the button is in its normal state.

set the iconColor of widget to <RGB color>

get the iconColor of widget

- - -iconHOffset

Horizontal offset of the icon.

set the iconHOffset of widget to <integer>

get the iconHOffset of widget

- - -iconPosition

Specifies the alignment that the icon has with respect to the sides of the button.

set the iconPosition of widget to {left | right | top | bottom}

get the iconPosition of widget

- - -iconRotation

Rotate the icon.

set the iconRotation of widget to {true | false}

get the iconRotation of widget

- - -iconSize

Set the iconSize.

set the iconSize of widget to <Integer>

get the iconSize of widget

- - -iconVOffset

Vertical offset of the icon.

set the iconVOffset of widget to <integer>

get the iconVOffset of widget

- - -isToggle

Specifies whether a button stays highlighted after being pressed.

set the isToggle of widget to {true | false}

get the isToggle of widget

- - -Label

The label displayed by the button.

set the label of widget to pLabel

get the label of widget

- - -labelColor

The color with which the label is drawn.

set the labelColor of widget to <RGB color>

get the labelColor of widget

- - -labelHOffset

Horizontal offset of the label.

set the labelHOffset of widget to <integer>

get the labelHOffset of widget

- - -labelToUpper

Transform the label to upper case.

set the labelToUpper of widget to {true | false}

get the labelToUpper of widget

- - -labelVOffset

Vertical offset of the label.

set the labelVOffset of widget to <integer>

get the labelVOffset of widget

- - -margin

Specifies how much empty space is left on each side between the borders of the widget and its icon and label.

set the margin of widget to <integer>

get the margin of widget

- - -pbHoverColor

The color with which the background of the button is drawn when the pointer is over it.

set the pbHoverColor of widget to <RGB color>

get the pbHoverColor of widget

- - -pbNormalColor

Controls the background color of the button

get the pbNormalColor of <widget>

set the pbNormalColor of <widget> to <pColor>

- - -pbShadowColor

The color with which the drop shadow is drawn.

set the pbShadowColor of widget to <RGBA color>

get the pbShadowColor of widget

- - -rippEffect

Shows the ripple Effect when pressed or not.

set the rippEffect of widget to {true | false}

get the rippEffect of widget

- - -rippleColor

Controls the color of the ripple effect.

get the rippleColor of <widget>

set the rippleColor of <widget> to <RGBAColor>

- - -roundedRadius

The radius of the widget background edges.

set the roundedRadius of widget to <integer>

get the roundedRadius of widget

- - -roundheight

The radius of the widget background edges.

set the roundedRadius of widget to <integer>

get the roundedRadius of widget

- - -showIcon

Specifies whether the widget (Power button) icon is visible.

set the showIcon of widget to {true | false}

get the showIcon of widget

- - -showIconDivider

Specifies whether the widget (Power button) icon divider is visible.

set the showIconDivider of widget to {true | false}

get the showIconDivider of widget

- - -showShadow

Whether the widget has a shadow or not.

set the showShadow of widget to {true | false}

get the showShadow of widget

- - -textAlignment

Specifies the alignment that the text displayed in the label has with respect to the sides of the button.

set the textAlignment of widget to {center | left | right | top | bottom}

get the textAlignment of widget

- - -transparentBackground

Specifies whether the background of a button is transparent when its state is normal.

set the transparentBackground of widget to {true | false}

get the transparentBackground of widget

widgetPower button

This widget is a highly customizable button, maintains its appearance regardless of platform or OS.

set the transparentBackground of widget to {true | false}

get the transparentBackground of widget