Funzione OleCreatePropertyFrame (olectl.h)

Articolo
03/05/2024

Richiama una nuova cornice di proprietà, ovvero una finestra di dialogo della finestra di dialogo della finestra delle proprietà, il cui padre è hwndOwner, in cui la finestra di dialogo viene posizionata nel punto (x,y) nella finestra padre e ha il 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 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 il didascalia della finestra di dialogo.

[in] cObjects

Numero di puntatori a oggetti passati in ppUnk.

[in] ppUnk

Matrice di puntatori IUnknown sugli oggetti per cui 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 utilizzi futuri; 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, ppUnk o pPageCIsID non è valido. Ad esempio, uno di essi può essere NULL.

Commenti

Le pagine delle proprietà da visualizzare sono identificate con pPageClsID, ovvero una matrice di valori CLSIDcPages. Gli oggetti interessati da questa finestra delle proprietà sono identificati in ppUnk, una matrice di dimensioni cObject contenenti puntatoriIUnknown .

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	olectl.h
Libreria	OleAut32.lib
DLL	OleAut32.dll

Vedi anche

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID