Parâmetros de controlo comuns

A seguir descrevemos 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 declaração.

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

texto

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

Este parâmetro deve conter zero ou mais caracteres entre aspas duplas ("). As cadeias de caracteres são automaticamente terminadas 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 byte. 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 for necessária uma aspa dupla no texto, você deve incluir as aspas duplas duas vezes.

Um caractere 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 comerciais (&&).

ID

Identificador de controlo. Esse valor deve ser um inteiro não assinado de 16 bits no intervalo de 0 a 65.535 ou uma expressão aritmética simples que avalia 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 não assinado 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 não assinado 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 não assinado de 16 bits no intervalo de 1 a 65.535. A largura está em unidades de 1/4 de caracteres.

altura

Altura do comando. Esse valor deve ser um inteiro não assinado de 16 bits no intervalo de 1 a 65.535. A altura é em unidades de 1/8 caracteres.

estilo

Estilos de controle. Use o operador bit a bit OR (|) 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 o ID usado 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 através 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 da base da caixa de diálogo. As unidades verticais são 1/8 da unidade de altura da base de diálogo. As unidades de base de diálogo atuais são calculadas a partir da altura e largura da fonte do sistema atual. A funçãoGetDialogBaseUnits retorna as unidades base de diálogo em pixels. As coordenadas são relativas à origem da caixa de diálogo.