Important: The information in this document is obsolete and should not be used for new development.
GetPicture
Use theGetPicture
function to get a handle to a picture stored in a'PICT'
resource.
FUNCTION GetPicture (picID: Integer): PicHandle;
picID
- The resource ID for a
'PICT'
resource.DESCRIPTION
TheGetPicture
function returns a handle to the picture stored in the'PICT'
resource with the ID that you specify in thepicID
parameter. You can pass this handle to theDrawPicture
procedure (described on page 7-43) to draw the picture stored in the resource.The
GetPicture
function calls the Resource Manager procedureGetResource
as follows:
GetResource('PICT',picID)If the resource can't be read,GetPicture
returnsNIL
.SPECIAL CONSIDERATIONS
To release the memory occupied by a picture stored in a'PICT'
resource, use the Resource Manager procedureReleaseResource
.The
GetPicture
function may move or purge memory.SEE ALSO
TheGetResource
andReleaseResource
procedures are described in the chapter "Resource Manager" in Inside Macintosh: More Macintosh Toolbox. The'PICT'
resource is described on page 7-66.