Méthode IFileSaveDialog::SetCollectedProperties (shobjidl_core.h)

Spécifie les propriétés à collecter dans la boîte de dialogue d’enregistrement.

Syntaxe

HRESULT SetCollectedProperties(
  [in] IPropertyDescriptionList *pList,
  [in] BOOL                     fAppendDefault
);

Paramètres

[in] pList

Type : IPropertyDescriptionList*

Pointeur vers l’interface qui représente la liste des propriétés à collecter. Ce paramètre peut être NULL.

[in] fAppendDefault

Type : BOOL

TRUE pour afficher les propriétés par défaut du type de fichier actuellement sélectionné en plus des propriétés spécifiées par pList. FALSE pour afficher uniquement les propriétés spécifiées par pList.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’application appelante peut utiliser la fonction PSGetPropertyDescriptionListFromString pour construire un IPropertyDescriptionList à partir d’une chaîne telle que « prop:Comments; Objet; ».

Pour plus d’informations sur les schémas de propriété, consultez Schémas de propriété.

IFileSaveDialog::SetCollectedProperties peut être appelé à tout moment avant que la boîte de dialogue s’affiche ou qu’elle soit visible. Si différentes propriétés doivent être collectées en fonction du type de fichier choisi, IFileSaveDialog::SetCollectedProperties peut être appelé en réponse à OnTypeChange.

Note Par défaut, aucune propriété n’est collectée dans la boîte de dialogue d’enregistrement.
 

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h

Voir aussi

IFileSaveDialog

IFileSaveDialog::SetProperties