api:dk11:delphi:gislayervector.tgis_shape.join_tgis_shape_boolean
Table of Contents
TGIS_Shape.Join(TGIS_Shape; Boolean) method
DK for Delphi | GisLayerVector.TGIS_Shape.Join | Overloads | Constructors | Fields | Methods | Properties
Joins this shape with another shape, either in place or by creating a new result shape.
Syntax
// Delphi public function Join( const _shape : TGIS_Shape; const _returnnewobj : Boolean ) : TGIS_Shape; overload;
// C++ Builder public: TGIS_Shape* Join( TGIS_Shape* const _shape, const bool _returnnewobj ) /* overload */;
Parameters
| Name | Type | Description |
|---|---|---|
| _shape | TGIS_Shape | Shape to append to this shape. |
| _returnnewobj | Boolean | If True, returns a new joined shape and leaves this shape unchanged; if False, modifies this shape and returns it. |
Result
| Type | Description |
|---|---|
| TGIS_Shape | The joined shape, either as a new object or as the modified source shape, depending on _returnnewobj. |
Remarks
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.
2026/07/11 00:38