OleCreatePropertyFrame-Funktion (olectl.h)

Artikel
03/04/2024

Ruft einen neuen Eigenschaftenrahmen auf, d. h. ein Eigenschaftenblattdialogfeld, dessen übergeordnetes Element hwndOwner ist, wobei das Dialogfeld an der Stelle (x,y) im übergeordneten Fenster positioniert ist und über die Untertitel lpszCaption verfügt.

Syntax

WINOLECTLAPI OleCreatePropertyFrame(
  [in] HWND      hwndOwner,
  [in] UINT      x,
  [in] UINT      y,
  [in] LPCOLESTR lpszCaption,
  [in] ULONG     cObjects,
  [in] LPUNKNOWN *ppUnk,
  [in] ULONG     cPages,
  [in] LPCLSID   pPageClsID,
  [in] LCID      lcid,
  [in] DWORD     dwReserved,
  [in] LPVOID    pvReserved
);

Parameter

[in] hwndOwner

Handle mit dem übergeordneten Fenster des resultierenden Eigenschaftenblattdialogfelds.

[in] x

Reserviert. Horizontale Position für das Dialogfeld relativ zu hwndOwner.

[in] y

Reserviert. Vertikale Position für das Dialogfeld relativ zu hwndOwner.

[in] lpszCaption

Zeiger auf die Zeichenfolge, die für die Untertitel des Dialogfelds verwendet wird.

[in] cObjects

Anzahl der in ppUnk übergebenen Objektzeiger.

[in] ppUnk

Ein Array von IUnknown-Zeigern auf die Objekte, für die dieses Eigenschaftenblatt aufgerufen wird. Die Anzahl der Elemente im Array wird von cObjects angegeben. Diese Zeiger werden über IPropertyPage::SetObjects an jede Eigenschaftenseite übergeben.

[in] cPages

Anzahl der Eigenschaftenseiten, die in pPageCIsID angegeben sind.

[in] pPageClsID

Array der Größe cPages mit den CLSIDs jeder Eigenschaftenseite, die im Eigenschaftenblatt angezeigt werden sollen.

[in] lcid

Gebietsschemabezeichner, der für das Eigenschaftenblatt verwendet werden soll. Eigenschaftenseiten können diesen Bezeichner über IPropertyPageSite::GetLocaleID abrufen.

[in] dwReserved

Für die zukünftige Verwendung reserviert. Muss 0 (null) sein.

[in] pvReserved

Für zukünftige Verwendung reserviert; muss NULL sein.

Rückgabewert

Diese Funktion unterstützt die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und E_UNEXPECTED sowie Folgendes:

Rückgabecode	BESCHREIBUNG
S_OK	Das Dialogfeld wurde aufgerufen und erfolgreich ausgeführt.
E_POINTER	Die Adresse in lpszCaption, ppUnk oder pPageCIsID ist ungültig. Eine davon kann beispielsweise NULL sein.

Hinweise

Die anzuzeigenden Eigenschaftenseiten werden mit pPageClsID identifiziert, bei dem es sich um ein Array von cPages-CLSID-Werten handelt. Die von diesem Eigenschaftenblatt betroffenen Objekte werden in ppUnk identifiziert, einem Array von cObjects der Größe, das IUnknown-Zeiger enthält.

Diese Funktion erstellt immer ein modales Dialogfeld und gibt erst zurück, wenn das Dialogfeld geschlossen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	olectl.h
Bibliothek	OleAut32.lib
DLL	OleAut32.dll

Weitere Informationen

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID