estructura PROPSHEETHEADERA_V2 (prsht.h)

Define el marco y las páginas de una hoja de propiedades.

Nota:

Esta estructura no está pensada para usarse directamente en el código. En su lugar, use la estructura PROPSHEETHEADER .

Sintaxis

typedef struct _PROPSHEETHEADERA_V2 {
  union {
    HBITMAP hbmWatermark;
    LPCSTR  pszbmWatermark;
  } DUMMYUNIONNAME4;
  HPALETTE hplWatermark;
  union {
    HBITMAP hbmHeader;
    LPCSTR  pszbmHeader;
  } DUMMYUNIONNAME5;
} PROPSHEETHEADERA_V2, *LPPROPSHEETHEADERA_V2;

Members

DUMMYUNIONNAME4

DUMMYUNIONNAME4.hbmWatermark

Tipo: HBITMAP

Versión 5.80 o posterior. Controle el mapa de bits de la marca de agua. Si el miembro dwFlags no incluye PSH_USEHBMWATERMARK, este miembro se omite.

DUMMYUNIONNAME4.pszbmWatermark

Tipo: LPCTSTR

Versión 5.80 o posterior. Recurso de mapa de bits que se va a usar como marca de agua. Este miembro puede especificar el identificador del recurso de mapa de bits o la dirección de la cadena que especifica el nombre del recurso de mapa de bits. Si el miembro dwFlags incluye PSH_USEHBMWATERMARK, este miembro se omite.

hplWatermark

Tipo: HPALETTE

Versión 5.80 o posterior. Estructura HPALETTE utilizada para dibujar el mapa de bits de marca de agua o el mapa de bits de encabezado. Si el miembro dwFlags no incluye PSH_USEHPLWATERMARK, este miembro se omite.

DUMMYUNIONNAME5

DUMMYUNIONNAME5.hbmHeader

Tipo: HBITMAP

Versión 5.80 o posterior. Identificador del mapa de bits de encabezado. Si el miembro dwFlags no incluye PSH_USEHBMHEADER, este miembro se omite.

DUMMYUNIONNAME5.pszbmHeader

Tipo: LPCSTR

Versión 5.80 o posterior. Recurso de mapa de bits que se va a usar como encabezado. Este miembro puede especificar el identificador del recurso de mapa de bits o la dirección de la cadena que especifica el nombre del recurso de mapa de bits. Si el miembro dwFlags incluye PSH_USEHBMHEADER, este miembro se omite.

Comentarios

Si el usuario elige una configuración como Fuentes grandes, que amplía el cuadro de diálogo, también se ampliará la marca de agua que se pinta en las páginas de inicio y finalización. El tamaño y la posición del mapa de bits original seguirán siendo los mismos. El área adicional se rellenará con el color del píxel en la esquina superior izquierda del mapa de bits.

Tenga en cuenta que varios miembros de esta estructura solo se admiten para Comctl32.dll versiones 4.71 y posteriores. Puede habilitar estos miembros mediante la inclusión de uno de los siguientes elementos en el encabezado.

#define _WIN32_IE 0x0400 // For version 4.71

o

#define _WIN32_IE 0x0500 // For version 5.80

Sin embargo, debe inicializar la estructura con su tamaño. Si usa el tamaño de la estructura definida actualmente, es posible que la aplicación no se ejecute con las versiones anteriores de Comctl32.dll, que esperan una estructura más pequeña. Esto incluye todos los sistemas con Windows 95 o Microsoft Windows NT 4.0 que no tienen Instalado Internet Explorer 4.0 o posterior. Puede ejecutar la aplicación en versiones anteriores a la 4.71 de Comctl32.dll definiendo el número de versión adecuado. Sin embargo, esto puede causar problemas si la aplicación también necesita ejecutarse en sistemas con versiones más recientes.

Puede seguir siendo compatible con todas las versiones de Comctl32.dll mediante los archivos de encabezado actuales y estableciendo el tamaño de la estructura PROPSHEETHEADER correctamente. Antes de inicializar la estructura, use la función DllGetVersion para determinar qué versión de Comctl32.dll está instalada en el sistema. Si es la versión 4.71 o posterior, use

psh.dwSize = sizeof(PROPSHEETHEADER);

para inicializar el miembro dwSize . Para las versiones anteriores, el tamaño de la estructura anterior a la versión 4.71 lo da la constante PROPSHEETHEADER_V1_SIZE. Uso

psh.dwSize = PROPSHEETHEADER_V1_SIZE;

Los estilos PSH_WIZARD, PSH_WIZARD97 y PSH_WIZARD_LITE son mutuamente incompatibles. Solo se debe establecer una de estas marcas de estilo. PSH_AEROWIZARD debe combinarse con PSH_WIZARD.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	prsht.h