com.esri.arcgis.carto
Interface IRepresentationRenderer

All Superinterfaces:

Serializable

All Known Implementing Classes:

RepresentationRenderer

public interface IRepresentationRenderer
extends Serializable

Provides access to the properties and methods of a RepresentationRenderer.

Remarks

IRepresentationRenderer interface has properties useful for managing a RepresentationRenderer. A Representation Renderer is useful for displaying features using the representation information stored in any of its Representation Classes. RepresentationClass property can be used to set reference to a representation class or to make changes to an existing one.

Use this interface to reference the renderer to any available representation classes using RepresentationClass property so that all features are drawn with associated representation rules and any overriden attributes. Also, once the renderer renders all features, features having null rule values or invisible features may be managed using this interface.

InvalidRuleColor and InvisibleColor properties can be used to change colors and DrawInvalidRule and DrawInvisible properties can be used to control drawing of such feature representations.

The following piece of code shows how to get reference to a representation class using a feature layer in ArcMap which has been rendered using representation renderer.

Product Availability

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

Method Summary

IColor	getInvalidRuleColor() Color used for representations with an invalid rule ID.
IColor	getInvisibleColor() Color used for invisible representations.
IRepresentationClass	getRepresentationClass() Property RepresentationClass.
boolean	isDrawInvalidRule() Indicates if representations with an invalid Rule ID will draw.
boolean	isDrawInvisible() Indicates whether or not invisible representations will be drawn.
void	setDrawInvalidRule(boolean draw) Indicates if representations with an invalid Rule ID will draw.
void	setDrawInvisible(boolean draw) Indicates whether or not invisible representations will be drawn.
void	setInvalidRuleColor(IColor color) Color used for representations with an invalid rule ID.
void	setInvisibleColor(IColor color) Color used for invisible representations.
void	setRepresentationClassByRef(IRepresentationClass repClass) Property RepresentationClass.

Method Detail

setRepresentationClassByRef

void setRepresentationClassByRef(IRepresentationClass repClass)
                                 throws IOException,
                                        AutomationException

Property RepresentationClass.

Description

This is the RepresentationClass referenced by the renderer so that all features are drawn using the representation information present in the representation class. Since a single feature class can have multiple representation classes, any single representation class can be used to draw all of its features.

Product Availability

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

Parameters:

repClass - A reference to a com.esri.arcgis.geodatabase.IRepresentationClass (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getRepresentationClass

IRepresentationClass getRepresentationClass()
                                            throws IOException,
                                                   AutomationException

Property RepresentationClass.

Description

This is the RepresentationClass referenced by the renderer so that all features are drawn using the representation information present in the representation class. Since a single feature class can have multiple representation classes, any single representation class can be referenced to used to draw all of its features.

Product Availability

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

Returns:

A reference to a com.esri.arcgis.geodatabase.IRepresentationClass

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isDrawInvisible

boolean isDrawInvisible()
                        throws IOException,
                               AutomationException

Indicates whether or not invisible representations will be drawn.

Description

DrawInvisible is a boolean that indicates if invisible feature representations will be drawn or not. To change the visibility property use IRepresentaionClass::GraphicAttributes.

For example, if pRepClass is a reference to a representation class then the Viibility property for all its features can be managed as follows:

Dim pGA As IGraphicAttributes
Set pGA = pRepClass.GraphicAttributes
pGA.Value(0) = False 'Make invisible

Product Availability

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

Returns:

The draw

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDrawInvisible

void setDrawInvisible(boolean draw)
                      throws IOException,
                             AutomationException

Indicates whether or not invisible representations will be drawn.

Product Availability

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

Parameters:

draw - The draw (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getInvisibleColor

IColor getInvisibleColor()
                         throws IOException,
                                AutomationException

Color used for invisible representations.

Description

InvisibleColor is the color used by the renderer to draw invisible feature representations.

Product Availability

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

Returns:

A reference to a com.esri.arcgis.display.IColor

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setInvisibleColor

void setInvisibleColor(IColor color)
                       throws IOException,
                              AutomationException

Color used for invisible representations.

Product Availability

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

Parameters:

color - A reference to a com.esri.arcgis.display.IColor (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isDrawInvalidRule

boolean isDrawInvalidRule()
                          throws IOException,
                                 AutomationException

Indicates if representations with an invalid Rule ID will draw.

Description

DrawInvalidRule is a boolean that indicates if feature representations having either invalid or null representation rule values will be drawn by the renderer or not.

An invalid representation rule is a rule that does not belong to the collection of RepresentationRules object for that particular RepresentationClass or a rule having null value. Representation rule IDs are stored in the RuleID field of the attribute table.

Product Availability

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

Returns:

The draw

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDrawInvalidRule

void setDrawInvalidRule(boolean draw)
                        throws IOException,
                               AutomationException

Indicates if representations with an invalid Rule ID will draw.

Product Availability

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

Parameters:

draw - The draw (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getInvalidRuleColor

IColor getInvalidRuleColor()
                           throws IOException,
                                  AutomationException

Color used for representations with an invalid rule ID.

Description

InvalidRuleColor is the color used by the renderer to draw all feature representations having invalid representation rule values.

An invalid representation rule is a rule that is not present in the collection of RepresentationRules object for that particular RepresentationClass or a null rule value. Representation rule ID values are stored in the RuleID field of the attribute table.

Product Availability

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

Returns:

A reference to a com.esri.arcgis.display.IColor

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setInvalidRuleColor

void setInvalidRuleColor(IColor color)
                         throws IOException,
                                AutomationException

Color used for representations with an invalid rule ID.

Product Availability

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

Parameters:

color - A reference to a com.esri.arcgis.display.IColor (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.