GET PICTURE RESOURCE
GET PICTURE RESOURCE ( resNum ; resDatos {; resArchivo} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| resNum | Entero largo | 🡒 | Número de recurso |
| resDatos | Campo, Variable | 🡒 | Campo o variable imagen a recibir la imagen |
| 🡘 | Contenido del recurso PICT | ||
| resArchivo | DocRef | 🡒 | Número de referencia del archivo de recursos o todos los archivos de recursos abiertos, si se omite |
Descripción
El comando GET PICTURE RESOURCE devuelve en el campo o en la variable resDatos la imagen guardada en el recurso imagen (“PICT”) cuyo número se pasa en resNum.
Si el recurso no se encuentra, el parámetro resDatos no se modifica y la variable OK toma el valor 0 (cero).
Si pasa un número de referencia de archivo de recursos válido en resArchivo, el recurso se busca en ese archivo únicamente. Si no pasa resArchivo, se devuelve la primera ocurrencia del recurso encontrado en la cadena de archivos de recursos.
Nota: el tamaño de un recurso imagen puede ser de varios megabytes.
Ejemplo
Ver el ejemplo del comando RESOURCE LIST.
Variables y conjuntos del sistema
La variable sistema OK toma el valor 1 si se encuentra el recurso, de lo contrario toma el valor 0 (cero).
Gestión de errores
Si no hay suficiente memoria para cargar la imagen, se genera un error. Puede interceptar este error con la ayuda de un método de gestión de errores instalado por el comando ON ERR CALL.