ShowFilePicker

<< Clique para Mostrar o Sumário >>

 

ShowFilePicker

ShowFilePicker(Open, Filename, [Extension], [Flags], [Filter])

Exibe as caixas de diálogo Salvar e Abrir Arquivo do Windows. O parâmetro Open indica o tipo de caixa de diálogo a ser aberta. Se Verdadeiro, abre a caixa de diálogo Abrir Arquivo. Se Falso, abre a caixa de diálogo Salvar. O parâmetro FileName indica a variável onde é armazenado o nome do arquivo a ser salvo ou carregado, caso o método retorne Verdadeiro. Este parâmetro deve ser obrigatoriamente uma variável. O parâmetro Extension é opcional e informa a extensão do arquivo padrão a ser anexada ao nome do arquivo na caixa de entrada, quando a extensão não é informada. Caso seja omitido ou seja uma String vazia, nenhuma extensão é concatenada ao final do nome do arquivo. Extensões múltiplas podem ser especificadas usando-se o caractere de ponto e vírgula como delimitador. A String deve terminar com barras duplas verticais (||).

O parâmetro Flags é opcional e define o comportamento da caixa de diálogo. É um número inteiro correspondendo à soma dos valores da tabela a seguir. Se omitido, assume o valor 2 (dois, FILEMUSTEXIST). O parâmetro Filter é opcional e define um conjunto de pares de Strings que especificam filtros que podem ser aplicados aos arquivos. A primeira String descreve o filtro e a segunda String indica o tipo de extensão a ser utilizada. Se omitido, nenhum filtro é aplicado aos arquivos.

Combinações possíveis para o parâmetro Flags

Valor

Descrição

1

CREATEPROMPT: Se o usuário especificar um arquivo que não existe, este flag permite que seja questionado sobre a criação do arquivo. Ao selecionar criar o arquivo, a caixa de diálogo é fechada e o nome do arquivo é retornado no parâmetro Filename. Caso contrário, a caixa de diálogo permanece aberta

2

FILEMUSTEXIST: Especifica que o usuário só pode digitar nomes de arquivos existentes. Caso contrário, a caixa de diálogo mostra um aviso na caixa de mensagens

4

NOCHANGEDIR: Recupera o diretório atual para o valor original, caso o usuário tenha mudado de diretório enquanto buscava o arquivo

8

NODEREFERENCELINKS: Configura a caixa de diálogo para retornar o arquivo de atalho (.lnk) selecionado. Se este flag não é especificado, a caixa de diálogo retorna o caminho e nome de arquivo referenciados pelo arquivo de atalho

16

NOREADONLYRETURN: Determina que o arquivo retornado não seja somente para leitura, e o diretório não é protegido contra gravação

32

PATHMUSTEXIST: Especifica que o usuário pode informar apenas arquivos e diretórios válidos, caso contrário uma caixa de mensagem é mostrada para avisar o usuário

64

READONLY: Permite que a opção Somente Leitura seja selecionada inicialmente quando a caixa de diálogo é criada

128

OVERWRITEPROMPT: Permite que a caixa de diálogo Salvar Como gere uma mensagem informando da existência do arquivo, e pede confirmação para sobrescrever este arquivo

 

O código a seguir contém um exemplo de filtro para este método.

"Arquivos de Chart (*.xlc)|*.xlc|Planilhas Excel (*.xls)_
  |*.xls|Arquivos de Dados (*.xlc;*.xls)|*.xlc; *.xls
  |Todos os arquivos (*.*)|*.*||"

Esta página foi útil?