User Tools

Site Tools


api:dk11:delphi:gisrendererabstract.tgis_rendererabstract.canvasnative_void

Table of Contents

TGIS_RendererAbstract.CanvasNative method

DK11 for Delphi | GisRendererAbstract.TGIS_RendererAbstract.CanvasNative | Fields | Methods | Properties

Return rendering context native to current renderer.

Available also on: .NET | Java | ActiveX.

Syntax

// Delphi
public
  function CanvasNative : TObject; virtual; abstract;
// C++ Builder
public:
  virtual TObject* CanvasNative(void) = 0;

Result

Type Description
TObject Canvas object specific for current renderer object.

Remarks

Use of this function to access native API directly is not recommended. Please treat is last option if custom drawing can not be achieved in any other way. Using Canvas* methods like CanvasDrawLine is a recommend way to guarantee that same code will work on any renderer and on any supported operating system.

If you decide to use it anyway:

  • Plase verify that current renderer is really compatible with you code. For example CanvasNative for VCL.TGIS_RendererGdi32 and VCL.TGIS_RendererGdiPlus are representing different type of objects!
  • TatukGIS can not guarantee that context is always in a proper state.
  • Any direct use of this context potentially may require restoring bushes, fonts, and transformations for further proper operations.

References

2018/02/17 00:10