Método Application.GetSaveAsFilename (Excel)

Exibe a caixa de diálogo Salvar como padrão e obtém um nome de arquivo do usuário sem realmente salvar nenhum arquivo.

Sintaxe

expressão.GetSaveAsFilename(InitialFilename, FileFilterFilterIndex, Title, ButtonText)

expressão Uma variável que representa um Aplicativo objeto.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
InitialFileName	Opcional	Variant	Especifica o nome de arquivo sugerido. Se este argumento for omitido, o Microsoft Excel usará o nome da pasta de trabalho ativa.
FileFilter	Opcional	Variantes	Uma sequência de caracteres que especifica os critérios de filtragem de arquivos. O comprimento máximo é de 255 caracteres, caso contrário, o método retornará o Erro 2015.
FilterIndex	Opcional	Variantes	Especifica o número de índice dos critérios de filtragem de arquivo padrão, de 1 para o número de filtros especificados no FileFilter. Se esse argumento for omitido ou for maior que o número de filtros presente, será usado o primeiro filtro de arquivos.
Title	Opcional	Variant	Especifica o título da caixa de diálogo. Se esse argumento for omitido, será usado o título padrão.
ButtonText	Opcional	Variantes	Apenas para Macintosh.

Valor de retorno

Variant

Comentários

Esta cadeia de caracteres passada no argumento FileFilter consiste em pares de cadeias de caracteres de filtros de arquivo seguidas da especificação de filtros de arquivo curinga do MS-DOS, com cada parte e cada par separados por vírgulas. Cada par separado está listado na caixa da lista suspensa Arquivos do tipo. Por exemplo, a cadeia de caracteres a seguir especifica dois filtros de arquivo: texto e suplemento:

"Text Files (*.txt), *.txt, Add-In Files (*.xla), *.xla"

Para usar múltiplas expressões curinga do MS-DOS para um tipo de filtro de arquivo simples, separe as expressões curinga com ponto-e-vírgula; por exemplo, "Visual Basic Files (*.bas; *.txt), *.bas;*.txt".

Esse método retorna o nome de arquivo selecionado ou o nome inserido pelo usuário. O nome retornado pode incluir uma especificação do caminho. Retorna False se o usuário cancelar a caixa de diálogo.

Este método pode alterar a unidade ou a pasta atual.

Quando o InitialFilename é usado com uma extensão e um filtro é aplicado, essa extensão deve corresponder à extensão do filtro; caso contrário, o InitialFilename efetivo exibido na caixa de diálogo será uma cadeia de caracteres vazia.

Exemplo

Este exemplo exibe a caixa de diálogo Salvar como, com o filtro de arquivo definido para arquivos de texto. Se o usuário escolhe um nome de arquivo, o exemplo exibe esse nome de arquivo em uma caixa de mensagem.

fileSaveName = Application.GetSaveAsFilename( _ 
 fileFilter:="Text Files (*.txt), *.txt") 
If fileSaveName <> False Then 
 MsgBox "Save as " & fileSaveName 
End If

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.