Objet FileDialog (Office)FileDialog object (Office)

Cet objet fournit une fonctionnalité de boîte de dialogue de fichier similaire à la fonctionnalité des boîtes de dialogue standard Ouvrir et Enregistrer qui existent dans les applications Microsoft Office.Provides file dialog box functionality similar to the functionality of the standard Open and Save dialog boxes found in Microsoft Office applications.

RemarquesRemarks

Utilisez la propriétéFileDialog à renvoyer un objet FileDialog.Use the FileDialog property to return a FileDialog object. La propriété FileDialog se trouve dans chaque objet d’Application Office individuel.The FileDialog property is located in each individual Office application's Application object. La propriété prend un argument unique, DialogType, qui détermine le type d’objetFileDialog renvoie la propriété.The property takes a single argument, DialogType, that determines the type of FileDialog object that the property returns. Il existe quatre types d’objetFileDialog:There are four types of FileDialog object:

  • La boîte de dialogueOuvrir-permet aux utilisateurs de sélectionner un ou plusieurs fichiers que vous pouvez ensuite ouvrir dans l’application hôte à l’aide de la méthode Execute.Open dialog box: lets users select one or more files that you can then open in the host application by using the Execute method.

  • La boîte de dialogue Enregistrer sous-permet aux utilisateurs de sélectionner un seul fichier que vous pouvez ensuite enregistrer comme fichier en cours à l’aide de la méthode Execute.SaveAs dialog box: lets users select a single file that you can then save the current file as by using the Execute method.

  • La boîte de dialogueSélecteur de fichiers- permet aux utilisateurs de sélectionner un ou plusieurs fichier(s).File Picker dialog box: lets users select one or more files. Les chemins d’accès aux fichiers que l’utilisateur sélectionne sont capturés dans la collectionFileDialogSelectedItems.The file paths that the user selects are captured in the FileDialogSelectedItems collection.

  • La boîte de dialogueFolder Picker- permet aux utilisateurs de sélectionner un chemin d'accès.Folder Picker dialog box: lets users select a path. Le chemin d’accès aux fichiers que l’utilisateur sélectionne est capturé dans la collectionFileDialogSelectedItems.The path that the user selects is captured in the FileDialogSelectedItems collection.

Chaque application hôte peut uniquement créer une seule instance de l’objetFileDialog.Each host application can only create a single instance of the FileDialog object. Par conséquent, la plupart des propriétés de l’objetFileDialog sont conservées même lorsque vous créez plusieurs objetsFileDialog.Therefore, many of the properties of the FileDialog object persist even when you create multiple FileDialog objects. Par conséquent, assurez-vous que vous définissez toutes les propriétés appropriée pour votre objectif avant d’afficher la boîte de dialogue.Therefore, make sure that you set all of the properties appropriately for your purpose before you display the dialog box.

ExempleExample

Pour afficher une boîte de dialogue fichier à l’aide l’objetFileDialog, vous devez utiliser la méthodeafficher.To display a file dialog box by using the FileDialog object, you must use the Show method. Une fois qu’une boîte de dialogue s’affiche, aucun code ne s’exécute jusqu'à ce que l’utilisateur fasse disparaître la boîte de dialogue.After a dialog box is displayed, no code executes until the user dismisses the dialog box. L’exemple suivant affiche une boîte de dialogue File Picker et affiche chaque fichier sélectionné dans une zone de message.The following example creates and displays a File Picker dialog box, and then displays each selected file in a message box.

Sub Main() 
 
 'Declare a variable as a FileDialog object. 
 Dim fd As FileDialog 
 
 'Create a FileDialog object as a File Picker dialog box. 
 Set fd = Application.FileDialog(msoFileDialogFilePicker) 
 
 'Declare a variable to contain the path 
 'of each selected item. Even though the path is aString, 
 'the variable must be a Variant because For Each...Next 
 'routines only work with Variants and Objects. 
 Dim vrtSelectedItem As Variant 
 
 'Use a With...End With block to reference the FileDialog object. 
 With fd 
 
 'Use the Show method to display the File Picker dialog box and return the user's action. 
 'The user pressed the button. 
 If .Show = -1 Then 
 
 'Step through each string in the FileDialogSelectedItems collection. 
 For Each vrtSelectedItem In .SelectedItems 
 
 'vrtSelectedItem is aString that contains the path of each selected item. 
 'You can use any file I/O functions that you want to work with this path. 
 'This example displays the path in a message box. 
 MsgBox "The path is: " & vrtSelectedItem 
 
 Next vrtSelectedItem 
 'The user pressed Cancel. 
 Else 
 End If 
 End With 
 
 'Set the object variable to Nothing. 
 Set fd = Nothing 
 
End Sub

Voir aussiSee also

Assistance et commentairesSupport and feedback

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ?Have questions or feedback about Office VBA or this documentation? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.