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

Fournit une banque de propriétés qui définit les valeurs par défaut à utiliser pour l'élément en cours d'enregistrement.

Syntaxe

HRESULT SetProperties(
  [in] IPropertyStore *pStore
);

Paramètres

[in] pStore

Type : IPropertyStore*

Pointeur vers l’interface qui représente le magasin de propriétés qui contient les métadonnées associées.

Valeur retournée

Type : HRESULT

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

Remarques

Cette méthode peut être appelée à tout moment avant l’ouverture de la boîte de dialogue ou pendant l’affichage de la boîte de dialogue. Si un élément a des propriétés inhérentes, cette méthode doit être appelée avec ces propriétés avant d’afficher la boîte de dialogue.

Lorsque vous utilisez Enregistrer sous, l’application doit fournir les propriétés de l’élément en cours d’enregistrement dans la boîte de dialogue Enregistrer . Ces propriétés doivent être extraites de l’élément d’origine en appelant GetPropertyStore avec l’indicateur GPS_HANDLERPROPERTIESONLY .

Pour récupérer les propriétés de l’élément enregistré (qui ont peut-être été modifiés par l’utilisateur) après la fermeture de la boîte de dialogue, appelez IFileSaveDialog ::GetProperties.

Pour activer la collection de propriétés et indiquer quelles propriétés doivent être affichées dans la boîte de dialogue Enregistrer , utilisez IFileSaveDialog ::SetCollectedProperties.

Configuration requise

Condition requise	Valeur
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 ::GetProperties

IFileSaveDialog ::SetCollectedProperties