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 [,  . . . ]]}]

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 las comillas dobles dos veces.

Un carácter de y comercial (&) en el texto indica que el carácter siguiente 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 y comercial (&&).

Id

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 sin signo de 16 bits 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 sin signo de 16 bits 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 de 16 bits sin signo en el intervalo de 1 a 65 535. El ancho está en unidades de 1/4 caracteres.

Altura

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

Estilo

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

estilo extendido

Estilos de ventana extendidos. Debe especificar el estilo para especificar el 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. Cuando se crea un diálogo y se crea un control en ese 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.

Comentarios

Las unidades de diálogo horizontales son 1/4 de la unidad de ancho base del diálogo. Las unidades verticales son 1/8 de la unidad de alto base del cuadro de diálogo. Las unidades base de diálogo actuales se calculan a partir del alto y ancho de la fuente actual del sistema. 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.