OleCreatePropertyFrame, fonction (olectl.h)

Article
03/04/2024

Appelle un nouveau cadre de propriété, c’est-à-dire une boîte de dialogue de feuille de propriétés, dont le parent est hwndOwner, où la boîte de dialogue est positionnée au point (x,y) dans la fenêtre parente et a la légende lpszCaption.

Syntaxe

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

Paramètres

[in] hwndOwner

Gérez la fenêtre parente de la boîte de dialogue de feuille de propriétés résultante.

[in] x

Réservé. Position horizontale de la boîte de dialogue par rapport à hwndOwner.

[in] y

Réservé. Position verticale de la boîte de dialogue par rapport à hwndOwner.

[in] lpszCaption

Pointeur vers la chaîne utilisée pour le légende de la boîte de dialogue.

[in] cObjects

Nombre de pointeurs d’objets passés dans ppUnk.

[in] ppUnk

Tableau de pointeurs IUnknown sur les objets pour lesquels cette feuille de propriétés est appelée. Le nombre d’éléments dans le tableau est spécifié par cObjects. Ces pointeurs sont transmis à chaque page de propriétés via IPropertyPage ::SetObjects.

[in] cPages

Nombre de pages de propriétés spécifiées dans pPageCIsID.

[in] pPageClsID

Tableau de taille cPages contenant les CLSID de chaque page de propriétés à afficher dans la feuille de propriétés.

[in] lcid

Identificateur de paramètres régionaux à utiliser pour la feuille de propriétés. Les pages de propriétés peuvent récupérer cet identificateur via IPropertyPageSite ::GetLocaleID.

[in] dwReserved

Réservé pour une future utilisation ; doit être nul.

[in] pvReserved

Réservé pour une utilisation ultérieure ; doit être NULL.

Valeur retournée

Cette fonction prend en charge les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les éléments suivants :

Code de retour	Description
S_OK	La boîte de dialogue a été appelée et a fonctionné avec succès.
E_POINTER	L’adresse dans lpszCaption, ppUnk ou pPageCIsID n’est pas valide. Par exemple, l’un d’eux peut avoir la valeur NULL.

Remarques

Les pages de propriétés à afficher sont identifiées avec pPageClsID, qui est un tableau de valeurs CLSIDcPages. Les objets affectés par cette feuille de propriétés sont identifiés dans ppUnk, un tableau de taille cObjects contenant des pointeurs IUnknown .

Cette fonction crée toujours une boîte de dialogue modale et ne retourne pas tant que la boîte de dialogue n’est pas fermée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	olectl.h
Bibliothèque	OleAut32.lib
DLL	OleAut32.dll

Voir aussi

IPropertyPage ::SetObjects

IPropertyPageSite ::GetLocaleID

Partager via