Partilhar via


Tabela Control

A tabela Control define os controles exibidos em cada caixa de diálogo.

Ela tem as colunas a seguir.

Coluna Tipo Chave Nullable
Dialog_ Identificador S N
Control Identificador S N
Type Identificador N N
X Inteiro N N
S Inteiro N N
Largura Inteiro N N
Altura Inteiro N N
Atributos DoubleInteger N S
Propriedade Identificador N S
Texto Formatted N S
Control_Next Identificador N S
Ajuda Texto N S

 

Colunas

Dialog_

Chave externa para a primeira coluna da tabela Dialog, o nome da caixa de diálogo.

Control

Nome do controle. Esse nome precisa ser exclusivo em uma caixa de diálogo, mas pode ser repetido em caixas de diálogo diferentes. A coluna Control combinada com a coluna Dialog_ forma a chave primária dessa tabela.

Type

O tipo do controle. Para ver a lista de tipos de controles, confira Controles.

X

Coordenada horizontal do canto superior esquerdo do limite retangular do controle. Precisa ser um número não negativo. Confira Atributo de controle Position.

Y

Coordenada vertical do canto superior esquerdo do limite retangular do controle. Precisa ser um número não negativo. Confira Atributo de controle Position.

Width

Largura do limite retangular do controle. Precisa ser um número não negativo. Confira Atributo de controle Position.

Height

Altura do limite retangular do controle. Precisa ser um número não negativo. Confira Atributo de controle Position.

Attributes

Uma palavra de 32 bits que especifica os sinalizadores de bit a serem aplicados a esse controle. Precisa ser um número não negativo, e os valores permitidos dependem do tipo de controle. Para ver a lista de todos os atributos de controle e o valor a ser inserido nesse campo, confira Atributos de controle.

Property

O nome de uma propriedade definida a ser vinculada a esse controle. Os valores de botão de opção, caixa de listagem e caixa de combinação são vinculados a um grupo por estarem vinculados à mesma propriedade. Essa coluna é obrigatória para controles ativos.

Text

Uma cadeia de caracteres localizável usada para definir o texto inicial contido em um controle. A cadeia de caracteres também pode conter propriedades inseridas. Para ver a sintaxe de uma cadeia de caracteres formatada que contém propriedades, confira a função MsiFormatRecord. Especifique o tamanho, a fonte e a cor do texto colocando a cadeia de texto após {\style}, sendo que style é um estilo de texto criado na coluna TextStyle da tabela TextStyle. A cadeia de texto será truncada se for muito longa para se ajustar ao controle. Essa cadeia de texto poderá ficar em branco.

A criação especial da cadeia de texto Formatted nesse campo será obrigatória se o texto for exibido por um controle Text localizado em uma caixa de diálogo com o atributo TrackDiskpace. Esse é o caso especificado pelo Bit de Estilo da Caixa de Diálogo TrackDiskSpace exibido nos atributos da tabela Dialog. Nesse caso, se a cadeia de caracteres Formatted na coluna Text da tabela Control começar com "[" e terminar com "]", você precisará adicionar um espaço no final da cadeia de caracteres. Por exemplo, se DlgTextFont for uma propriedade que será definida como "{\DlgFontBold}", a cadeia de caracteres formatada "[DlgTextFont]MyText[ProductName] " exigirá o espaço no final após o colchete de fechamento. Esse espaço extra é exigido pelo instalador para exibir corretamente o texto no controle Text.

Você pode inserir uma cadeia de texto descritiva curta para os controles VolumeCostList, ListView, DirectoryList e SelectionTree. Esse texto não é visto pelo usuário, mas pode ser lido por leitores de tela como a descrição do controle.

Confira também Acessibilidade.

Control_Next

O nome de outro controle na mesma caixa de diálogo e uma chave externa para a segunda coluna da tabela Control. Se o foco na caixa de diálogo estiver no controle na coluna Control, o pressionamento da tecla Tab moverá o foco para o controle listado na coluna Control_Next. Portanto, essa coluna é usada para especificar a ordem de tabulação dos controles na caixa de diálogo. Os vínculos entre os controles precisam formar um ciclo fechado. Alguns controles, como controles de texto estático, podem ser deixados de fora do ciclo. Nesse caso, esse campo pode ser deixado em branco.

Confira também Acessibilidade.

Help

Cadeias de texto opcionais e localizáveis que são usadas com o botão Ajuda. A cadeia de caracteres é dividida em duas partes por um caractere separador (|). A primeira parte da cadeia de caracteres é usada como um texto ToolTip. Esse texto é usado por leitores de tela para controles que contêm uma imagem. A segunda parte da cadeia de caracteres é reservada para uso futuro. O caractere separador é obrigatório mesmo que apenas um dos dois tipos de texto esteja presente.

Comentários

Os valores inteiros para x, y, largura e altura estão nas unidades do instalador, não nas unidades da caixa de diálogo. Uma unidade do instalador é igual a um décimo segundo da altura do tamanho da fonte MS Sans Serif de 10 pontos. As coordenadas dos controles são relativas ao cartaz.

Validação

ICE03
ICE06
ICE17
ICE20
ICE23
ICE31
ICE32
ICE34
ICE45
ICE46
ICE95