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