User Tools

Site Tools


api:dk11:java:tatukgis.jdk.tgis_layervector.getfieldex_tgis_uid_string

Table of Contents

TGIS_LayerVector.GetFieldEx method

DK for Java | tatukgis.jdk.TGIS_LayerVector.GetFieldEx | Constructors | Fields | Methods | Properties | Events

Retrieves an attribute field value for a shape by unique identifier, preserving Null and Empty values unchanged.

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

Syntax

// Java
public Variant GetFieldEx(
  long _uid,
  java.lang.String _name
);
// Oxygene
public
  function GetFieldEx(
    _uid : TGIS_Uid;
    _name : String
  ) : Variant; virtual;

Parameters

Name Type Description
_uid long
TGIS_Uid
Unique identifier of the shape. Returns Unassigned if the UID is not found in the layer.
_name java.lang.String
String
Field name from the layer Fields collection. Field lookup is case-insensitive.

Result

Type Description
Variant Field value as Variant. If the stored value is Null or Empty, the method returns that value without applying the field-type default. If the UID is not found, the result is Unassigned.

Remarks

PURPOSE: Provides raw attribute access when application logic must distinguish Null or Empty from ordinary values such as 0 or an empty string. This is useful in database-backed vector layers and null-aware attribute processing.

BEHAVIOR: Retrieves the shape by UID if needed and reads the requested field value unchanged. Unlike GetField, no default substitution is performed for Null or Empty values.

CONSTRAINTS: If the UID is not found, the method returns Unassigned.

2026/09/20 23:58

Page Tools