User Tools

Site Tools


api:dk11:net:tatukgis.ndk.tgis_layervector.build_string_tgis_extent_tgis_shapetype

TGIS_LayerVector.Build(string, TGIS_Extent, TGIS_ShapeType) method

DK for .NET | TatukGIS.NDK.TGIS_LayerVector.Build | Overloads | Constructors | Fields | Methods | Properties | Events

Create and initialize layer storage with the specified shape type and extent using the layer default dimensionality.

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

Syntax

// C#
public virtual void Build(
  string _path,
  TGIS_Extent _extent,
  TGIS_ShapeType _type
);
' VisualBasic
Public Overridable Sub Build(
  ByVal _path As String,
  ByVal _extent As TGIS_Extent,
  ByVal _type As TGIS_ShapeType
)
// Oxygene
public
  procedure Build(
    _path : String;
    _extent : TGIS_Extent;
    _type : TGIS_ShapeType
  ); virtual;

Parameters

Name Type Description
_path string
String
Storage location as a file path for file-based layers or a connection string for SQL (Structured Query Language)-based layers.
_extent TGIS_Extent Initial bounding extent for the layer. It must be non-zero sized.
_type TGIS_ShapeType Shape geometry type supported by the layer.

Remarks

PURPOSE: Prepare persistent storage for a new vector layer when the shape geometry type must be defined at creation time.

BEHAVIOR: Creates the underlying storage required by the concrete layer type, such as files for file-based formats or database objects for SQL-backed layers. The layer is initialized to accept only the specified shape type and uses the default coordinate dimensionality for stored shapes.

CONSTRAINTS: Supported storage objects depend on the descendant layer implementation. The path or connection target must be writable, the extent must be valid, and read-only layer types can reject this operation.

Example

Here is a simple procedure to add a new layer to the viewer.

References

2026/07/11 01:06

Page Tools