4D v16.3

GET PICTURE RESOURCE

Home

 
4D v16.3
GET PICTURE RESOURCE

GET PICTURE RESOURCE 


 

GET PICTURE RESOURCE ( resID ; resData {; resFile} ) 
Parameter Type   Description
resID  Longint in Resource ID number
resData  Field, Variable in Picture field or variable to receive the picture
in Contents of the PICT resource
resFile  DocRef in Resource file reference number, or all open resource files, if omitted

The GET PICTURE RESOURCE command returns in the picture field or variable resData the picture stored in the picture (“PICT”) resource whose ID is passed in resID.

If the resource is not found, the resData parameter is left unchanged, and the OK variable is set to 0 (zero).

If you pass a valid resource file reference number in resFile, the resource is searched for in that file only. If you do not pass resFile, the first occurrence of the resource found in the resource files chain is returned.

Note: A picture resource can be at least several megabytes in size.

Example  

See example for the RESOURCE LIST command.

If the resource is found, OK is set to 1. Otherwise, it is set to 0 (zero).

If there is not enough memory to load the picture, an error is generated. You can catch this error with an error-handling method installed using ON ERR CALL.



See also 

_o_SET PICTURE RESOURCE
GET ICON RESOURCE
ON ERR CALL

 
PROPERTIES 

Product: 4D
Theme: Resources
Number: 502

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

 
HISTORY 

Created: 4D v6

 
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)