IRasterCatalogRendererPicker Interface

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

Product Availability

Description

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.

Members

	All Properties Methods	Description
	AllAvailableRenderersCLSID	The ProgIDs of all available raster renderers.
	DefaultUseRenderersCLSID	The ProgIDs of the default raster renderers.
	Pick	Chooses the renderers from a given list.
	Priority	The priority of the renderer.

CoClasses that implement IRasterCatalogRendererPicker