ITGIS_Shape.Within method

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

Tests whether this shape is within another shape using the DE-9IM (Dimensionally Extended 9-Intersection Model) topology relation. Opposite of Contains.

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

// C#
public WordBool Within(
  ITGIS_Shape _shape
);

' VisualBasic
Public Function Within(
  ByVal _shape As ITGIS_Shape
) As WordBool

// Oxygene
public
  function Within(
    _shape : ITGIS_Shape
  ) : WordBool;

PURPOSE: Test spatial containment for cases such as point-in-polygon checks, feature-in-region filtering, and administrative boundary lookup.

BEHAVIOR: Evaluates whether this shape is spatially inside _shape using the DE-9IM relation. It is the inverse relation of Contains.

CONSTRAINTS: Both shapes must have valid geometry. Boundary handling follows the underlying DE-9IM implementation and may differ from simpler point-in-area expectations.