Botão imagem

Um botão de imagem é semelhante a um botão padrão. Entretanto, diferentemente de um botão padrão (que aceita três estados: ativado, desativado e clicado), um botão imagem tem uma imagem diferente para representar cada estado.

Os botões imagem podem ser utilizados de duas formas:

• Como botões de comando num formulário. In this case, the picture button generally includes four different states: enabled, disabled, clicked and rolled over.
  For example, a table of thumbnails that has one row of four columns, each thumbnail corresponds to the Default, Clicked, Roll over, and Disabled states.

  Propriedade	Nome JSON	Valor
  Linhas	rowCount	1
  Colunas	columnCount	4
  Switch back when Released	switchBackWhenReleased	true
  Switch when Roll Over	switchWhenRollover	true
  Use Last Frame as Disabled	useLastFrameAsDisabled	true

• Como botão de imagem que permite ao usuário escolher entre várias opções. Neste caso, pode ser utilizado um botão de imagem em vez de um menu pop-up de imagem. Com Menu pop-up de imagem, todas as escolhas são exibidas simultaneamente (como os itens no menu pop-up), enquanto o botão imagem mostra as opções consecutivas (como o usuário clica no botão).
  Aqui está um exemplo de um botão imagem. Suponha que você deseja dar aos usuários de um aplicativo personalizado a oportunidade de escolher o idioma da interface da aplicação. Você implementa a opção como um botão imagem em uma caixa de diálogo de propriedades personalizadas:

Clicar no objeto altera a imagem.

Usar os botões imagem

É possível implementar um botão imagem da seguinte forma:

1. Primeiro, prepare um único gráfico onde a série de imagens esteja organizada em uma linha, uma coluna ou uma grade de linha por coluna.

   

Você pode organizar as imagens em colunas, linhas ou em uma grade de linha por coluna (como mostrado acima). Ao organizar as imagens em uma grade, elas são numeradas da esquerda para a direita, linha por linha, começando com 0. Por exemplo, a segunda imagem da segunda linha de uma grade que consiste em duas linhas e três colunas é numerada como 4 (a bandeira do Reino Unido no exemplo acima).

2. Em seguida, certifique-se de que a imagem esteja nos Recursos do seu projeto e insira o caminho na propriedade Pathname.

3. Defina as propriedades [Rows and Columns] (properties_Crop.md) do gráfico.

4. Especifique quando as imagens mudam selecionando as propriedades animation apropriadas.

Animação

Além do posicionamento padrão e configurações de aparência, você pode definir algumas propriedades específicas para botões de imagem, especialmente no que diz respeito a como e quando as imagens são exibidas. Estas opções de propriedade podem ser combinadas para melhorar seus botões de imagem.

• Por padrão (quando nenhuma [opção de animação] (properties_Animation.md) está selecionada), um botão de imagem exibe a próxima imagem da série quando o usuário clica; ele exibe a imagem anterior da série quando o usuário mantém pressionada a tecla Shift e clica. Quando o usuário chega à última imagem da série, a imagem não muda quando o usuário clica novamente. Por outras palavras, não regressa à primeira imagem da série.

Estão disponíveis os seguintes outros modos:

• Loop de volta ao primeiro quadro
• Volte quando lançado
• [Alterne quando Roll Over] (properties_Animation.md#switch-when-roll-over)
• Alterne continuamente nos cliques
• [Use Last frame as disabled] (properties_Animation.md#use-last-frame-as-disabled)
• Switch every x ticks

A variável associada do botão de imagem retorna o número de índice, na tabela de miniaturas, da imagem atual exibida. A numeração das imagens no quadro começa com 0.

Propriedades compatíveis

Bold - Border Line Style - Bottom - Button Style - Class - Columns - Focusable - Font - Font Color - Height - Help Tip - Horizontal Sizing - Italic - Left - Loop back to first frame - Object Name - Pathname - Right - Rows - Shortcut - Standard action - Switch back when released - Switch continuously on clicks - Switch every x ticks - Title - Switch when roll over - Top - Type - Use Last frame as disabled - Variable or Expression - Vertical Sizing - Visibility - Width