|
|
|
|
|
|
|
|
|
version 2003
PA_ReturnPictureHandle (params; hPicture; info)
| Parameter | Type | Description | |
| params | PA_Pluginparameters |  | Parameters received in PluginMain |
| hPicture | | Handle of the picture to be returned | |
| info | PA_PictureInfo | | Picture information (background) |
Description
The routine PA_ReturnPictureHandle sets the returned value of a plug-in function to hPicture, received by the calling the 4D method. It adds the regular background information passed in info.
This is useful in memory optimization. PA_ReturnPicture returns a copy of the original picture. This can be a problem if the picture is a large one. With PA_ReturnPictureHandle, simply return a handle to the BLOB.
WARNING
After the call the handle belongs to 4D; never dispose of it.
See Create a new plug-in for a description of returned values accessors.
Example
MacOS to Windows+Altura. Set a returned picture to a picture loaded from a resource.
The 4D developer uses the syntax:
$aPicture:=plug-in_GetAPicture
Handle h = GetResource('PICT', 15000);
DetachResource(h);
PA_ReturnPictureHandle(params, h);
// h is no more mine.
See Also
Create a new plugin, PA_ReturnPicture.
Error Handling
None.
|
|
|
|
|
|
|
|
|