GET PICTURE FROM LIBRARY

version 6.7 (Modified)

GET PICTURE FROM LIBRARY (picRef | picName; picture)

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.

Note for components developers: If you want a 4D component to use graphics stored in the Picture Library, you must pass a picture name as first parameter. Indeed, when a component requiring its own pictures is installed by 4D Insider, the application can renumber automatically these new pictures if some database pictures have already the same reference number.

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

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

   GET PICTURE FROM LIBRARY($vlPicRef;vgMyPicture)

2. 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)

3. See the third example for the command PICTURE LIBRARY LIST.

PICTURE LIBRARY LIST, REMOVE PICTURE FROM LIBRARY, SET PICTURE TO LIBRARY.

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.