PSPINFO-Struktur (compstui.h)

Die PSPINFO-Struktur wird als Eingabeparameter für die Dialogfeldprozedur einer Eigenschaftenblattseite verwendet, wenn die Windows-Nachricht WM_INITDIALOG wird. Die Adresse der Dialogfeldprozedur wird in einer DLGPAGE-Struktur angegeben.

Syntax

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

Member

cbSize

CPSUI-bereitgestellte Größe der PSPINFO-Struktur in Bytes.

wReserved

Reserviert.

hComPropSheet

Von CPSUI bereitgestelltes Handle für das übergeordnete Element der Seite, deren Handle in hCPSUIPage enthalten ist.

hCPSUIPage

CpSUI-bereitgestelltes Handle für die Eigenschaftenblattseite.

pfnComPropSheet

Von CPSUI bereitgestellter Zeiger auf die ComPropSheet-Funktion .

Hinweise

Bevor CPSUI CreatePropertySheetPage aufruft, um eine Eigenschaftenblattseite zu erstellen, wird die Größe der standardmäßigen PROPSHEETPAGE-Struktur erweitert, um eine PSPINFO-Struktur anzufügen. Wenn das Betriebssystem eine Dialogfeldprozedur aufruft (auf die von einer DLGPAGE-Struktur verwiesen wird) und eine WM_INITDIALOG Nachricht angibt, verweist das lParam-Element der Funktion auf die erweiterte PROPSHEETPAGE-Struktur , die die PSPINFO-Struktur enthält.

Um die Adresse der PSPINFO-Struktur abzurufen, verwenden Sie das makro PPSPINFO_FROM_WM_INITDIALOG_LPARAM (definiert in compstui.h) wie folgt:

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

Der PSPINFO-Strukturzeiger kann zur späteren Verwendung gespeichert werden, aber der Inhalt der Struktur darf nicht geändert werden.

Anforderungen

Anforderung	Wert
Header	compstui.h (einschließlich Compstui.h)