Estructura DLGTEMPLATEEX

Artículo
06/13/2023

Una plantilla de cuadro de diálogo extendida comienza con un encabezado DLGTEMPLATEEX que describe el cuadro de diálogo y especifica el número de controles del cuadro de diálogo. Para cada control de un cuadro de diálogo, una plantilla de cuadro de diálogo extendida tiene un bloque de datos que usa el formato DLGITEMTEMPLATEEX para describir el control.

La estructura DLGTEMPLATEEX no está definida en ningún archivo de encabezado estándar. La definición de estructura se proporciona aquí para explicar el formato de una plantilla extendida para un cuadro de diálogo.

Sintaxis

typedef struct {
  WORD      dlgVer;
  WORD      signature;
  DWORD     helpID;
  DWORD     exStyle;
  DWORD     style;
  WORD      cDlgItems;
  short     x;
  short     y;
  short     cx;
  short     cy;
  sz_Or_Ord menu;
  sz_Or_Ord windowClass;
  WCHAR     title[titleLen];
  WORD      pointsize;
  WORD      weight;
  BYTE      italic;
  BYTE      charset;
  WCHAR     typeface[stringLen];
} DLGTEMPLATEEX;

Miembros

dlgVer

Tipo: WORD

Número de versión de la plantilla del cuadro de diálogo extendido. Este miembro debe establecerse en 1.

firma

Tipo: WORD

Indica si una plantilla es una plantilla de cuadro de diálogo extendida. Si la firma es 0xFFFF, se trata de una plantilla de cuadro de diálogo extendida. En este caso, el miembro dlgVer especifica el número de versión de la plantilla. Si signature es cualquier valor distinto de 0xFFFF, se trata de una plantilla de cuadro de diálogo estándar que usa las estructuras DLGTEMPLATE y DLGITEMTEMPLATE .

helpID

Tipo: DWORD

Identificador de contexto de ayuda para la ventana del cuadro de diálogo. Cuando el sistema envía un mensaje de WM_HELP , pasa este valor en el miembro wContextId de la estructura HELPINFO .

exStyle

Tipo: DWORD

Estilos extendidos de ventanas. Este miembro no se usa al crear 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

Estilo del cuadro de diálogo. Este miembro puede ser una combinación de valores de estilo de ventana y valores de estilo de cuadro de diálogo.

Si style incluye el estilo del cuadro de diálogo DS_SETFONT o DS_SHELLFONT , el encabezado DLGTEMPLATEEX de la plantilla de cuadro de diálogo extendido contiene cuatro miembros adicionales ( pointsize, weight, italic y typeface) que describen la fuente que se va a usar para el texto del área cliente y los controles del cuadro de diálogo. Si es posible, el sistema crea una fuente según los valores especificados en estos miembros. A continuación, el sistema envía un mensaje WM_SETFONT al cuadro de diálogo y a cada control para proporcionar un identificador a la fuente.

Para obtener más información, vea Fuentes del cuadro de diálogo.

cDlgItems

Tipo: WORD

Número de controles del cuadro de diálogo.

x

Tipo: short

Coordenada x, en unidades del cuadro de diálogo, de la esquina superior izquierda del cuadro de diálogo.

y

Tipo: short

Coordenada y, en unidades del cuadro de diálogo, de la esquina superior izquierda del cuadro de diálogo.

cx

Tipo: short

Ancho, en unidades del cuadro de diálogo, del cuadro de diálogo.

cy

Tipo: short

Alto, en unidades del cuadro de diálogo, del cuadro de diálogo.

menú

Tipo: sz_Or_Ord

Matriz de longitud variable de elementos de 16 bits que identifica un recurso de menú para el cuadro de diálogo. Si el primer elemento de esta matriz es 0x0000, el cuadro de diálogo no tiene ningún menú y la matriz no tiene otros elementos. Si el primer elemento es 0xFFFF, la matriz tiene un elemento adicional que especifica el valor ordinal de un recurso de menú en un archivo ejecutable. Si el primer elemento tiene cualquier otro valor, el sistema trata la matriz como una cadena Unicode terminada en null que especifica el nombre de un recurso de menú en un archivo ejecutable.

windowClass

Tipo: sz_Or_Ord

Matriz de longitud variable de elementos de 16 bits que identifica la clase de ventana del cuadro de diálogo. Si el primer elemento de la matriz es 0x0000, el sistema usa la clase de cuadro de diálogo predefinida para el cuadro de diálogo y la matriz no tiene otros elementos. Si el primer elemento es 0xFFFF, la matriz tiene un elemento adicional que especifica el valor ordinal de una clase de ventana del sistema predefinida. Si el primer elemento tiene cualquier otro valor, el sistema trata la matriz como una cadena Unicode terminada en null que especifica el nombre de una clase de ventana registrada.

title

Tipo: WCHAR[titleLen]

Título del cuadro de diálogo. Si el primer elemento de esta matriz es 0x0000, el cuadro de diálogo no tiene título y la matriz no tiene otros elementos.

pointsize

Tipo: WORD

Tamaño de punto de la fuente que se va a usar para el texto del cuadro de diálogo y sus controles.