TGIS_RendererAbstract.CanvasNative method

DK11 for .NET | TatukGIS.NDK.TGIS_RendererAbstract.CanvasNative | Constructors | Fields | Methods | Properties

Return rendering context native to current renderer.

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

// C#
public virtual abstract TObject CanvasNative();

' VisualBasic
Public Overridable MustOverride Function CanvasNative() As TObject

// Oxygene
public
  function CanvasNative : TObject; virtual; abstract;

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