OleCreatePropertyFrame, fonction (olectl.h)

Article
07/16/2024

Appelle un nouveau cadre de propriété, autrement dit, 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 la légende de la boîte de dialogue.

[in] cObjects

Nombre de pointeurs d’objet 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 passés à 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é à une utilisation ultérieure ; doit être égal à zéro.

[in] pvReserved

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

Valeur de retour

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

Retourner le code	Description
S_OK	La boîte de dialogue a été appelée et fonctionne correctement.
E_POINTER	L’adresse dans lpszCaption, ppUnkou pPageCIsID n’est pas valide. Par exemple, l’un d’eux peut être NULL.

Remarques

Les pages de propriétés à afficher sont identifiées avec pPageClsID, qui est un tableau de valeurs cPagesCLSID. Les objets affectés par cette feuille de propriétés sont identifiés dans ppUnk, 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	olectl.h
bibliothèque	OleAut32.lib
DLL	OleAut32.dll

Voir aussi

IPropertyPage ::SetObjects

IPropertyPageSite ::GetLocaleID

Partager via