Skip to main content
Version: v19 R8 BETA

Text and Picture

Rota de acesso ao Fundo

Sets the path of the picture that will be drawn in the background of the object. If the object uses an icon with different states, the background picture will automatically support the same number of states.

The pathname to enter is similar as for the Pathname property for static pictures.

Gramática JSON

NomeTipo de dadosValores possíveis
customBackgroundPicturestringRelative path in POSIX syntax. Must be used in conjunction with the style property with the "custom" option.

Objectos suportados

Custom Button - Custom Check Box - Custom Radio Button


Button Style

General appearance of the button. The button style also plays a part in the availability of certain options.

Gramática JSON

NomeTipo de dadosValores possíveis
styletext"regular", "flat", "toolbar", "bevel", "roundedBevel", "gradientBevel", "texturedBevel", "office", "help", "circular", "disclosure", "roundedDisclosure", "custom"

Objectos suportados

Button - Radio Button - Check Box - Radio Button


Horizontal Margin

This property allows setting the size (in pixels) of the horizontal margins of the button. This margin delimits the area that the button icon and title must not surpass.

This parameter is useful, for example, when the background picture contains borders:

Com / SemExemplo
Without margin
With 13-pixel margin

This property works in conjunction with the Vertical Margin property.

Gramática JSON

NomeTipo de dadosValores possíveis
customBorderXnumberFor use with "custom" style. Mínimo: 0

Objectos suportados

Custom Button - Custom Check Box - Custom Radio Button


Icon Location

Designates the placement of an icon in relation to the form object.

Gramática JSON

NomeTipo de dadosValores possíveis
iconPlacementstring"none", "left", "right"

Objectos suportados

List Box Header


Offset do ícone

Sets a custom offset value in pixels, which will be used when the button is clicked

The title of the button will be shifted to the right and toward the bottom for the number of pixels entered. This allows applying a customized 3D effect when the button is clicked.

Gramática JSON

NomeTipo de dadosValores possíveis
customOffsetnumbermínimo: 0

Objectos suportados

Custom Button - Custom Check Box - Custom Radio Button


Number of States

This property sets the exact number of states present in the picture used as the icon for a button with icon, a check box or a custom radio button. In general, a button icon includes four states: active, clicked, mouse over and inactive.

Each state is represented by a different picture. In the source picture, the states must be stacked vertically:

The following states are represented:

  1. button not clicked / check box unchecked (variable value=0)
  2. button clicked / check box checked (variable value=1)
  3. roll over
  4. disabled

Gramática JSON

NomeTipo de dadosValores possíveis
iconFramesnumbermínimo: 1

Objectos suportados

Button (all styles except Help) - Check Box - Radio Button


Picture pathname

Sets the path of the picture that will be used as icon for the object.

The pathname to enter is similar as for the Pathname property for static pictures.

When used as icon for active objects, the picture must be designed to support a variable number of states.

Gramática JSON

NomeTipo de dadosValores possíveis
iconpictureRelative or filesystem path in POSIX syntax.

Objectos suportados

Button (all styles except Help) - Check Box - List Box Header - Radio Button


Title/Picture Position

This property allows modifying the relative location of the button title in relation to the associated icon. This property has no effect when the button contains only a title (no associated picture) or a picture (no title). By default, when a button contains a title and a picture, the text is placed below the picture.

Here are the results using the various options for this property:

OptionDescriçãoExemplo
EsquerdaThe text is placed to the left of the icon. The contents of the button are aligned to the right.
TopoThe text is placed above the icon. The contents of the button are centered.
DireitaThe text is placed to the right of the icon. The contents of the button are aligned to the left.
FundoThe text is placed below the icon. The contents of the button are centered.
CentradoThe text of the icon is centered vertically and horizontally in the button. This parameter is useful, for example, for text included in an icon.

Gramática JSON

NomeTipo de dadosValores possíveis
textPlacementstring"left", "top", "right", "bottom", "center"

Objectos suportados

Button (all styles except Help) - Check Box - Radio Button


Vertical Margin

This property allows setting the size (in pixels) of the vertical margins of the button. This margin delimits the area that the button icon and title must not surpass.

This parameter is useful, for example, when the background picture contains borders.

This property works in conjunction with the Horizontal Margin property.

Gramática JSON

NomeTipo de dadosValores possíveis
customBorderYnumberFor use with "custom" style. Mínimo: 0

Objectos suportados

Custom Button - Custom Check Box - Custom Radio Button


With pop-up menu

This property allows displaying a symbol that appears as a triangle in the button to indicate the presence of an attached pop-up menu:

The appearance and location of this symbol depends on the button style and the current platform.

Ligados e Separados

To attach a pop-up menu symbol to a button, there are two display options available:

LinkedSeparado

The actual availability of a "separated" mode depends on the style of the button and the platform.

Each option specifies the relation between the button and the attached pop-up menu:

  • When the pop-up menu is separated, clicking on the left part of the button directly executes the current action of the button; this action can be modified using the pop-up menu accessible in the right part of the button.
  • When the pop-up menu is linked, a simple click on the button only displays the pop-up menu. Only the selection of the action in the pop-up menu causes its execution.
info

Refer to the On Alternative Click event description for more information on the handling of events in this case.

Managing the pop-up menu

It is important to note that the "With Pop-up Menu" property only manages the graphic aspect of the button. The display of the pop-up menu and its values must be handled entirely by the developer, more particularly using form events and the Dynamic pop up menu and Pop up menu commands.

Gramática JSON

NomeTipo de dadosValores possíveis
popupPlacementstring
  • "none"
  • "linked"
  • "separated"
  • Objectos suportados

    Toolbar Button - Bevel Button - Rounded Bevel Button - OS X Gradient Button - OS X Textured Button - Office XP Button - Circle Button - Custom