OleCreatePropertyFrame-Funktion (olectl.h)

Ruft einen neuen Eigenschaftenframe auf, d. h. ein Eigenschaftenblatt-Dialogfeld, dessen übergeordnetes Element hwndOwnerist, wobei das Dialogfeld am Punkt (x,y) im übergeordneten Fenster positioniert wird und die Beschriftung lpszCaptionhat.

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

Behandeln sie das übergeordnete 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

Zeigen Sie auf die Zeichenfolge, die für die Beschriftung des Dialogfelds verwendet wird.

[in] cObjects

Die Anzahl der in ppUnkübergebenen Objektzeiger.

[in] ppUnk

Ein Array von IUnknown Zeigern für die Objekte, für die dieses Eigenschaftenblatt aufgerufen wird. Die Anzahl der Elemente im Array wird durch cObjectsangegeben. Diese Zeiger werden über IPropertyPage::SetObjectsan jede Eigenschaftenseite übergeben.

[in] cPages

Anzahl der eigenschaftenseiten, die in pPageCIsIDangegeben sind.

[in] pPageClsID

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

[in] lcid

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

[in] dwReserved

Reserviert für die zukünftige Nutzung; muss null sein.

[in] pvReserved

Reserviert für die zukünftige Nutzung; muss NULL-sein.

Rückgabewert

Diese Funktion unterstützt die Standardrücklaufwerte E_INVALIDARG, E_OUTOFMEMORY und E_UNEXPECTED sowie folgendes:

Bemerkungen

Die anzuzeigenden Eigenschaftenseiten werden mit pPageClsID-identifiziert. Dabei handelt es sich um ein Array von cPagesCLSID- Werten. Die Objekte, die von diesem Eigenschaftenblatt betroffen sind, werden in ppUnk-identifiziert, einem Array von Größe cObjects, das IUnknown Zeiger enthält.

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

Anforderungen

Siehe auch

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID