Controles (Windows Installer)

Os desenvolvedores de pacotes de instalação podem criar uma interface do usuário que contém os controles discutidos neste tópico. Para obter informações sobre como adicionar um controle específico a uma caixa de diálogo, confira o tópico desse controle e leia a seção Como adicionar controles e texto.

Alguns controles, como CheckBox e ComboBox, estão associados a uma propriedade especificada na coluna Property da tabela Control. Um usuário altera o valor dessa propriedade interagindo com o controle. Os controles passivos, como Billboard e bitmap, não estão associados a essa propriedade.

Por segurança, as propriedades privadas não podem ser alteradas por um usuário que interage com a interface do usuário. Para que uma propriedade seja definida pela interface do usuário, ela precisa ser uma propriedade pública e em maiúsculas. Confira também Sobre as propriedades.

Em alguns casos, um controle pode ser redesenhado incorretamente ao cancelar uma caixa de diálogo. Isso tem a ver com a ordem em que os controles recebem mensagens WM_PAINT depois que a caixa de diálogo Cancelar é removida. Para corrigir isso, tente alterar a ordem dos controles na tabela Controle.

Nome do controle	Propriedade associada	Breve descrição de controle
Billboard	Não	Exibe outdoors com base em mensagens de progresso.
Bitmap	Não	Exibe uma imagem estática de um bitmap.
CheckBox	Sim	Uma caixa de seleção de dois estados.
ComboBox	Sim	Uma lista suspensa com um campo de edição.
DirectoryCombo	Sim	Seleciona todos, exceto o último segmento do caminho.
DirectoryList	Sim	Exibe as pastas abaixo da parte principal do caminho.
Editar	Sim	Um campo de edição regular para qualquer cadeia de caracteres ou inteiro.
GroupBox	Não	Exibe um retângulo que agrupa outros controles.
Hiperlink	Não	Exibe um link HTML para um endereço, que é aberto no navegador padrão. Windows Installer 4.5 e versões anteriores: sem suporte.
Ícone	Não	Exibe uma imagem estática de um ícone.
Linha	Não	Exibe uma linha horizontal.
ListBox	Sim	Uma lista suspensa sem um campo de edição.
ListView	Sim	Exibe uma coluna de valores com ícones para seleção.
MaskedEdit	Sim	Um campo de edição com uma máscara no campo de texto.
PathEdit	Sim	Exibe o nome da pasta ou o caminho inteiro em um campo de edição.
Controle ProgressBar	Não	Gráfico de barras que altera o comprimento, à medida que recebe mensagens de progresso.
PushButton	Não	Exibe um botão de ação básico.
RadioButtonGroup	Sim	Um grupo de botões de opção.
ScrollableText	Não	Exibe uma longa cadeia de caracteres de texto.
SelectionTree	Sim	Exibe informações da tabela Feature e permite que o usuário altere o estado de seleção.
Texto	Não	Exibe o texto estático.
VolumeCostList	Não	Exibe as informações de custo em volumes diferentes.
VolumeSelectCombo	Sim	Seleciona o volume de uma lista alfabética.