This document is archived and information here might be outdated.  Recommended version.

IRasterCursor Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Geodatabase > ESRI.ArcGIS.GeoDatabase > Interfaces > IR > IRasterCursor Interface
ArcGIS Developer Help

IRasterCursor Interface

Provides access to members that provide optimized raster access.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.


Name Description
Method Next Iterates to the next PixelBlock.
Read-only property PixelBlock The current PixelBlock.
Method Reset Return to state when first created.
Read-only property TopLeft The offset of the current PixelBlock.

Classes that implement IRasterCursor

Classes Description
RasterCursor (esriDataSourcesRaster) A raster cursor class.


The IRasterCursor interface controls enumeration through the PixelBlocks in a Raster. It is useful for rasters that are too large to be brought into memory at once.

The RasterCursor divides the Raster into blocks 128 pixels high that span the full width of the raster. Each successive PixelBlock is read 128 lines below the previous PixelBlock.

To create a RasterCursor, use the IRaster::CreateCursor or IRaster2::CreateCursorEx method.

See Also

IRaster Interface | IPixelBlock Interface | IPixelBlockCursor Interface