Compartilhar via


Tabela de Controle

A tabela Controle define os controles que aparecem em cada caixa de diálogo.

A tabela Controle tem as colunas a seguir.

Coluna Tipo Chave Nullable
Diálogo_ identificador de Y N
Controle identificador de Y N
Tipo identificador de N N
X inteiro N N
Y inteiro N N
Largura inteiro N N
Altura inteiro N N
Atributos DoubleInteger N Y
Propriedade identificador de N Y
Texto Formatado N Y
Control_Next identificador de N Y
Ajuda de Texto N Y

 

Colunas

Dialog_

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

Controle de

Nome do controle. Esse nome deve 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 para esta tabela.

Tipo de

O tipo do controle. Para obter uma lista de tipos de controle, consulte Controls.

X

Coordenada horizontal do canto superior esquerdo do limite retangular do controle. Deve ser um número não negativo. Consulte atributo de controle de posição.

Y

Coordenada vertical do canto superior esquerdo do limite retangular do controle. Deve ser um número não negativo. Consulte atributo de controle de posição.

Largura do

Largura do limite retangular do controle. Deve ser um número não negativo. Consulte atributo de controle de posição.

Altura do

Altura do limite retangular do controle. Deve ser um número não negativo. Consulte atributo de controle de posição.

Atributos de

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

Propriedade

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

Texto

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 obter a sintaxe de uma cadeia de caracteres formatada que contém propriedades, consulte a função MsiFormatRecord. Especifique o tamanho, a fonte e a cor do texto prefixando a cadeia de texto com {\style}, onde o estilo é um estilo de texto criado na coluna TextStyle da tabela TextStyle. A cadeia de caracteres de texto será truncada se for muito longa para caber no controle. A cadeia de caracteres de texto pode estar em branco.

A criação especial da cadeia de caracteres de texto formatada nesse campo será necessária se o texto for exibido por um de Controle de Texto localizado em uma caixa de diálogo com o atributo TrackDiskpace. Esse é o caso especificado pelo de bits de estilo de caixa de diálogo TrackDiskSpace que aparecem nos atributos da tabela de diálogo . Nesse caso, se a cadeia de caracteres Formatada na coluna Texto da tabela Controle começar com "[" e terminar com "]", você deverá 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 Texto.

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

Consulte também de 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 Controle, atingir a tecla tab move 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 links entre os controles devem formar um ciclo fechado. Alguns controles, como controles de texto estáticos, podem ser deixados de fora do ciclo. Nesse caso, esse campo pode ficar em branco.

Consulte também de Acessibilidade.

Ajuda do

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 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 é necessário mesmo que apenas um dos dois tipos de texto esteja presente.

Observações

Os valores inteiros para x, y, largura e altura estão nas unidades do instalador , não em unidades 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 outdoor.

Validação

ICE03
ICE06
ICE17
ICE20
ICE23
ICE31
ICE32
ICE34
ICE45
ICE46
ICE95