GET PICTURE FROM LIBRARY
GET PICTURE FROM LIBRARY ( refImage | nomImage ; image )
| Paramètre | Type | Description | |
|---|---|---|---|
| refImage | nomImage | Entier long, Chaîne | → | Numéro de référence ou Nom d'une image de la bibliothèque d’images |
| image | Picture | ← | Image de la bibliothèque d'images |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande GET PICTURE FROM LIBRARY retourne dans image l'image de la bibliothèque dont vous avez passé le numéro de référence dans refImage ou le nom dans nomImage.
S'il n'existe pas d'image de ce numéro ou de ce nom dans la bibliothèque d'images, GET PICTURE FROM LIBRARY ne modifie pas le paramètre image.
Exemple 1
L’exemple suivant retourne dans la variable vgMonImage l’image dont la référence est stockée dans la variable locale $vlRefImage :
GET PICTURE FROM LIBRARY($vlRefImage;vgMonImage)
Exemple 2
L’exemple suivant retourne dans la variable $DDcom_Prot_MonImage l’image nommée "DDcom_Prot_Bouton1" stockée dans la Bibliothèque d’images :
GET PICTURE FROM LIBRARY("DDcom_Prot_Bouton1";$DDcom_Prot_MonImage)
Exemple 3
Reportez-vous au troisième exemple de la commande PICTURE LIBRARY LIST.
Variables et ensembles système
La variable système OK prend la valeur 1 si l’image existe dans la bibliothèque d’images. Sinon, elle prend la valeur zéro.
Gestion des erreurs
S'il n'y a pas assez de mémoire pour retourner l’image, l'erreur –108 est générée. Vous pouvez intercepter cette erreur avec une méthode de gestion d'erreurs.
Voir aussi
PICTURE LIBRARY LIST
REMOVE PICTURE FROM LIBRARY
SET PICTURE TO LIBRARY