Objeto FileDialog (Office)

  • Artigo

Fornece funcionalidade de caixa de diálogo de arquivo semelhante à funcionalidade das caixas de diálogo padrão Abrir e Salvar encontradas nos aplicativos do Microsoft Office.

Comentários

Use a propriedade FileDialog para retornar um objeto FileDialog. A propriedade FileDialog está localizada no objeto de aplicativo de cada aplicativo individual do Office. A propriedade usa um único argumento, MsoFileDialogType, que determina o tipo de objeto FileDialog que a propriedade retorna. Há quatro tipos de objeto FileDialog:

  • Abrir a caixa de diálogo: permite que os usuários selecionem um ou mais arquivos que você pode abrir no aplicativo host usando o método Execute.

  • Caixa de diálogo SaveAs: permite que os usuários selecionem um único arquivo que você pode salvar o arquivo atual como usando o método Execute.

  • Caixa de diálogo Selecionador de arquivos: permite que os usuários selecionem um ou mais arquivos. Os caminhos de arquivo que o usuário seleciona são registrados no conjunto FileDialogSelectedItems.

  • Caixa de diálogo Selecionador de pasta: permite que os usuários selecionem um caminho. O caminho pelo qual o usuário seleciona é capturado no conjuntoFileDialogSelectedItems.

Cada aplicativo host só pode criar uma única instância do objeto FileDialog. Portanto, muitas das propriedades do objeto FileDialog persistem mesmo quando você criar vários objetos FileDialog. Portanto, certifique-se de que você defina todas as propriedades apropriadamente aos seus propósitos antes de exibir a caixa de diálogo.

Exemplo

Para exibir uma caixa de diálogo de arquivo usando o objeto FileDialog, você deve usar o método Show. Depois que uma caixa de diálogo é exibida, nenhum código é executado até que o usuário descarte a caixa de diálogo. O exemplo a seguir cria e exibe uma caixa de diálogo Selecionador de arquivo e, em seguida, exibe cada arquivo selecionado em uma caixa de mensagem.

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. 
 '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

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.