Estructura DLGITEMTEMPLATEEX
Bloque de texto usado por una plantilla de cuadro de diálogo extendido para describir el cuadro de diálogo extendido. Para obtener una descripción del formato de una plantilla de cuadro de diálogo extendido, consulte DLGTEMPLATEEX.
Sintaxis
typedef struct {
DWORD helpID;
DWORD exStyle;
DWORD style;
short x;
short y;
short cx;
short cy;
DWORD id;
sz_Or_Ord windowClass;
sz_Or_Ord title;
WORD extraCount;
} DLGITEMTEMPLATEEX;
Miembros
-
helpID
-
Tipo: DWORD
-
Identificador de contexto de ayuda para el control. Cuando el sistema envía un mensaje de WM_HELP , pasa el valor helpID en el miembro dwContextId de la estructura HELPINFO .
-
exStyle
-
Tipo: DWORD
-
Estilos extendidos para una ventana. Este miembro no se usa para crear controles en cuadros de diálogo, pero las aplicaciones que usan plantillas de cuadro de diálogo pueden usarlas para crear otros tipos de ventanas. Para obtener una lista de valores, vea Estilos de ventana extendidos.
-
style
-
Tipo: DWORD
-
El estilo del control. Este miembro puede ser una combinación de valores de estilo de ventana (como WS_BORDER) y uno o varios de los valores de estilo de control (como BS_PUSHBUTTON y ES_LEFT).
-
x
-
Tipo: short
-
Coordenada x, en unidades del cuadro de diálogo, de la esquina superior izquierda del control. Esta coordenada siempre es relativa a la esquina superior izquierda del área de cliente del cuadro de diálogo.
-
y
-
Tipo: short
-
Coordenada y, en unidades del cuadro de diálogo, de la esquina superior izquierda del control. Esta coordenada siempre es relativa a la esquina superior izquierda del área de cliente del cuadro de diálogo.
-
cx
-
Tipo: short
-
Ancho, en unidades del cuadro de diálogo, del control .
-
cy
-
Tipo: short
-
Alto, en unidades del cuadro de diálogo, del control .
-
id
-
Tipo: DWORD
-
Identificador de control.
-
windowClass
-
Tipo: sz_Or_Ord
-
Matriz de longitud variable de elementos de 16 bits que especifica la clase de ventana del control. Si el primer elemento de esta matriz es cualquier valor distinto de 0xFFFF, el sistema trata la matriz como una cadena Unicode terminada en null que especifica el nombre de una clase de ventana registrada.
Si el primer elemento es 0xFFFF, la matriz tiene un elemento adicional que especifica el valor ordinal de una clase de sistema predefinida. El ordinal puede ser uno de los siguientes valores atom.
Value Significado - 0x0080
Botón - 0x0081
Editar - 0x0082
Estático - 0x0083
Cuadro de lista - 0x0084
Barra de desplazamiento - 0x0085
Cuadro combinado -
title
-
Tipo: sz_Or_Ord
-
Matriz de longitud variable de elementos de 16 bits que contiene el texto inicial o el identificador de recursos del control. Si el primer elemento de esta matriz es 0xFFFF, la matriz tiene un elemento adicional que especifica el valor ordinal de un recurso, como un icono, en un archivo ejecutable. Puede usar un identificador de recursos para los controles, como controles de icono estáticos, que cargan y muestran un icono u otro recurso en lugar de texto. Si el primer elemento es cualquier valor distinto de 0xFFFF, el sistema trata la matriz como una cadena Unicode terminada en null que especifica el texto inicial.
-
extraCount
-
Tipo: WORD
-
Número de bytes de datos de creación que siguen a este miembro. Si este valor es mayor que cero, los datos de creación comienzan en el siguiente límite de WORD . Estos datos de creación pueden tener cualquier tamaño y formato. El procedimiento de ventana del control debe ser capaz de interpretar los datos. Cuando el sistema crea el control, pasa un puntero a estos datos en el parámetro lParam del mensaje WM_CREATE que envía al control.
Comentarios
Una plantilla extendida para un cuadro de diálogo consta de un encabezado DLGTEMPLATEEX seguido de una estructura DLGITEMTEMPLATEEX para cada control del cuadro de diálogo.
Cada estructura DLGITEMTEMPLATEEX debe alinearse en un límite DWORD . Las matrices windowClass y title de longitud variable deben alinearse en los límites de WORD . La matriz de datos de creación, si existe, debe alinearse en un límite de WORD .
Si especifica cadenas de caracteres en las matrices windowClass y title , debe usar cadenas Unicode. Use la función MultiByteToWideChar para generar cadenas Unicode a partir de cadenas ANSI.
Los miembros x, y, cx y cy especifican valores en las unidades del cuadro de diálogo. Puede convertir estos valores en unidades de pantalla (píxeles) mediante la función MapDialogRect .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
Consulte también
-
Referencia
-
Conceptual
-
Otros recursos