Parâmetros de controle comuns

A seguir, descreve a sintaxe geral para uma instrução de definição de recurso de controle. O significado de cada parâmetro é dado abaixo. Ocasionalmente, uma instrução usará um parâmetro de forma diferente ou poderá ignorar um parâmetro. A variação específica da instrução é descrita na documentação da instrução .

control [[text,]] id, x, y, width, height[[, style[[, extended-style]]]][, helpId]
[{ data-element-1 [, data-element-2 [,  . . . ]]}]

Texto

Texto a ser exibido com o controle . O texto é posicionado dentro do controle ou adjacente ao controle .

Esse parâmetro deve conter zero ou mais caracteres entre aspas duplas ("). As cadeias de caracteres são terminadas automaticamente em nulo e convertidas em Unicode no arquivo de recurso resultante.

Por padrão, os caracteres listados entre aspas duplas são caracteres ANSI e as sequências de escape são interpretadas como sequências de escape de bytes. Se a cadeia de caracteres for precedida pelo prefixo "L", a cadeia de caracteres será uma cadeia de caracteres largos e as sequências de escape serão interpretadas como sequências de escape de 2 bytes que especificam caracteres Unicode. Se uma aspa dupla for necessária no texto, você deverá incluir as aspas duplas duas vezes.

Um caractere de e comercial (&) no texto indica que o caractere a seguir é usado como um caractere mnemônico para o controle. Quando o controle é exibido, o e comercial não é mostrado, mas o caractere mnemônico é sublinhado. O usuário pode escolher o controle pressionando a tecla correspondente ao caractere mnemônico sublinhado. Para usar o e comercial como um caractere em uma cadeia de caracteres, insira dois e comercials (&&).

Id

Identificador do controle. Esse valor deve ser um inteiro sem sinal de 16 bits no intervalo de 0 a 65.535 ou uma expressão aritmética simples que é avaliada como um valor nesse intervalo.

X

Coordenada X do lado esquerdo do controle em relação ao lado esquerdo da caixa de diálogo. Esse valor deve ser um inteiro sem sinal de 16 bits no intervalo de 0 a 65.535. A coordenada está em unidades de diálogo e é relativa à origem da caixa de diálogo, janela ou controle que contém o controle especificado.

Y

Coordenada Y do lado superior do controle em relação à parte superior da caixa de diálogo. Esse valor deve ser um inteiro sem sinal de 16 bits no intervalo de 0 a 65.535. A coordenada está em unidades de diálogo relativas à origem da caixa de diálogo, janela ou controle que contém o controle especificado.

Largura

Largura do controle. Esse valor deve ser um inteiro sem sinal de 16 bits no intervalo de 1 a 65.535. A largura está em unidades de 1/4 caracteres.

Altura

Altura do controle. Esse valor deve ser um inteiro sem sinal de 16 bits no intervalo de 1 a 65.535. A altura está em unidades de 1/8 caracteres.

Estilo

Estilos de controle. Use o operador OR bit a bit (|) para combinar estilos. Para obter mais informações, consulte Estilos de Janelas.

estilo estendido

Estilos de janela estendidos. Você deve especificar o estilo para especificar o estilo estendido. Para obter mais informações, consulte EXSTYLE.

helpId

Expressão numérica que indica a ID usada para identificar o controle durante WM_HELP processamento.

Controldata

Dados específicos do controle para o controle. Quando uma caixa de diálogo é criada e um controle nessa caixa de diálogo que tem dados específicos do controle é criado, um ponteiro para esses dados é passado para o procedimento de janela do controle por meio do lParam da mensagem WM_CREATE para esse controle.

Comentários

As unidades de diálogo horizontais são 1/4 da unidade de largura base da caixa de diálogo. As unidades verticais são 1/8 da unidade de altura base da caixa de diálogo. As unidades base da caixa de diálogo atual são computadas a partir da altura e largura da fonte atual do sistema. A função GetDialogBaseUnits retorna as unidades base da caixa de diálogo em pixels. As coordenadas são relativas à origem da caixa de diálogo.