structure PROPSHEETHEADERA_V2 (prsht.h)

Définit le cadre et les pages d’une feuille de propriétés.

Syntaxe

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

Membres

DUMMYUNIONNAME4

DUMMYUNIONNAME4.hbmWatermark

Type : HBITMAP

Version 5.80 ou ultérieure. Gérez l’image bitmap de filigrane. Si le membre dwFlags n’inclut pas PSH_USEHBMWATERMARK, ce membre est ignoré.

DUMMYUNIONNAME4.pszbmWatermark

Type : LPCTSTR

Version 5.80 ou ultérieure. Ressource bitmap à utiliser comme filigrane. Ce membre peut spécifier l’identificateur de la ressource bitmap ou l’adresse de la chaîne qui spécifie le nom de la ressource bitmap. Si le membre dwFlags inclut PSH_USEHBMWATERMARK, ce membre est ignoré.

hplWatermark

Type : HPALETTE

Version 5.80 ou ultérieure. Structure HPALETTE utilisée pour dessiner la bitmap de filigrane et/ou l’image bitmap d’en-tête. Si le membre dwFlags n’inclut pas PSH_USEHPLWATERMARK, ce membre est ignoré.

DUMMYUNIONNAME5

DUMMYUNIONNAME5.hbmHeader

Type : HBITMAP

Version 5.80 ou ultérieure. Gérez l’en-tête bitmap. Si le membre dwFlags n’inclut pas PSH_USEHBMHEADER, ce membre est ignoré.

DUMMYUNIONNAME5.pszbmHeader

Type : LPCSTR

Version 5.80 ou ultérieure. Ressource bitmap à utiliser comme en-tête. Ce membre peut spécifier l’identificateur de la ressource bitmap ou l’adresse de la chaîne qui spécifie le nom de la ressource bitmap. Si le membre dwFlags inclut PSH_USEHBMHEADER, ce membre est ignoré.

Notes

Si l’utilisateur choisit un paramètre tel que Polices volumineuses, qui agrandit la boîte de dialogue, le filigrane peint sur les pages de début et de fin est également agrandi. La taille et la position de l’image bitmap d’origine resteront identiques. La zone supplémentaire est remplie avec la couleur du pixel dans le coin supérieur gauche de la bitmap.

Notez que plusieurs membres de cette structure sont uniquement pris en charge pour Comctl32.dll versions 4.71 et ultérieures. Vous pouvez activer ces membres en incluant l’un des éléments suivants dans votre en-tête.

#define _WIN32_IE 0x0400 // For version 4.71

or

#define _WIN32_IE 0x0500 // For version 5.80

Toutefois, vous devez initialiser la structure avec sa taille. Si vous utilisez la taille de la structure actuellement définie, l’application peut ne pas s’exécuter avec les versions antérieures de Comctl32.dll, qui s’attendent à une structure plus petite. Cela inclut tous les systèmes avec Windows 95 ou Microsoft Windows NT 4.0 qui n’ont pas installé Internet Explorer 4.0 ou version ultérieure. Vous pouvez exécuter votre application sur les versions antérieures à la version 4.71 de Comctl32.dll en définissant le numéro de version approprié. Toutefois, cela peut entraîner des problèmes si votre application doit également s’exécuter sur des systèmes avec des versions plus récentes.

Vous pouvez rester compatible avec toutes les versions Comctl32.dll en utilisant les fichiers d’en-tête actuels et en définissant la taille de la structure PROPSHEETHEADER de manière appropriée. Avant d’initialiser la structure, utilisez la fonction DllGetVersion pour déterminer quelle version Comctl32.dll est installée sur le système. S’il s’agit de la version 4.71 ou ultérieure, utilisez

psh.dwSize = sizeof(PROPSHEETHEADER);

pour initialiser le membre dwSize . Pour les versions antérieures, la taille de la structure antérieure à 4.71 est donnée par la constante PROPSHEETHEADER_V1_SIZE. Utilisation

psh.dwSize = PROPSHEETHEADER_V1_SIZE;

Les styles PSH_WIZARD, PSH_WIZARD97 et PSH_WIZARD_LITE sont incompatibles. Un seul de ces indicateurs de style doit être défini. PSH_AEROWIZARD doit être combiné avec PSH_WIZARD.

Spécifications