Parámetros de control comunes

A continuación se describe la sintaxis general de una instrucción de definición de recursos de control. A continuación se indica el significado de cada parámetro. En ocasiones, una instrucción usará un parámetro de forma diferente o puede omitir un parámetro. La variación específica de la instrucción se describe en la documentación de la instrucción .

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

de texto

Texto que se va a mostrar con el control . El texto se coloca dentro del control o adyacente al control.

Este parámetro debe contener cero o más caracteres entre comillas dobles ("). Las cadenas terminan automáticamente en null y se convierten en Unicode en el archivo de recursos resultante.

De forma predeterminada, los caracteres enumerados entre las comillas dobles son caracteres ANSI y las secuencias de escape se interpretan como secuencias de escape de bytes. Si la cadena está precedida por el prefijo "L", la cadena es una cadena de caracteres anchos y las secuencias de escape se interpretan como secuencias de escape de 2 bytes que especifican caracteres Unicode. Si se requiere una comilla doble en el texto, debe incluir la comilla doble dos veces.

Un carácter ampersand (&) en el texto indica que el siguiente carácter se usa como carácter mnemónico para el control. Cuando se muestra el control, no se muestra la y comercial, pero el carácter mnemónico está subrayado. El usuario puede elegir el control presionando la tecla correspondiente al carácter mnemónico subrayado. Para usar la y comercial como carácter en una cadena, inserte dos ampersands (&&).

de identificador de

Identificador de control. Este valor debe ser un entero sin signo de 16 bits en el intervalo de 0 a 65 535 o una expresión aritmética simple que se evalúa como un valor de ese intervalo.

x

Coordenada X del lado izquierdo del control en relación con el lado izquierdo del cuadro de diálogo. Este valor debe ser un entero de 16 bits sin signo en el intervalo de 0 a 65 535. La coordenada está en unidades de diálogo y es relativa al origen del cuadro de diálogo, ventana o control que contiene el control especificado.

y

Coordenada Y del lado superior del control en relación con la parte superior del cuadro de diálogo. Este valor debe ser un entero de 16 bits sin signo en el intervalo de 0 a 65 535. La coordenada está en unidades de diálogo relativas al origen del cuadro de diálogo, ventana o control que contiene el control especificado.

ancho

Ancho del control. Este valor debe ser un entero sin signo de 16 bits en el intervalo de 1 a 65 535. El ancho está en unidades de 1/4 caracteres.

alto

Alto del control. Este valor debe ser un entero sin signo de 16 bits en el intervalo de 1 a 65 535. El alto está en unidades de 1/8 caracteres.

de estilo

Estilos de control. Use el operador OR bit a bit (|) para combinar estilos. Para obtener más información, vea Estilos de ventana.

de estilo extendido

Estilos de ventana extendidos. Debe especificar estilo para especificar de estilo extendido . Para obtener más información, vea EXSTYLE.

helpId

Expresión numérica que indica el identificador usado para identificar el control durante WM_HELP procesamiento.

controlData

Datos específicos del control para el control. Cuando se crea un cuadro de diálogo y se crea un control en ese cuadro de diálogo que tiene datos específicos del control, se pasa un puntero a esos datos al procedimiento de ventana del control a través del lParam del mensaje de WM_CREATE para ese control.

Observaciones

Las unidades de diálogo horizontales son 1/4 de la unidad de ancho base del cuadro de diálogo. Las unidades verticales son 1/8 de la unidad de altura base del cuadro de diálogo. Las unidades base del cuadro de diálogo actual se calculan a partir del alto y el ancho de la fuente del sistema actual. La función GetDialogBaseUnits devuelve las unidades base del cuadro de diálogo en píxeles. Las coordenadas son relativas al origen del cuadro de diálogo.