4D Doc Center : READ PICTURE FILE

4D v13.4

READ PICTURE FILE


READ PICTURE FILE ( nomeArquivo ; imagem {; *} )

Parâmetro	Tipo	Descrição
nomeArquivo	cadeia	Nome ou rota completa do arquivo a ser lido, ou string vazio
imagem	Imagem	Campo ou variável que recebe a imagem
*	Operador	Se passado = aceitar qualquer tipo de arquivo

Descrição

O comando READ PICTURE FILE permite abrir a imagem guardada no arquivo do disco nomeArquivo e carregá-la no campo ou variável 4D imagem.

Pode passar em nomeArquivo a rota de acesso completa do arquivo a ler, ou unicamente o nome do arquivo. Se só passa o nome do arquivo, o arquivo será localizado junto ao arquivo de estrutura do banco. Em Windows, igualmente deve indicar a extensão do arquivo.

Se passa uma cadeia vazia ("") em nomeArquivo, aparece a caixa de diálogo padrão de abertura de arquivos, permitindo ao usuário selecionar o arquivo a ser lido, assim como os formatos disponíveis.

Pode obter a lista de formatos disponíveis com a ajuda do comando PICTURE CODEC LIST.

Passe em imagem a variável ou o campo imagem que deva receber a imagem lida.

Nota: o formato interno da imagem se armazena dentro da variável ou campo 4D. No caso de formatos personalizados que utilizam QuickTime, será necessário dispor de QuickTime para mostrar a imagem dentro de 4D.

Se passar o parâmetro opcional *, o comando aceitará qualquer tipo de arquivo. Isso significa que você pode trabalhar com imagens sem necessariamente ter os codecs adequados (ver a descrição do comando BLOB TO PICTURE).

Variáveis e conjuntos do sistema

Se a execução do comando é correta, a variável sistema Document contém a rota de acesso completa ao arquivo aberto e a variável sistema OK toma o valor 1. Do contrário, OK toma o valor 0.