Texto e imagem
Rota de acesso ao Fundo
Define o caminho da imagem que será desenhada no fundo do objeto. 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
Nome | Tipo de dados | Valores possíveis |
---|---|---|
customBackgroundPicture | string | Caminho relativo na sintaxe POSIX. Deve ser utilizado em conjunto com a opção "Personalizado" da propriedade "Style". |
Objectos suportados
Custom Button - Custom Check Box - Custom Radio Button
Estilo de botão
Aspeto geral do botão. O estilo do botão também desempenha um papel na disponibilidade de determinadas opções.
Gramática JSON
Nome | Tipo de dados | Valores possíveis |
---|---|---|
style | text | "regular", "flat", "toolbar", "bevel", "roundedBevel", "gradientBevel", "texturedBevel", "office", "help", "circular", "disclosure", "roundedDisclosure", "custom" |
Objectos suportados
Button - Radio Button - Check Box - Radio Button
Margem horizontal
Esta propriedade permite definir o tamanho (em píxeis) das margens horizontais do botão. Esta margem delimita a área que o ícone e o título do botão não devem ultrapassar.
Este parâmetro é útil, por exemplo, quando a imagem de fundo contém contornos:
Com / Sem | Exemplo |
---|---|
Sem margem | |
Com margem de 13 píxeis |
This property works in conjunction with the Vertical Margin property.
Gramática JSON
Nome | Tipo de dados | Valores possíveis |
---|---|---|
customBorderX | number | Para utilizar com o estilo "personalizado". Mínimo: 0 |
Objectos suportados
Custom Button - Custom Check Box - Custom Radio Button
Localização do ícone
Designa a colocação de um ícone em relação ao objeto formulário.
Gramática JSON
Nome | Tipo de dados | Valores possíveis |
---|---|---|
iconPlacement | string | "none", "left", "right" |
Objectos suportados
Offset do ícone
Define um valor de desvio personalizado em pixeis, que será utilizado quando se clica no botão
O título do botão será deslocado para a direita e para baixo em função do número de pixeis introduzidos. Isto permite aplicar um efeito 3D personalizado quando o botão é clicado.
Gramática JSON
Nome | Tipo de dados | Valores possíveis |
---|---|---|
customOffset | number | mínimo: 0 |
Objectos suportados
Custom Button - Custom Check Box - Custom Radio Button
Número de estados
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.
A imagem pode conter de 2 a 6 estados.
- 2 estados: false, true
- 3 estados: false, true, rollover,
- 4 estados: false, true, rollover, desativado,
- 5 estados (apenas para caixas de verificação e botões rádio): false, true, false rollover, true rollover, desativado
- 6 estados (apenas para caixas de verificação e botões rádio): false, true, false rollover, true rollover, false desativado, true disable.
- button not clicked / check box unchecked (variable value=0)
- button clicked / check box checked (variable value=1)
Cada estado é representado por uma imagem diferente. Na imagem de origem, os estados devem ser empilhados verticalmente:
Gramática JSON
Nome | Tipo de dados | Valores possíveis |
---|---|---|
iconFrames | number | Número de estados na imagem do ícone. Mínimo: 1 |
Objectos suportados
Button (all styles except Help) - Check Box - Radio Button
Caminho da imagem
Define o caminho da imagem que será utilizada como ícone para o objeto.
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
Nome | Tipo de dados | Valores possíveis |
---|---|---|
icon | picture | Caminho relativo ou filesystem na sintaxe POSIX. |
Objectos suportados
Button (all styles except Help) - Check Box - List Box Header - Radio Button
Posição título/Imagem
Esta propriedade permite modificar a localização relativa do título do botão em relação ao ícone associado. Esta propriedade não tem efeito quando o botão contém apenas um título (sem imagem associada) ou uma imagem (sem título). Por predefinição, quando um botão contém um título e uma imagem, o texto é colocado por baixo da imagem.
Aqui estão os resultados utilizando as várias opções para esta propriedade:
Opção | Descrição | Exemplo |
---|---|---|
Left | O texto é colocado à esquerda do ícone. O conteúdo do botão é alinhado à direita. | |
Top | O texto é colocado por cima do ícone. O conteúdo do botão é centrado. | |
Right | O texto é colocado à direita do ícone. O conteúdo do botão é alinhado à esquerda. | |
Bottom | O texto é colocado por baixo do ícone. O conteúdo do botão é centrado. | |
Centered | O texto do ícone é centrado vertical e horizontalmente no botão. Este parâmetro é útil, por exemplo, para o texto incluído num ícone. |
Gramática JSON
Nome | Tipo de dados | Valores possíveis |
---|---|---|
textPlacement | string | "left", "top", "right", "bottom", "center" |
Objectos suportados
Button (all styles except Help) - Check Box - Radio Button
Image hugs title
This property allows you to define whether the title and the picture of the button should be visually adjoined or separated, according to the Title/Picture position and Horizontal Alignment properties.
Esta propriedade não tem efeito quando o botão contém apenas um título (sem imagem associada) ou uma imagem (sem título).
By default, when a button contains a title and a picture, the elements are joined. The following graphic shows the effect of the imageHugsTitle
property (true when property is enabled) with different button alignments:
Gramática JSON
Nome | Tipo de dados | Valores possíveis |
---|---|---|
imageHugsTitle | boolean | true (padrão), false |
Objectos suportados
Button (all styles except Help) - Check Box (all styles except Regular, Flat, Disclosure and Collapse/Expand) - Radio Button (all styles except Regular, Flat, Disclosure and Collapse/Expand).
Margem vertical
This property allows setting the size (in pixels) of the vertical margins of the button. Esta margem delimita a área que o ícone e o título do botão não devem ultrapassar.
Este parâmetro é útil, por exemplo, quando a imagem de fundo contém contornos.
This property works in conjunction with the Horizontal Margin property.
Gramática JSON
Nome | Tipo de dados | Valores possíveis |
---|---|---|
customBorderY | number | Para utilizar com o estilo "personalizado". Mínimo: 0 |
Objectos suportados
Custom Button - Custom Check Box - Custom Radio Button
Com menu pop-up
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:
Linked | Separado |
---|---|
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.
Refer to the On Alternative Click
event description for more information on the handling of events in this case.
Gerir o menu pop-up
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
Nome | Tipo de dados | Valores possíveis |
---|---|---|
popupPlacement | string |
Objectos suportados
Toolbar Button - Bevel Button - Rounded Bevel Button - OS X Gradient Button - OS X Textured Button - Office XP Button - Circle Button - Custom