Estructura DLGPAGE (compstui.h)

La estructura DLGPAGE se usa para especificar una página de hoja de propiedades en la función ComPropSheet de CPSUI. La dirección de la estructura se incluye en una estructura COMPROPSHEETUI y el llamador comPropSheet proporciona todos los valores de miembro.

Sintaxis

typedef struct _DLGPAGE {
  WORD      cbSize;
  WORD      Flags;
  DLGPROC   DlgProc;
  LPTSTR    pTabName;
  ULONG_PTR IconID;
  union {
    WORD   DlgTemplateID;
    HANDLE hDlgTemplate;
  } DUMMYUNIONNAME;
} DLGPAGE, *PDLGPAGE;

Miembros

cbSize

Tamaño proporcionado por el autor de la llamada, en bytes, de la estructura DLGPAGE .

Flags

Marcas de bits proporcionadas por el autor de la llamada, como se describe en la tabla siguiente.

Marca	Definición
DPF_ICONID_AS_HICON	Si se establece, IconID contiene un identificador de icono. Si no se establece, IconID contiene un identificador de recurso de icono.
DPF_USE_HDLGTEMPLATE	Si se establece, hDlgTemplate contiene un identificador de plantilla. Si no se establece, DlgTemplateID contiene un identificador de recurso de plantilla.

Opcional, puntero con tipo DLGPROC proporcionado por el autor de la llamada a un procedimiento de cuadro de diálogo, que se usa para procesar los mensajes enviados por el sistema cuando se producen eventos de usuario. Si es NULL, CPSUI proporciona un procedimiento de cuadro de diálogo. Para obtener más información, vea la sección Comentarios a continuación.

DlgProc

Define el dlgproc miembro dlgproc del miembro DLGPROC.

pTabName

Puntero proporcionado por el autor de la llamada a una cadena terminada en NULL que se mostrará en la pestaña de página.

IconID

El autor de la llamada proporcionado puede ser uno de los siguientes:

• Un identificador de recurso de icono. Esto puede ser definido por la aplicación o puede ser uno de los identificadores de recursos de recursos de icono con prefijos de CPSUI IDI_CPSUI proporcionados por CPSUI.

• Identificador de icono. Si se especifica un identificador, DPF_ICONID_AS_HICON debe establecerse en el miembro Flags .

El icono especificado se muestra en la pestaña de página. Si este valor es cero, no se muestra un icono.

DUMMYUNIONNAME

Define la unión DUMMYUNIONNAME .

DUMMYUNIONNAME.DlgTemplateID

Identificador de recursos proporcionado por el autor de la llamada para una plantilla de cuadro de diálogo. Esto puede hacer referencia a un recurso DIALOG proporcionado por la aplicación o puede ser uno de los siguientes identificadores proporcionados por CPSUI (definidos en compstui.h):

Identificador	Tipo de página
DP_STD_DOCPROPPAGE1	Página nontreeview, que se usa para la página Diseño de un documento de impresión.
DP_STD_DOCPROPPAGE2	Página no de vista de árbol, utilizada para la página Papel/calidad de un documento impreso.
DP_STD_TREEVIEWPAGE	Página de vista de árbol genérica.

Los identificadores proporcionados por CPSUI hacen referencia a plantillas que pueden mostrar tipos de opción CPSUI. El tamaño de página de esas plantillas es 252 por 216 unidades de cuadro de diálogo. Para obtener más información, vea CpSUI-Supplied Pages and Templates.

Este miembro no se usa si DPF_USE_HDLGTEMPLATE está establecido en Marcas.

DUMMYUNIONNAME.hDlgTemplate

Identificador proporcionado por el autor de la llamada a una estructura DLGTEMPLATE .

Solo se usa si DPF_USE_HDLGTEMPLATE está establecido en Marcas.

Comentarios

CPSUI crea una página de hoja de propiedades asignando una estructura PROPSHEETPAGE y pasandola a CreatePropertySheetPage. Si el autor de la llamada ha especificado un puntero con tipo DLGPROC a un procedimiento de cuadro de diálogo en DlgProc, ese procedimiento se usa para controlar los mensajes de ventana de la página. Si DlgProc es NULL, se usan los propios procedimientos de cuadro de diálogo de CPSUI.

Cuando se llama al procedimiento del cuadro de diálogo al que apunta DlgProc con un valor de mensaje de WM_INITDIALOG, recibe la estructura PROPSHEETPAGE como entrada y también recibe una estructura PSPINFO .

Si un procedimiento de cuadro de diálogo proporcionado por el autor de la llamada controla un mensaje, debe devolver un valor distinto de cero. Si la función no controla el mensaje, debe devolver cero, lo que hace que CPSUI controle el mensaje.

Requisitos

Requisito	Valor
Header	compstui.h (incluya Compstui.h)