Diálogos GetOpenFileName / GetSaveFileName

A função GetOpenFileName constrói uma Caixa de Diálogo e permite que o usuário selecione a unidade, diretório e nome de um arquivo, ou conjunto de arquivos, a serem abertos. A função GetSaveFileName constrói uma Caixa de Diálogo e permite que o usuário informe a unidade, diretório e nome de um arquivo a ser gravado.

Ambas as funções devolvem o nome completo de um arquivo, inclusive o seu percurso completo, ou seja, unidade, pasta e sub-pasta onde ele se encontra ou onde ele vai ser gravado esse arquivo.

GetOpenFileName [(<expc1>, <expc2>, <expc3>)[,<expc4>]]

GetSaveFileName [(<expc1>, <expc2>, <expc3>)[,<expc4>]]

Onde:

Informa, opcionalmente, um nome de arquivo

Informa, opcionalmente, o nome do diretório onde reside o arquivo ou onde o mesmo vai ser gravado. Sendo <expc2> uma cadeia vazia (""), assume-se que foi informado o diretório corrente.

Informa, a maneira de filtro, os tipos de arquivos a abrir ou salvar. Esta informação é especificada em duas partes, aos pares, separadas por "/" (barra): a primeira parte contém a descrição e a segunda os tipos de arquivos. Podem ser especificados vários tipos de arquivos, separados por ";" (ponto e vírgula). Podem ser especificados vários pares, separados por "/" (barra).

Especifica, opcionalmente, o texto a ser mostrado no título da Caixa de Diálogo.

arq1=GetOpenFileName ("*.txt","","arquivos texto/*.txt")

arq1=GetOpenFileName ("*.txt","","arquivos texto/*.txt","Selecione o nome do arquivo …")

Nos exemplo acima:

• Vai ser apresentada uma caixa de diálogo, cujo título é: Selecione o nome do arquivo … , incluindo uma lista de todos os arquivos terminados em .txt residentes no diretório corrente.
• O usuário pode selecionar um dos arquivos da lista.
• A variável arq1 conterá o nome, inclusive com o percurso completo, do arquivo selecionado pelo usuário.

arq2=GetSaveFileName ("p.f","\dir\trab","fontes/*.f;*.fon/textos/*.txt")

No exemplo acima:

• Vai ser apresentada uma caixa de diálogo com o arquivo p.f, no diretório \dir\trab.
• O usuário pode selecionar o arquivo.
• A variável arq2 conterá o nome, inclusive com o percurso completo, do arquivo selecionado pelo usuário.

Ao final do tópico "Caixas de Diálogo de uso geral", apresentamos um exemplo com a utilização destes recursos.