READ PICTURE FILE
READ PICTURE FILE ( nomeArquivo ; imagem {; *} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| nomeArquivo | Text | → | Nome ou rota completa do arquivo a ser lido, ou string vazio |
| imagem | Picture | ← | 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.
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.
Ver também
BLOB TO PICTURE
Imagens
PICTURE CODEC LIST
WRITE PICTURE FILE
Propriedades
| Número do comando | 678 |
| Thread-seguro | ✓ |
| Modificar variáveis | OK, Document |