Partilhar via


Controle PushButton

O controle PushButton exibe um botão de push básico, também conhecido como botão de comando.

Os controles PushButton não podem ser usados para publicar um IgnoreChange ControlEvent, SelectionDescription ControlEvent, SelectionSize ControlEvent, SelectionPath ControlEvent, SelectionPathOn ControlEvent, SelectionAction ControlEvent, SelectionNoItems ControlEvent, ActionText ControlEvent, ActionData ControlEvent, SetProgress ControlEvent, ou TimeRemaining ControlEvent.

É possível usar os atributos a seguir com esse controle. Para alterar o valor de um atributo usando um evento, assine o controle em um ControlEvent na tabela EventMapping e liste o identificador do atributo na coluna Attribute. Insira o identificador do ControlEvent na coluna Event.

Identificador de atributo Bit hexadecimal Descrição
Posição Posição do controle na caixa de diálogo. Insira a largura, a altura e as coordenadas do canto esquerdo do controle nas colunas Width, Height, X e Y da tabela Control. Use Unidades do instalador para definir o comprimento e a distância.
Texto Esse atributo de controle pode especificar o texto exibido pelo controle, uma imagem armazenada na tabela Binary ou um conjunto de imagens em tempo de execução. Para especificar o texto, insira a cadeia de caracteres de texto na coluna Text da tabela Control. Para definir a fonte e o estilo da fonte de uma cadeia de texto, acrescente à cadeia de caracteres exibidos o prefixo {\style} ou {&style}. Sendo que Style é um identificador listado na coluna TextStyle da tabela TextStyle. Caso nenhum deles esteja presente, mas a propriedade DefaultUIFont seja definida como um estilo de texto válido, essa fonte será usada.
Para especificar um ícone ou uma imagem de bitmap armazenada na tabela Binary, insira a chave primária do registro da imagem na coluna Name da tabela Binary na coluna Text do registro da tabela Control para o controle.
Visível 0x00000000 0x00000001
Controle oculto. Controle visível.
Inclua esse bit na palavra de bit da coluna Attributes na tabela Control para tornar o controle visível ou oculto após a criação.
Você também pode ocultar ou mostrar um controle usando a tabela ControlCondition.
Enabled 0x00000000 0x00000002
Controle em um estado desabilitado. Controle em um estado habilitado.
Inclua esse bit na palavra de bit na coluna Attributes da tabela Control para habilitar o controle na criação.
Você também pode habilitar ou desabilitar um controle usando a tabela ControlCondition.
Sunken 0x00000000 0x00000004
Exibe o estilo visual padrão. Exibe o controle com uma aparência 3D em baixo-relevo.
Inclua esses bits na palavra de bit da coluna Attributes da tabela Control.
RTLRO 0x00000000 0x00000020
O texto no controle é exibido na ordem de leitura da esquerda para a direita. O texto no controle é exibido na ordem de leitura da direita para a esquerda.
Bitmap 0x00000000 0x00040000
O texto no controle é especificado na coluna Text da tabela Control. O botão tem o estilo BS_BITMAP, o texto no controle é substituído por uma imagem de bitmap. A coluna Text na tabela Control é usada como uma chave estrangeira para a tabela Binary.
Inclua esse bit na palavra de bit da coluna Attributes de Control.
Não defina os bits de estilo Bitmap e Ícone simultaneamente. O botão não pode conter uma imagem de bitmap e um texto.
Para definir a fonte e o estilo da fonte de uma cadeia de texto, acrescente à cadeia de caracteres exibidos o prefixo {\style} ou {&style}. Sendo que Style é um identificador listado na coluna TextStyle da tabela TextStyle. Caso nenhum deles esteja presente, mas a propriedade DefaultUIFont seja definida como um estilo de texto válido, essa fonte será usada.
Controle de ícone 0x00000000 0x00080000
O texto no controle é especificado na coluna Text da tabela Control. O botão tem o estilo BS_ICON, o texto no controle é substituído por uma imagem de ícone. A coluna Text na tabela Control é usada como uma chave estrangeira para a tabela Binary.
Inclua esse bit na palavra de bit da coluna Attributes de Control.
Não defina os bits de Bitmap e Ícone simultaneamente. O botão não pode conter uma imagem de ícone e um texto.
Para definir a fonte e o estilo da fonte de uma cadeia de texto, acrescente à cadeia de caracteres exibidos o prefixo {\style} ou {&style}. Sendo que Style é um identificador listado na coluna TextStyle da tabela TextStyle. Caso nenhum deles esteja presente, mas a propriedade DefaultUIFont seja definida como um estilo de texto válido, essa fonte será usada.
FixedSize 0x00000000 0x00100000
Alongue a imagem do ícone para ajustar o controle. Corte ou centralize a imagem de ícone no controle.
Inclua esse bit na palavra de bit da coluna Attributes da tabela BBControl ou na tabela Control.
IconSize 0x00000000 0x00200000
0x00400000
0x00600000
Carrega a primeira imagem. Carrega a primeira imagem 16x16.
Carrega a primeira imagem 32x32.
Carrega a primeira imagem 48x48.
Um arquivo de ícone pode conter imagens de tamanho diferente do mesmo ícone. Incluir o valor da palavra de bit apropriada na coluna Attributes da tabela Control
Se esses bits não estiverem definidos, o instalador ignorará o atributo FixedSize e a imagem será ampliada para se ajustar ao retângulo de controle. Se os bits IconSize e FixedSize estiverem definidos, uma imagem menor do que o controle será centralizada e uma imagem será maior do que o controle que ela será reduzida para caber.
ElevationShield 0x00000000 0x00800000
A aparência de pushbutton é determinada pelos outros atributos de ícone. Adiciona o ícone de elevação (ícone de escudo) do UAC (Controle de Conta de Usuário) ao controle pushbutton.

 

Comentários

Esse controle pode ser criado a partir da classe BUTTON usando a função CreateWindowEx. Ele tem os estilos BS_MULTILINE, WS_CHILD, WS_TABSTOP e WS_GROUP.