Partager via


structure PROPSHEETUI_INFO_HEADER (compstui.h)

La structure PROPSHEETUI_INFO_HEADER est utilisée comme paramètre d’entrée pour la fonction PFNPROPSHEETUI-typed, 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.

Drapeau Description
PSUIHDRF_DEFTITLE Si elle est définie, 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éfinie, avant « Properties ».
PSUIHDRF_EXACT_PTITLE Si elle est définie, CPSUI utilise le texte spécifié par pTitle sans modification. Cet indicateur remplace PSUIHDRF_DEFTITLE et PSUIHDRF_PROPTITLE.
PSUIHDRF_NOAPPLYNOW Si cette option est définie, CPSUI ne doit pas inclure un bouton Appliquer maintenant.
PSUIHDRF_PROPTITLE Si elle 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 elle est définie, l'hIcon/IconID union contient un handle d’icône. S’il n’est pas défini, 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 il peut s’agir 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 pour CommonPropertySheetUI, mais l’application peut remplacer ce handle avec un autre.

hInst

Handle d’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 HICONhIcon.

DUMMYUNIONNAME.IconID

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

Exigences

Exigence Valeur
d’en-tête compstui.h (include Compstui.h)