GET PICTURE RESOURCE
GET PICTURE RESOURCE ( resNum ; resDados {; resArquivo} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| resNum | Integer | → | Número de Resource |
| resDados | Field, Variable | → | Campo imagem ou variável a receber a imagem |
| ← | Conteúdos do recurso PICT | ||
| resArquivo | Time | → | Número de referência do arquivo de Resource ou arquivo de resource atual se omitido |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando GET PICTURE RESOURCE retorna no campo ou na variável resDados a imagem guardada no recurso imagem (“PICT”) cujo número se passa em resNum.
Se o recurso não se encontra, o parâmetro resDados não se modifica e a variável OK toma o valor 0 (zero).
Se passa um número de referência de arquivo de recursos válido em resArquivo, o recurso se busca nesse arquivo unicamente. Se não passa resArquivo, se retorna a primeira ocorrência do recurso encontrado na cadeia de arquivos de recursos.
Nota: o tamanho de um recurso imagem pode ser de vários megabytes.
Exemplo
Ver o exemplo do comando RESOURCE LIST.
Variáveis e conjuntos do sistema
A variável sistema OK toma o valor 1 se for encontrado o recurso, do contrário toma o valor 0 (zero).
Gestão de erros
Se não houver memória suficiente para carregar a imagem, um erro é gerado. Pode interromper esse erro com a ajuda de um método de gestão de erros instalado pelo comando ON ERR CALL.