QPx_SetAreaImporter

QPx_SetAreaImporter(areaRef; areaRef):error
areaRef Longint QPix area reference
importerRef Longint Reference to the importer to be used by the area
error Longint Error result

Assign a graphics importer instance to a QPix area

The graphics importer reference importerRef must be a valid importer instance created with one of the importer creation commands (QPx_NewImporterForFile, QPx_NewImporterForData, QPx_NewImporter).

If the importer instance is succesfully assigned, the area takes its ownership. This means that you don't have to call QPx_FreeImporter to destroy the importer instance; it will be freed up when the area is destroyed by 4D or when another command changes the area's content.

NOTE This is a low-level command that also belongs to QPix's Graphics Importer commands.

Example

   // Assign an importer to a QPix area

C_LONGINT($error)

C_LONGINT(gQPixImporter)

$error:=QPx_SetAreaImporter (gQPixArea;gQPixImporter)

If ($error#qpx_noErr)
   
      // Handle the error
   
End if 

Related commands

QPx_GetAreaImporter Get a reference to the graphic importer used by a QPix area