PSPINFO-Struktur (compstui.h)

Die PSPINFO--Struktur wird als Eingabeparameter für die Dialogfeldprozedur einer Eigenschaftenblattseite verwendet, wenn die Windows-Meldung 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;

Angehörige

cbSize

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

wReserved

Reserviert.

hComPropSheet

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

hCPSUIPage

CPSUI-bereitgestelltes Handle auf der Eigenschaftenblattseite.

pfnComPropSheet

CPSUI-bereitgestellter Zeiger auf die ComPropSheet--Funktion.

Bemerkungen

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

Um die Adresse des PSPINFO Struktur abzurufen, verwenden Sie das PPSPINFO_FROM_WM_INITDIALOG_LPARAM Makro (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, der Inhalt der Struktur darf jedoch nicht geändert werden.

Anforderungen

Anforderung	Wert
Header-	compstui.h (include Compstui.h)