Structure PSPINFO (compstui.h)

La structure PSPINFO est utilisée comme paramètre d’entrée dans la procédure de boîte de dialogue d’une page de feuille de propriétés, lorsque le message Windows est WM_INITDIALOG. L’adresse de la procédure de boîte de dialogue est spécifiée dans une structure DLGPAGE .

Syntaxe

typedef struct _PSPINFO {
  WORD            cbSize;
  WORD            wReserved;
  HANDLE          hComPropSheet;
  HANDLE          hCPSUIPage;
  PFNCOMPROPSHEET pfnComPropSheet;
} PSPINFO, *PPSPINFO;

Membres

cbSize

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

wReserved

Réservé.

hComPropSheet

Handle fourni par CPSUI au parent de la page dont le handle est contenu dans hCPSUIPage.

hCPSUIPage

Handle fourni par CPSUI à la page de la feuille de propriétés.

pfnComPropSheet

Pointeur fourni par CPSUI vers sa fonction ComPropSheet .

Remarques

Avant que CPSUI appelle CreatePropertySheetPage pour créer une page de feuille de propriétés, il développe la taille de la structure PROPSHEETPAGE standard afin d’ajouter une structure PSPINFO . Lorsque le système d’exploitation appelle une procédure de boîte de dialogue (pointée vers une structure DLGPAGE ) et spécifie un message WM_INITDIALOG , le membre lParam de la fonction pointe vers la structure PROPSHEETPAGE développée contenant la structure PSPINFO .

Pour obtenir l’adresse de la structure PSPINFO , utilisez la macro PPSPINFO_FROM_WM_INITDIALOG_LPARAM (définie dans compstui.h) comme suit :

PPSPINFO pPspInfo;
if (Msg == WM_INITDIALOG) {
    pPspInfo = PPSPINFO_FROM_WM_INITDIALOG_LPARAM(lParam);
}

Le pointeur de structure PSPINFO peut être enregistré pour une utilisation ultérieure, mais le contenu de la structure ne doit pas être modifié.

Configuration requise