QPix Command Reference Graphics Importers

QPx_GetAreaImporter

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

Returns a reference to the graphic importer instance used internally by a QPix plug-in area.

This is a low-level command. It gives access to the area characteristics and data through the QPix Graphics Importer API. If you modify the importer's drawing characteristics, you must call QPx_RedrawArea(area;qpx_UpdateBuffers) for changes to be reflected in the QPix plug-in area.

The plug-in area is referenced by areaRef. If areaRef is not a valid QPix plug-in area reference or if it is not currently using a graphics importer instance, qpx_paramErr error is returned.

Example

  `Get the area importer
 
C_LONGINT($error)
C_LONGINT($areaImporter)
 
$error:=QPx_GetAreaImporter (gQPixArea;$areaImporter)
 
If ($error=qpx_noErr)
 
   `$areaImporter is the importer used internally by gQPixArea
 
End if

Related commands

QPx_RedrawArea Redraws a QPix area
QPx_SetAreaImporter Assigns a graphics importer instance to a QPix plug-in area

QPix © Escape Information Services
Generated by QDoc 2.6 on Thu, 2 May 2002 00:50:06 +0300