ITGIS_Shape.PointOnShape method

DK for ActiveX | TatukGIS_XDK11.ITGIS_Shape.PointOnShape | Methods | Properties

Calculates a point guaranteed to lie on the shape geometry.

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

// C#
public ITGIS_Point PointOnShape();

' VisualBasic
Public Function PointOnShape() As ITGIS_Point

// Oxygene
public
  function PointOnShape : ITGIS_Point;

PURPOSE: Retrieve a point that is guaranteed to belong to the shape geometry, which is useful for anchor placement when a centroid might fall outside the feature.

BEHAVIOR: Returns a point on the actual shape geometry. Depending on the shape type and implementation, this may be a vertex, a point on an edge, or a point in the polygon interior.

CONSTRAINTS: The exact point chosen is implementation- dependent and should not be assumed to be optimal for cartographic label placement.