Parâmetros de controle comuns

A seguir, descreve a sintaxe geral de 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 [,  . . . ]]}]

de 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 e convertidas em Unicode no arquivo de recurso resultante.

Por padrão, os caracteres listados entre aspas duplas são caracteres ANSI e 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 a aspa dupla 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 escarpas (&&).

id

Identificador de 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 janela.

de estilo estendido

Estilos de janela estendidos. Você deve especificar estilo para especificar de 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. 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.

Observações

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.