Funzione OleCreatePropertyFrame (olectl.h)

Richiama una nuova cornice di proprietà, ovvero una finestra di dialogo della finestra di dialogo della finestra delle proprietà, il cui padre è hwndOwner, dove la finestra di dialogo viene posizionata nel punto (x,y) nella finestra padre e ha la didascalia lpszCaption.

Sintassi

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
);

Parametri

[in] hwndOwner

Handle nella finestra padre della finestra di dialogo della finestra di dialogo della finestra delle proprietà risultante.

[in] x

Riservato. Posizione orizzontale per la finestra di dialogo rispetto a hwndOwner.

[in] y

Riservato. Posizione verticale per la finestra di dialogo rispetto a hwndOwner.

[in] lpszCaption

Puntatore alla stringa utilizzata per la didascalia della finestra di dialogo.

[in] cObjects

Numero di puntatori a oggetti passati in ppUnk.

[in] ppUnk

Matrice di IUnknown puntatori sugli oggetti per i quali viene richiamata la finestra delle proprietà. Il numero di elementi nella matrice viene specificato da cObjects. Questi puntatori vengono passati a ogni pagina delle proprietà tramite IPropertyPage::SetObjects.

[in] cPages

Numero di pagine delle proprietà specificate in pPageCIsID.

[in] pPageClsID

Matrice di dimensioni cPages contenente i CLSID di ogni pagina delle proprietà da visualizzare nella finestra delle proprietà.

[in] lcid

Identificatore delle impostazioni locali da utilizzare per la finestra delle proprietà. Le pagine delle proprietà possono recuperare questo identificatore tramite IPropertyPageSite::GetLocaleID.

[in] dwReserved

Riservato per uso futuro; deve essere zero.

[in] pvReserved

Riservato per uso futuro; deve essere null.

Valore restituito

Questa funzione supporta i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, nonché i seguenti:

Codice restituito	Descrizione
S_OK	La finestra di dialogo è stata richiamata e gestita correttamente.
E_POINTER	L'indirizzo in lpszCaption, ppUnko pPageCIsID non è valido. Ad esempio, uno qualsiasi di essi può essere NULL.

Osservazioni

Le pagine delle proprietà da visualizzare vengono identificate con pPageClsID, che è una matrice di valori cPagesCLSID. Gli oggetti interessati da questa finestra delle proprietà sono identificati in ppUnk, una matrice di dimensioni cObjects contenente puntatori IUnknown.

Questa funzione crea sempre una finestra di dialogo modale e non restituisce finché la finestra di dialogo non viene chiusa.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	olectl.h
libreria	OleAut32.lib
dll	OleAut32.dll

Vedere anche

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID