api:dk11:activex:tatukgis_xdk11.itgis_shape.difference_2_itgis_shape_wordbool
Table of Contents
ITGIS_Shape.Difference_2 method
DK for ActiveX | TatukGIS_XDK11.ITGIS_Shape.Difference_2 | Methods | Properties
Computes the difference between this shape and another shape, optionally returning a new object or modifying this shape.
Syntax
// C# public ITGIS_Shape Difference_2( ITGIS_Shape _shape, WordBool _returnnewobj );
' VisualBasic Public Function Difference_2( ByVal _shape As ITGIS_Shape, ByVal _returnnewobj As WordBool ) As ITGIS_Shape
// Oxygene public function Difference_2( _shape : ITGIS_Shape; _returnnewobj : WordBool ) : ITGIS_Shape;
Parameters
| Name | Type | Description |
|---|---|---|
| _shape | ITGIS_Shape | Shape to subtract from this shape. Must have valid geometry. |
| _returnnewobj | WordBool | If True, returns a newly created result shape. If False, updates this shape and returns the same instance. |
Result
| Type | Description |
|---|---|
| ITGIS_Shape | The difference result as either a new shape or this modified shape, depending on _returnnewobj. |
Remarks
PURPOSE: Perform a directional topology subtraction with control over result ownership and in-place modification behavior.
BEHAVIOR: Computes this shape minus _shape. If _returnnewobj is True, a new result shape is created. If False, this shape is replaced by the difference result.
CONSTRAINTS: The operation is not commutative. When _returnnewobj is False, the original geometry of this shape is overwritten. Ownership follows the declaration annotation.
2026/07/05 01:25