GET PICTURE RESOURCE

4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next

version 6.0


GET PICTURE RESOURCE (resID; resData{; resFile})

ParameterTypeDescription
resIDNumberResource ID number
resDataField or VariablePicture field or variable to receive the picture
Contents of the PICT resource
resFileDocRefResource file reference number, or
all open resource files, if omitted

Description

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 command RESOURCE LIST.


See Also

GET ICON RESOURCE, ON ERR CALL, SET PICTURE RESOURCE.

System Variables and Sets

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

Error Handling

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.


4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next