GET PICTURE FROM LIBRARY
GET PICTURE FROM LIBRARY ( refImag | nomImag ; imagen )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| refImag | nomImag | Entero largo, Cadena | → | Número de referencia o nombre de una imagen de la librería de imágenes |
| imagen | Picture | ← | Imagen de la librería de imágenes |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando GET PICTURE FROM LIBRARY devuelve en el parámetro imagen la imagen de la librería de imágenes cuyo número de referencia se pasa en refImag o cuyo nombre se pasa en nomImag.
Si no hay una imagen con ese nombre o número de referencia, GET PICTURE FROM LIBRARY no modifica imagen.
Ejemplo 1
El siguiente ejemplo devuelve en vgMiImagen la imagen cuyo número de referencia se almacena en la variable local $vlRefImag:
GET PICTURE FROM LIBRARY($vlRefImag;vgMiImagen)
Ejemplo 2
El siguiente ejemplo devuelve en $DDcom_Prot_MiImagen la imagen con el nombre "DDcom_Prot_Boton1" almacenada en la librería de imágenes:
GET PICTURE FROM LIBRARY("XP - Aceptar";$XP_Aceptar)
Ejemplo 3
Ver el tercer ejemplo para el comando PICTURE LIBRARY LIST.
Variables y conjuntos del sistema
La variable sistema OK toma el valor 1 si la imagen existe en la librería de imágenes. De lo contrario, OK toma el valor cero.
Gestión de errores
Si no hay suficiente memoria para devolver la imagen, se genera el error -108. Puede interceptar este error utilizando un método de gestión de errores.
Ver también
PICTURE LIBRARY LIST
REMOVE PICTURE FROM LIBRARY
SET PICTURE TO LIBRARY