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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de