Compartilhar 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, SelectionAde ControlEvent SelectionNoItems ControlEvent, ActionText ControlEvent, ActionData ControlEvent, SetProgress ControlEventou TimeRemaining ControlEvent.

Você pode 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 Evento.

Identificador de atributo Bit hexadecimal Descrição
de Posição Posição de controle na caixa de diálogo. Insira a largura, a altura e as coordenadas do controle do canto esquerdo do controle nas colunas Width, Height, X e Y da tabela controle . Use unidades do instalador para comprimento e distância.
de Texto Esse atributo de controle pode especificar o texto exibido pelo controle, uma imagem armazenada na tabela Binária ou um conjunto de imagens em tempo de execução. Para especificar o texto, insira a cadeia de caracteres de texto na coluna Texto da tabela Controle. Para definir a fonte e o estilo de fonte de uma cadeia de caracteres de texto, prefixe a cadeia de caracteres exibida com {\style} ou {&estilo}. Onde o estilo é um identificador listado na coluna TextStyle da tabela TextStyle. Se nenhum deles estiver presente, mas a propriedade DefaultUIFont for definida como um estilo de texto válido, essa fonte será usada.
Para especificar um ícone ou imagem de bitmap armazenado na tabela binária, insira a chave primária do registro da imagem da coluna Name da tabela Binária na coluna Texto do registro da tabela Control para o controle.
Visíveis 0x00000000 0x00000001
Controle oculto. Controle visível.
Inclua esse bit na palavra bit da coluna Atributos na tabela controle para tornar o controle visível ou oculto após sua criação.
Você também pode ocultar ou mostrar um controle usando a tabela ControlCondition.
habilitado 0x00000000 0x00000002
Controlar em um estado desabilitado. Controlar em um estado habilitado.
Inclua esse bit na coluna Atributos do controle para habilitar o controle na criação.
Você também pode habilitar ou desabilitar um controle usando a tabela ControlCondition.
submersa 0x00000000 0x00000004
Exibe o estilo visual padrão. Exibe o controle com uma aparência submersa, 3D.
Inclua esses bits na palavra bit na coluna Atributos da tabela controle .
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 Texto da tabela controle . O botão tem o estilo BS_BITMAP, o texto no controle é substituído por uma imagem bitmap. A coluna Texto na tabela Controle é usada como uma chave estrangeira para a tabela binária .
Inclua esse bit na palavra bit na coluna Atributos do controle .
Não defina os bits de estilo Ícone e Bitmap simultaneamente. O botão não pode conter uma imagem bitmap e um texto.
Para definir a fonte e o estilo de fonte de uma cadeia de caracteres de texto, prefixe a cadeia de caracteres exibida com {\style} ou {&estilo}. Onde o estilo é um identificador listado na coluna TextStyle da tabela TextStyle. Se nenhum deles estiver presente, mas a propriedade DefaultUIFont for definida como um estilo de texto válido, essa fonte será usada.
de controle de ícone 0x00000000 0x00080000
O texto no controle é especificado na coluna Texto da tabela controle . O botão tem o estilo BS_ICON, o texto no controle é substituído por uma imagem de ícone. A coluna Texto na tabela Controle é usada como uma chave estrangeira para a tabela binária .
Inclua esse bit na palavra bit na coluna Atributos do controle .
Não defina os bits Ícone e Bitmap simultaneamente. O botão não pode conter uma imagem de ícone e um texto.
Para definir a fonte e o estilo de fonte de uma cadeia de caracteres de texto, prefixe a cadeia de caracteres exibida com {\style} ou {&estilo}. Onde o estilo é um identificador listado na coluna TextStyle da tabela TextStyle. Se nenhum deles estiver presente, mas a propriedade DefaultUIFont for definida como um estilo de texto válido, essa fonte será usada.
FixedSize 0x00000000 0x00100000
Estique a imagem do ícone para ajustar o controle. Corte ou centralize a imagem do ícone no controle.
Inclua esse bit na palavra bit da coluna Atributos do da tabela BBControl ou na tabela controle .
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. Inclua o valor da palavra de bit apropriada na coluna Atributos da tabela controle
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 os bits FixedSize forem definidos, uma imagem menor que o controle será centralizada e uma imagem será maior do que o controle que ela será reduzida para ajustar.
do ElevationShield 0x00000000 0x00800000
A aparência do pushbutton é determinada pelos outros atributos de ícone. Adiciona o ícone de elevaçãode controle de conta de usuário (UAC)(ícone de escudo) ao controle pushbutton.

 

Observações

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