QPx_FreeImporter

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

QPix © Escape
Generated by QDoc 2.8 on Wed, Feb 17, 2010 17:44:46