|
<< 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 (*.*)|*.*||"