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

IRasterCatalogRendererPicker Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Carto > ESRI.ArcGIS.Carto > Interfaces > IR > IRasterCatalogRendererPicker Interface
ArcGIS Developer Help

IRasterCatalogRendererPicker Interface

Provides access to methods that choose appropriate raster renderers for a RasterCatalog.

Product Availability

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


The IRasterCatalogRendererPicker interface controls the raster renderer picking rules used to control the default display of a geodatabase raster catalog layer.

The AllAvailableRenderersCLSID property returns an array of ProgIDs of all the available renderers that are associated with the raster catalog layer. An example of ProgID is ´┐ŻesriCarto.RasterRGBRenderer´┐Ż for the RasterRGBRenderer object.

The DefaultUseRenderersCLSID , a read only property, returns an array of ProgIDs of the raster renderers that are used in rendering the raster catalog layer.

The Pick method sets the rules for rendering raster datasets in a raster catalog. This is where you can apply your own rendering rules. Based on the property of the input raster dataset, you need to return a renderer from the available renderers.

The Priority property returns the priority of this raster catalog renderer picker relative to others in the system. The priority of the system default RasterCatalogRendererPickerDefault object is 0.

To create a custom raster catalog renderer picker object; implement this interface, assign a higher number to the Priority, then register this object with RasterCatalogRendererPickers component category.

The raster catalog renderer picker objects registered in the system are called with decreasing priority until a valid picker is found. For raster datasets in the raster catalog that you wish to use the system default picker, return Null instead of a valid renderer. If no renderer is returned from this raster catalog renderer picker, the raster dataset will be passed to the next highest priority renderer picker object until a renderer is found.


Name Description
Read-only property AllAvailableRenderersCLSID The ProgIDs of all available raster renderers.
Read-only property DefaultUseRenderersCLSID The ProgIDs of the default raster renderers.
Method Pick Chooses the renderers from a given list.
Read-only property Priority The priority of the renderer.

Classes that implement IRasterCatalogRendererPicker

Classes Description
RasterCatalogRendererPickerDefault A chooser for picking raster renderer for a raster catalog.

See Also

RasterCatalogRendererPickerDefault Class