QPix Command Reference
![]() |
![]() ![]() |
QPx_FreeImporter(importerRef):error | |||
![]() |
importerRef | Longint | Reference to the importer instance to be destroyed |
![]() |
error | Longint | Error result |
Destroys an existing importer instance and releases all memory allocated to it.
The importer instance to be destroyed is passed in importerRef.
As a rule, you should use this command after you have finished working with a graphics importer instance that was created with one of the importer creation commands (QPx_NewImporterForFile, QPx_NewImporterForData, QPx_NewImporter).
Attention: The only exception is when the importer instance was assigned to a QPix plug-in area with the QPx_SetAreaImporter command. In this case the importer instance is "owned" by the plug-in area and it will be freed when the area is destroyed by 4D or when another command changes the area content.
Example
`Free the importer C_LONGINT($error) C_LONGINT(gQPixImporter) $error:=QPx_FreeImporter (gQPixImporter) If ($error#qpx_noErr) `Handle the error End if |
Related commands
QPx_NewImporter | Creates a graphics importer instance |
QPx_NewImporterForFile | Creates a graphics importer instance for the image stored in a file |
QPx_NewImporterForData | Creates a graphics importer instance for the image data stored in a BLOB |
QPx_NewImporterForURL | Creates a graphics importer from a URL |
QPx_NewImporterForPict | Creates a graphics importer instance for the image data stored in a BLOB |
QPx_SetAreaImporter | Assigns a graphics importer instance to a QPix plug-in area |