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

CreateDialogIndirect

CreateDialogIndirectParam

CreateWindowEx

DialogBoxIndirect

DialogBoxIndirectParam

DLGTEMPLATEEX

MapDialogRect

WM_CREATE

Conceptual

Cuadros de diálogo

Otros recursos

MultiByteToWideChar

WM_HELP