GetSaveFileNameW, fonction (commdlg.h)

Article
11/20/2024

[À compter de Windows Vista, les boîtes de dialogue Ouvrir et Enregistrer sous boîtes de dialogue courantes ont été remplacées par la boîte de dialogue Élément commun. Nous vous recommandons d’utiliser l’API de boîte de dialogue Élément commun au lieu de ces boîtes de dialogue à partir de la bibliothèque de boîtes de dialogue commune.]

Crée un boîte de dialogue Enregistrer qui permet à l’utilisateur de spécifier le lecteur, le répertoire et le nom d’un fichier à enregistrer.

Syntaxe

BOOL GetSaveFileNameW(
  [in, out] LPOPENFILENAMEW unnamedParam1
);

Paramètres

[in, out] unnamedParam1

Type : LPOPENFILENAME

Pointeur vers une structure OPENFILENAME qui contient des informations utilisées pour initialiser la boîte de dialogue. Lorsque GetSaveFileName retourne, cette structure contient des informations sur la sélection du fichier de l’utilisateur.

Valeur de retour

Type : BOOL

Si l’utilisateur spécifie un nom de fichier et clique sur le bouton OK et que la fonction réussit, la valeur de retour est différente de zéro. La mémoire tampon pointée par le membre lpstrFile de la structure OPENFILENAME contient le chemin d’accès complet et le nom de fichier spécifiés par l’utilisateur.

Si l’utilisateur annule ou ferme la boîte de dialogue Enregistrer ou une erreur telle que la mémoire tampon du nom de fichier trop petite se produit, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez la fonction CommDlgExtendedError , qui peut retourner l’une des valeurs suivantes :

Remarques

Le style Explorateur boîte de dialogue Enregistrer qui fournit des fonctionnalités d’interface utilisateur similaires à l’Explorateur Windows. Vous pouvez fournir une procédure de hook OFNHookProc pour une boîte de dialogue Enregistrer de style Explorateur. Pour activer la procédure de raccordement, définissez les indicateurs OFN_EXPLORER et OFN_ENABLEHOOK dans les indicateurs membre de la structure OPENFILENAME et spécifiez l’adresse de la procédure de raccordement dans le membre lpfnHook.

Windows continue de prendre en charge les anciennes boîtes de dialogue Enregistrer pour les applications qui souhaitent maintenir une interface utilisateur cohérente avec l’ancienne interface utilisateur. Pour afficher l’ancien style boîte de dialogue Enregistrer, activez une procédure de raccordement OFNHookProcOldStyle et vérifiez que l’indicateur de OFN_EXPLORER n’est pas défini.

Exemples

Pour obtenir un exemple, consultez Création d’un métafichier amélioré.

Note

L’en-tête commdlg.h définit GetSaveFileName comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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	commdlg.h (include Windows.h)
bibliothèque	Comdlg32.lib
DLL	Comdlg32.dll
ensemble d’API	ext-ms-win-shell-comdlg32-l1-1-1 (introduit dans Windows 10, version 10.0.14393)