4D v16.3

GET PICTURE FROM LIBRARY

Home

 
4D v16.3
GET PICTURE FROM LIBRARY

GET PICTURE FROM LIBRARY 


 

GET PICTURE FROM LIBRARY ( picRef | picName ; picture ) 
Parameter Type   Description
picRef | picName  Longint, String in Reference number of Picture Library graphic or Name of Picture Library graphic
picture  Picture variable in Picture from the Picture Library

The GET PICTURE FROM LIBRARY command returns in the picture parameter the Picture Library graphic whose reference number is passed in picRef or whose name is passed in picName.

If there is no picture with that reference number or name, GET PICTURE FROM LIBRARY leaves picture unchanged.

The following example returns in vgMyPicture the picture whose reference number is stored in the local variable $vlPicRef:

 GET PICTURE FROM LIBRARY($vlPicRef;vgMyPicture)

The following example returns in $DDcom_Prot_MyPicture the picture with the name "DDcom_Prot_Button1" stored in the Picture Library:

 GET PICTURE FROM LIBRARY("DDcom_Prot_Button1";$DDcom_Prot_MyPicture)

See the third example for the PICTURE LIBRARY LIST command.

If the Picture Library exists, the OK variable is set to 1. Otherwise, OK is set to zero.

If there is not enough memory to return the picture, an error -108 is generated. You can catch this error using an error-handling method.



See also 

PICTURE LIBRARY LIST
REMOVE PICTURE FROM LIBRARY
SET PICTURE TO LIBRARY

 
PROPERTIES 

Product: 4D
Theme: Pictures
Number: 565

The OK variable is changed by the commandThis command modifies the Error system variable

 
HISTORY 

Modified: 4D v6.7

 
ARTICLE USAGE

4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)