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.