Vcl.Dialogs.PromptForFileName

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function PromptForFileName(var AFileName: string; const AFilter: string = ''; const ADefaultExt: string = ''; const ATitle: string = ''; const AInitialDir: string = ''; SaveDialog: Boolean = False): Boolean;

C++

extern DELPHI_PACKAGE bool __fastcall PromptForFileName(System::UnicodeString &AFileName, const System::UnicodeString AFilter = System::UnicodeString(), const System::UnicodeString ADefaultExt = System::UnicodeString(), const System::UnicodeString ATitle = System::UnicodeString(), const System::UnicodeString AInitialDir = System::UnicodeString(), bool SaveDialog = false);

Propriétés

Type Visibilité  Source Unité  Parent
function public
Vcl.Dialogs.pas
Vcl.Dialogs.hpp
Vcl.Dialogs Vcl.Dialogs

Description

Affiche un dialogue d'ouverture ou d'enregistrement, dans laquelle l'utilisateur peut indiquer un nom de fichier.

Appelez PromptForFileName pour afficher une boîte de dialogue d'ouverture ou d'enregistrement.

AFilename est le nom du fichier. La valeur fournie par l'utilisateur permet d'initialiser le nom du fichier dans la boîte de dialogue. A la fermeture, AFileName contient le nom spécifié dans la boîte de dialogue.

AFilter définit les masques de fichiers (filtres) disponibles dans la boîte de dialogue. Si AFilter est une chaîne vide, la boîte de dialogue utilise la chaîne 'Tous les fichiers (*.*)', qui force la boîte de dialogue à afficher tous les fichiers du répertoire en cours. Pour plus d'informations sur les chaînes de filtre, voir Filter.

ADefaultExt spécifie une extension de fichier à ajouter automatiquement au nom de fichier spécifié, si celui-ci n'inclut pas déjà d'extension recensée. Si l'utilisateur indique un nom de fichier avec une extension qui n'est pas recensée, ADefaultExt est ajoutée à l'extension non recensée.

ATitle indique le titre de la boîte de dialogue. Si ATitle est une chaîne vide, la boîte de dialogue utilise 'Ouvrir' ou 'Enregistrer sous', en fonction de la valeur du paramètre SaveDialog.

AInitialDir indique le répertoire affiché à l'ouverture de la boîte de dialogue. Si AInitialDir est une chaîne vide ou si le répertoire spécifié n'existe pas, le répertoire initial est le répertoire de travail en cours.

SaveDialog indique si la boîte de dialogue de sélection de fichier doit être une boîte de dialogue Enregistrer sous (true) ou Ouvrir (false).

Options spécifie les options de la boîte de dialogue de sélection de fichier.

PromptForFileName renvoie true si l'utilisateur a sélectionné un nom de fichier, false si l'utilisateur a fermé la boîte de dialogue en cliquant sur le bouton Annuler.

Voir aussi