api:dk11:activex:tatukgis_xdk11.itgis_layerpixel.locateex_itgis_point_itgis_color_itgis_doublearray_wordbool_double
Table of Contents
ITGIS_LayerPixel.LocateEx method
DK for ActiveX | TatukGIS_XDK11.ITGIS_LayerPixel.LocateEx | Methods | Properties
If a given point is located within the image area, returns True and sets output values.
Syntax
// C# public WordBool LocateEx( ITGIS_Point _ptg, ref ITGIS_Color _rgbMapped, ref ITGIS_DoubleArray _nativesVals, ref WordBool _transparency, double _pixelsize );
' VisualBasic Public Function LocateEx( ByVal _ptg As ITGIS_Point, ByRef _rgbMapped As ITGIS_Color, ByRef _nativesVals As ITGIS_DoubleArray, ByRef _transparency As WordBool, ByVal _pixelsize As Double ) As WordBool
// Oxygene public function LocateEx( _ptg : ITGIS_Point; var _rgbMapped : ITGIS_Color; var _nativesVals : ITGIS_DoubleArray; var _transparency : WordBool; _pixelsize : Double ) : WordBool;
Parameters
| Name | Type | Description |
|---|---|---|
| _ptg | ITGIS_Point | reference point to query; if the layer is attached to the viewer, _ptg is expected in viewer coordinate space, otherwise in layer coordinate space |
| _rgbMapped | ITGIS_Color | color at _ptg after mapping; if no mapping is applied, this is derived directly from _nativesVals |
| _nativesVals | ITGIS_DoubleArray | dynamic array of Double values with original band values at _ptg (for example Red, Green, Blue); Length(_nativesVals) equals the number of bands |
| _transparency | WordBool | set to True if the point is transparent |
| _pixelsize | double Double | requested image pixel size; if 0, the current viewer scale is used to calculate an optimal pixel size; >0 means map units, <0 means layer units |
Result
| Type | Description |
|---|---|
| WordBool | True if the point is located successfully. |
Remarks
If _pixelsize=0, this method has the same meaning as Locate().
2026/07/11 00:11