Livecode Wiki
Advertisement

Specifies whether the icon of a button is placed independently of the label.

Syntax:

set the iconGravity of button to position


Examples:

set the iconGravity of button "next" to "top"


Use to iconGravity property to position the icon of a button independent of the label.

Position is a string representing to desired layout of the icon of the button and is one of the following:

  • empty - This property has no effect and placement of the icon follows previous engine rules.
  • left - Renders the icon at the middle left side of the button.
  • top - Renders the icon at the middle top of the button.
  • right - Renders the icon at the middle right of the button.
  • bottom - Renders the icon at the middle bottom of the button.
  • topLeft - Renders the icon at the top left of the button.
  • topRight - Renders the icon at the top right of the button.
  • bottomLeft - Renders the icon at the bottom left of the button.
  • bottomRight - Renders the icon at the bottom right of the button.
  • center - Renders the icon in the center of the button.
  • resize - Stretches the icon to fill the button.


By default, the iconGravity property of an button is empty.

The margins and borderWidth are taken into account when rendering the icon - the rectangle the icon is placed in is taken to be the button rect after subtracting margins and borderWidth all the way round.

See Also: icon Property, margins Property, borderWidth Property

Advertisement