Propriedade FileDialog.InitialFileName (Office)
Define ou retorna uma cadeia de caracteres que representa o nome do caminho ou arquivo é inicialmente mostrado em uma caixa de diálogo de arquivo. Leitura/gravação.
Sintaxe
expressão. InitialFileName
expression Uma variável que representa um objeto FileDialog.
Comentários
Use os * caracteres curinga e ? ao especificar o nome do arquivo, mas não ao especificar o caminho. O símbolo * representa qualquer número de caracteres consecutivos e ? representa um único caractere. Por exemplo, . InitialFileName = "c:\c*s.txt" retorna "txt" e "checkregister. txt."
Se você especificar um caminho e nenhum nome de arquivo, todos os arquivos permitidos pelo filtro de arquivo aparecerão na caixa de diálogo.
Se você especificar um arquivo existente na pasta inicial, somente esse arquivo aparecerá na caixa de diálogo.
Se você especificar um nome de arquivo que não existe na pasta inicial, a caixa de diálogo não conterá arquivos. O tipo de arquivo que você especificar na propriedadeInitialFileName substitui as configurações de filtro do arquivo.
Se você especificar um caminho inválido, será adotado o último caminho usado. Uma mensagem alertará os usuários quando o caminho for inválido.
A definição desta propriedade como uma cadeia de caracteres com mais de 256 caracteres causará um erro em tempo de execução.
Exemplo
O exemplo a seguir exibe uma caixa de diálogo Selecionador de Arquivos usando o objeto FileDialog, e 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
'Set the initial path to the C:\ drive.
.InitialFileName = "C:\"
'Use the Show method to display the File Picker dialog box and return the user's action.
'If the user presses 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 "Selected item's path: " & vrtSelectedItem
Next vrtSelectedItem
'If the user presses 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.