api:dk11:delphi:gislayerpixel.tgis_layerpixel.lockpixels_trect_tgis_extent_integer_integer_integer_boolean
Table of Contents
TGIS_LayerPixel.LockPixels(TRect; TGIS_Extent; Integer; Integer; Integer; Boolean) method
DK11 for Delphi | GisLayerPixel.TGIS_LayerPixel.LockPixels | Overloads | Constructors | Fields | Methods | Properties | Events
Locks a fragment of the pixel layer for updating.
Syntax
// Delphi public function LockPixels( const _rct : TRect; const _ext : TGIS_Extent; const _tilelevel : Integer; const _tilerow : Integer; const _tilecolumn : Integer; const _writable : Boolean ) : TGIS_LayerPixelLock; overload; virtual;
// C++ Builder public: virtual TGIS_LayerPixelLock* LockPixels( TRect* const _rct, TGIS_Extent* const _ext, const int _tilelevel, const int _tilerow, const int _tilecolumn, const bool _writable ) /* overload */;
Parameters
| Name | Type | Description |
|---|---|---|
| _rct | TRect | rectangle on raster to be locked; if bigger then raster size then will be truncated |
| _ext | TGIS_Extent | area to be locked; if bigger then layer extent then will be truncated to layer extent |
| _tilelevel | Integer | tile level |
| _tilerow | Integer | tile row |
| _tilecolumn | Integer | tile column |
| _writable | Boolean | if true than layer will post back any changes in locked area; if write is not possible then TGIS_LayerPixelLock.Writable will be set accordingly |
Result
| Type | Description |
|---|---|
| TGIS_LayerPixelLock | locked area |
Remarks
Must be paired with UnlockPixels.
To speed-up operation, the function can return a larger area than requested. Use Bounds property of result value to obtain actual scope.
References
2023/02/22 01:15