DK for ActiveX | TatukGIS_XDK11.ITGIS_Shape.Join_2 | Methods | Properties
Joins this shape with another shape, either in place or by creating a new result shape.
// C# public ITGIS_Shape Join_2( ITGIS_Shape _shape, WordBool _returnnewobj );
' VisualBasic Public Function Join_2( ByVal _shape As ITGIS_Shape, ByVal _returnnewobj As WordBool ) As ITGIS_Shape
// Oxygene public function Join_2( _shape : ITGIS_Shape; _returnnewobj : WordBool ) : ITGIS_Shape;
| Name | Type | Description |
|---|---|---|
| _shape | ITGIS_Shape | Shape to append to this shape. |
| _returnnewobj | WordBool | If True, returns a new joined shape and leaves this shape unchanged; if False, modifies this shape and returns it. |
| Type | Description |
|---|---|
| ITGIS_Shape | The joined shape, either as a new object or as the modified source shape, depending on _returnnewobj. |
PURPOSE: Combines compatible vector geometries while allowing the caller to choose between safe copy semantics and in-place modification.
BEHAVIOR: Performs the same geometry join operation as the overload without the ownership flag. When _returnnewobj is False, this shape is updated and returned.
CONSTRAINTS: Not applicable to TGIS_ShapePoint. Ownership of the result depends on _returnnewobj.