PROPSHEETUI_INFO_HEADER structure (compstui.h)

La structure PROPSHEETUI_INFO_HEADER est utilisée comme paramètre d’entrée pour la fonction de type PFNPROPSHEETUI d’une application, lorsque la fonction est appelée avec une valeur de raison de PROPSHEETUI_REASON_GET_INFO_HEADER.

Syntaxe

typedef struct _PROPSHEETUI_INFO_HEADER {
  WORD      cbSize;
  WORD      Flags;
  LPTSTR    pTitle;
  HWND      hWndParent;
  HINSTANCE hInst;
  union {
    HICON     hIcon;
    ULONG_PTR IconID;
  } DUMMYUNIONNAME;
} PROPSHEETUI_INFO_HEADER, *PPROPSHEETUI_INFO_HEADER;

Membres

cbSize

Taille fournie par CPSUI, en octets, de la structure PROPSHEETUI_INFO_HEADER .

Flags

Indicateurs de bits facultatifs spécifiés par l’application qui modifient l’apparence de la page de feuille de propriétés. Les indicateurs répertoriés dans le tableau suivant peuvent être utilisés dans n’importe quelle combinaison.

Indicateur	Description
PSUIHDRF_DEFTITLE	S’il est défini, CPSUI doit inclure « Default » dans la chaîne de barre de titre. CPSUI ajoute « Default » après la chaîne pTitle et, si PSUIHDRF_PROPTITLE est défini, avant « Properties ».
PSUIHDRF_EXACT_PTITLE	Si elle est définie, CPSUI utilise le texte spécifié par pTitle sans modification. Cet indicateur remplace les PSUIHDRF_DEFTITLE et les PSUIHDRF_PROPTITLE.
PSUIHDRF_NOAPPLYNOW	S’il est défini, CPSUI ne doit pas inclure de bouton Appliquer maintenant .
PSUIHDRF_PROPTITLE	Si cette option est définie, CPSUI doit ajouter « Propriétés » à la chaîne de barre de titre. (Par défaut, CPSUI définit cet indicateur avant d’appeler l’application.)
PSUIHDRF_USEHICON	Si la valeur est définie, l’union hIcon/IconID contient un handle d’icône. Si elle n’est pas définie, l’union contient un identificateur de ressource d’icône.

pTitle

Identificateur de chaîne, représentant le texte à afficher dans la barre de titre de la feuille de propriétés. Il peut s’agir d’un pointeur 32 bits vers une chaîne terminée par NULL, ou d’un identificateur de ressource de chaîne 16 bits avec HIWORD défini sur zéro. Pour les DLL d’interface d’imprimante, la chaîne contient généralement le nom de l’imprimante.

hWndParent

Handle vers la fenêtre à utiliser comme parent de la feuille de propriétés. Par défaut, CPSUI fournit le handle de fenêtre qu’il a reçu pour le paramètre hWndOwner à CommonPropertySheetUI, mais l’application peut remplacer ce handle par un autre.

hInst

Handle de instance fourni par l’application, que CPSUI utilise lors du chargement des ressources d’application.

DUMMYUNIONNAME

Cette union identifie l’icône à afficher dans la barre de titre de la feuille de propriétés.

DUMMYUNIONNAME.hIcon

Définit le membre HICON hIcon.

DUMMYUNIONNAME.IconID

Définit le ULONG_PTRmembre IconID. Le membre de l’union est sélectionné par PSUIHDRF_USEICON dans Indicateurs.

Configuration requise

Condition requise	Valeur
En-tête	compstui.h (inclure Compstui.h)