Partager via

Structure PSPINFO (compstui.h)

  • Article

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 dans la page de la feuille de propriétés.

pfnComPropSheet

Pointeur fourni par CPSUI vers sa fonction ComPropSheet.

Remarques

Avant d’appeler CreatePropertySheetPage pour créer une page de feuille de propriétés, elle 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 par une structureDLGPAGE) 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 du PSPINFO structure, 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é.

Exigences

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