Botão imagem

Um botão de imagem é semelhante a um botão padrão. However unlike a standard button (which accepts three states: enabled, disabled and clicked), a picture button has a different image to represent each state.

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. Suppose you want to give the users of a custom application the opportunity to choose the interface language for the application. You implement the option as a picture button in a custom properties dialog box:

Clicar no objeto altera a imagem.

Usar os botões imagem

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

1. First, prepare a single graphic in which the series of images are arranged in a row, a column, or a row-by-column grid.

   

You can organize pictures as columns, rows, or a row-by-column grid (as shown above). When organizing pictures as a grid, they are numbered from left to right, row by row, beginning with 0. For example, the second picture of the second row of a grid that consists of two rows and three columns, is numbered 4 (The UK flag in the example above).

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

In addition to the standard positioning and appearance settings, you can set some specific properties for picture buttons, especially concerning how and when the pictures are displayed. 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. When the user reaches the last picture in the series, the picture does not change when the user clicks again. Por outras palavras, não regressa à primeira imagem da série.

Estão disponíveis os seguintes outros modos:

• Loop back to first frame
• Volte quando lançado
• [Alterne quando Roll Over] (properties_Animation.md#switch-when-roll-over)
• Alterne continuamente nos cliques
• Usar Último Frame como Desativado
• [Use Last frame as disabled] (properties_Animation.md#use-last-frame-as-disabled)

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