ITGIS_RendererAbstract.CanvasNative method

DK11 for ActiveX | TatukGIS_XDK11.ITGIS_RendererAbstract.CanvasNative | Methods | Properties

Return rendering context native to current renderer.

Available also on: Delphi | .NET | Java | Python.

// C#
public ITBaseObject CanvasNative();

' VisualBasic
Public Function CanvasNative() As ITBaseObject

// Oxygene
public
  function CanvasNative : ITBaseObject;

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.

• CustomPaint sample