cGetFile

Função: cGetFile

Apresenta uma janela com os diretórios disponíveis, na estação e no servidor,  e retorna o nome do item.

cGetFile ( [ cMascara], [ cTitulo], [ nMascpadrao], [ cDirinicial], [ lSalvar], [ nOpcoes], [ lArvore], [ lKeepCase] ) --> cRet

Nome	Tipo	Descrição	Obrigatório	Referência
cMascara	Caracter	Indica o nome do arquivo ou máscara.
cTitulo	Caracter	Indica o título da janela. Caso o parâmetro não seja especificado, o título padrão será apresentado.
nMascpadrao	Numérico	Indica o número da máscara.
cDirinicial	Caracter	Indica o diretório inicial.
lSalvar	Lógico	Indica se é um "save dialog" ou um "open dialog".
nOpcoes	Numérico	Indica a opção de funcionamento. Para mais informações das funcionalidades disponíveis, consulte a área Observações.
lArvore	Lógico	Indica se, verdadeiro (.T.), apresenta o árvore do servidor; caso contrário, falso (.F.).
lKeepCase	Lógico	Indica se, verdadeiro (.T.), mantém o case original; caso contrário, falso (.F.).

cRet

Retorna o nome do item. Caso nenhum item tenha sido selecionado, o retorna será uma string vazia.

Quando o parâmetro lArvore for verdadeiro (.T.) somente as pastas do rootpath do servidor serão acessíveis.

No parâmetro <nOpções>, é possível determinar as seguintes funcionalidades:

Comandos	Descrição
GETF_MULTISELECT (2)	Compatibilidade.
GETF_NOCHANGEDIR (4)	Não permite mudar o diretório inicial.
GETF_LOCALFLOPPY (8)	Apresenta a unidade do disquete da máquina local.
GETF_LOCALHARD (16)	Apresenta a unidade do disco local.
GETF_NETWORKDRIVE (32)	Apresenta as unidades da rede (mapeamento).
GETF_SHAREWARE (64)	Não implementado.
GETF_RETDIRECTORY (128)	Retorna/apresenta um diretório.
GETF_HIDDENDIR (256)*	Mostra arquivos e pastas ocultas
GETF_SYSDIR (512)*	Mostra arquivos e pastas do sistema

Se o cInitialDir apontar para um diretório oculto ou de sistema, lembre-se de habilitar as opções correspondentes.

* Os dois parâmetros só estão disponível em builds superiores a 7.00.131227A.

cMascara

Se não for informada uma máscara, o campo poderá ser editado pelo usuário a fim de especificar o filtro/máscara que desejar

Disponível apenas em builds superiores a 7.00.131227A.

cGetFile( '*.txt' , 'Textos (TXT)', 1, 'C:\', .F., nOR( GETF_LOCALHARD, GETF_LOCALFLOPPY, GETF_RETDIRECTORY ),.T., .T. )

Exemplo da função cGetFile()

Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server