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 |