IShellPropSheetExt ::AddPages, méthode (shobjidl_core.h)

Article
03/02/2024

Ajoute une ou plusieurs pages à une feuille de propriétés que l’interpréteur de commandes affiche pour un objet fichier. L’interpréteur de commandes appelle cette méthode pour chaque gestionnaire de feuille de propriétés inscrit au type de fichier.

Syntaxe

HRESULT AddPages(
  [in] LPFNSVADDPROPSHEETPAGE pfnAddPage,
  [in] LPARAM                 lParam
);

Paramètres

[in] pfnAddPage

Type : LPFNADDPROPSHEETPAGE

Pointeur vers une fonction que le gestionnaire de feuilles de propriétés appelle pour ajouter une page à la feuille de propriétés. La fonction prend un handle de feuille de propriétés retourné par la fonction CreatePropertySheetPage et le paramètre lParam transmis à cette méthode.

[in] lParam

Type : LPARAM

Données spécifiques au gestionnaire à passer à la fonction pointée par pfnAddPage.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne un index de base unique pour spécifier la page qui doit être affichée initialement. Pour plus d'informations, consultez la section Notes.

Remarques

Pour chaque page que le gestionnaire de feuilles de propriétés doit ajouter à une feuille de propriétés, le gestionnaire remplit une structure PROPSHEETPAGE , appelle la fonction CreatePropertySheetPage , puis appelle la fonction pointée par pfnAddPage.

Le type de pointeur de fonction LPFNADDPROPSHEETPAGE est défini dans Prsht.h, comme illustré ici. Il accepte un handle pour une structure PROPSHEETPAGE et des données définies par la fonction via lParam.

typedef BOOL (* LPFNADDPROPSHEETPAGE)(HPROPSHEETPAGE, LPARAM);

Vous pouvez demander, par le biais de votre implémentation, qu’une page de feuille de propriétés particulière s’affiche en premier au lieu de la page par défaut. Pour ce faire, retournez l’index de base unique de la page souhaitée par rapport aux pages que vous avez ajoutées. Par exemple, si vous avez ajouté trois pages de feuille de propriétés, A, B et C, et que vous souhaitez que B soit la page sélectionnée, la valeur de retour doit être 2. Notez que cette valeur de retour n’est qu’une requête. La feuille de propriétés peut toujours afficher la page par défaut.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)
DLL	Shell32.dll (version 4.0 ou ultérieure)

Partager via