IShellPropSheetExt::AddPages-Methode (shobjidl_core.h)

Artikel
03/02/2024

Fügt einem Eigenschaftenblatt, das von der Shell für ein Dateiobjekt angezeigt wird, eine oder mehrere Seiten hinzu. Die Shell ruft diese Methode für jeden Eigenschaftenblatthandler auf, der für den Dateityp registriert ist.

Syntax

HRESULT AddPages(
  [in] LPFNSVADDPROPSHEETPAGE pfnAddPage,
  [in] LPARAM                 lParam
);

Parameter

[in] pfnAddPage

Typ: LPFNADDPROPSHEETPAGE

Ein Zeiger auf eine Funktion, die vom Eigenschaftenblatthandler aufgerufen wird, um dem Eigenschaftenblatt eine Seite hinzuzufügen. Die Funktion verwendet ein Eigenschaftenblatthandle, das von der CreatePropertySheetPage-Funktion zurückgegeben wird, und den lParam-Parameter , der an diese Methode übergeben wird.

[in] lParam

Typ: LPARAM

Handlerspezifische Daten, die an die Funktion übergeben werden sollen, auf die pfnAddPage verweist.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung einen 1-basierten Index zurück, um die Seite anzugeben, die zunächst angezeigt werden soll. Weitere Informationen finden Sie unter Hinweise.

Hinweise

Für jede Seite, die der Eigenschaftenblatthandler einem Eigenschaftenblatt hinzufügen muss, füllt der Handler eine PROPSHEETPAGE-Struktur aus, ruft die CreatePropertySheetPage-Funktion auf und ruft dann die Funktion auf, auf die pfnAddPage verweist.

Der Zeigertyp der Funktion LPFNADDPROPSHEETPAGE ist wie hier gezeigt in Prsht.h definiert. Es akzeptiert ein Handle für eine PROPSHEETPAGE-Struktur und funktionsdefinierte Daten über lParam.

typedef BOOL (* LPFNADDPROPSHEETPAGE)(HPROPSHEETPAGE, LPARAM);

Sie können über Ihre Implementierung anfordern, dass zuerst eine bestimmte Eigenschaftenblattseite anstelle der Standardseite angezeigt wird. Geben Sie hierzu den 1-basierten Index der gewünschten Seite relativ zu den hinzugefügten Seiten zurück. Wenn Sie z. B. drei Eigenschaftenblattseiten hinzugefügt haben: A, B und C, und B soll die ausgewählte Seite sein, sollte der Rückgabewert 2 sein. Beachten Sie, dass dieser Rückgabewert nur eine Anforderung ist. Im Eigenschaftenblatt wird möglicherweise weiterhin die Standardseite angezeigt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shell32.dll (Version 4.0 oder höher)

Freigeben über