Saltar para o conteúdo principal
Versão: 20 R5

Texto e imagem

Rota de acesso ao Fundo

Define o caminho da imagem que será desenhada no fundo do objeto. Si el objeto utiliza un icono con diferentes estados, la imagen de fondo soportará automáticamente el mismo número de estados.

El nombre de la ruta a introducir es similar al de la propiedad Ruta de acceso para las imágenes estáticas.

Gramática JSON

NomeTipo de dadosValores possíveis
customBackgroundPicturestringCaminho relativo na sintaxe POSIX. Deve ser utilizado em conjunto com a opção "Personalizado" da propriedade "Style".

Objectos suportados

Botón personalizado - Casilla de selección personalizada - Botón radio personalizado


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

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

Objectos suportados

Botón - Botón radio - Casilla de selección - Botón Radio


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 / SemExemplo
Sem margem
Com margem de 13 píxeis

Esta propiedad funciona junto con la propiedad Margen vertical.

Gramática JSON

NomeTipo de dadosValores possíveis
customBorderXnumberPara utilizar com o estilo "personalizado". Mínimo: 0

Objectos suportados

Botón personalizado - Casilla de selección personalizada - Botón radio personalizado


Localização do ícone

Designa a colocação de um ícone em relação ao objeto formulário.

Gramática JSON

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

Objectos suportados

List Box Header


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

NomeTipo de dadosValores possíveis
customOffsetnumbermínimo: 0

Objectos suportados

Botón personalizado - Casilla de selección personalizada - Botón radio personalizado


Número de estados

Esta propiedad define el número exacto de estados presentes en la imagen utilizada como icono para un botón con icono, una casilla de selección o un botón radio personalizado.

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.
nota
  • 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

NomeTipo de dadosValores possíveis
iconFramesnumberNúmero de estados na imagem do ícone. Mínimo: 1

Objectos suportados

Botón (todos los estilos excepto Ayuda) - Casilla de selección - Botón radio


Caminho da imagem

Define o caminho da imagem que será utilizada como ícone para o objeto.

El nombre de la ruta a introducir es similar al de la propiedad Ruta de acceso para las imágenes estáticas.

Cuando se utiliza como icono de objetos activos, la imagen debe estar diseñada para soportar un número de estados variable.

Gramática JSON

NomeTipo de dadosValores possíveis
iconpictureCaminho relativo ou filesystem na sintaxe POSIX.

Objectos suportados

Botón (todos los estilos excepto Ayuda) - Casilla de selección - Encabezado List Box - Botón radio


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çãoDescriçãoExemplo
**EsquerdaO texto é colocado à esquerda do ícone. O conteúdo do botão é alinhado à direita.
SuperiorO texto é colocado por cima do ícone. O conteúdo do botão é centrado.
DireitaO texto é colocado à direita do ícone. O conteúdo do botão é alinhado à esquerda.
FundoO texto é colocado por baixo do ícone. O conteúdo do botão é centrado.
CentradoO 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

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

Objectos suportados

Botón (todos los estilos excepto Ayuda) - Casilla de selección - Botón radio


Image hugs title

Esta propiedad permite definir si el título y la imagen del botón deben estar visualmente contiguos o separados, según las propiedades Posición del título/imagen y Alineación horizontal.

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. El siguiente gráfico muestra el efecto de la propiedad imageHugsTitle (true cuando la propiedad está activada) con diferentes alineaciones de los botones:

Gramática JSON

NomeTipo de dadosValores possíveis
imageHugsTitlebooleantrue (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.

Esta propiedad funciona junto con la propiedad Margen horizontal.

Gramática JSON

NomeTipo de dadosValores possíveis
customBorderYnumberPara utilizar com o estilo "personalizado". Mínimo: 0

Objectos suportados

Botón personalizado - Casilla de selección personalizada - Botón radio personalizado


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:

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.
  • Quando o menu pop-up está vinculado, um simples clique no botão exibe apenas o menu pop-up. 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.

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

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