ArcGIS Developer Help

ITopologyLayer.Renderer Property

Renderer used to draw the topology layer.

[Visual Basic .NET]
Public Function get_Renderer ( _
    ByVal Index As esriTopologyRenderer _
) As IFeatureRenderer

[Visual Basic .NET]
Public Sub set_Renderer ( _
    ByVal Index As esriTopologyRenderer, _
    ByVal Renderer As IFeatureRenderer _
)

[C#]
public IFeatureRenderer get_Renderer (
    esriTopologyRenderer Index
);

[C#]
public void set_Renderer (
    esriTopologyRenderer Index,
    IFeatureRenderer Renderer
);

[C++]
HRESULT get_Renderer(
  esriTopologyRenderer Index,
  IFeatureRenderer** Renderer
);

[C++]
HRESULT putref_Renderer(
  esriTopologyRenderer Index,
  IFeatureRenderer* Renderer
);

[C++]
Parameters
Index [in]

  Index is a parameter of type esriTopologyRenderer
Renderer [out, retval]

  Renderer is a parameter of type IFeatureRenderer**
Index [in]

  Index is a parameter of type esriTopologyRenderer
Renderer [in]

  Renderer is a parameter of type IFeatureRenderer*

Product Availability

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

Remarks

When defining a unique value renderer for a topology layer, set the symbology's field as "TopoRuleType".

[C#]

The following routine sets up a unique value renderer for a topology layer.

private void BuildUniqueValRenderer()
{

IMxDocument mxDocument = (IMxDocument)m_application.Document;

ITopologyLayer topologyLayer = mxDocument.FocusMap.get_Layer(0) as ITopologyLayer;
if (topologyLayer == null)
throw new NullReferenceException();

ITopology topology = topologyLayer.Topology;
if (topology == null)
throw new NullReferenceException();

//build colorramp
IRandomColorRamp randomColorRamp = new RandomColorRampClass();
randomColorRamp.MinSaturation = 20;
randomColorRamp.MaxSaturation = 40;
randomColorRamp.MinValue = 85;
randomColorRamp.MaxValue = 100;
randomColorRamp.StartHue = 76;
randomColorRamp.EndHue = 188;
randomColorRamp.UseSeed = true;
randomColorRamp.Seed = 43;

//build unique value renderer
IUniqueValueRenderer uniqueValRenderer = new UniqueValueRendererClass();
uniqueValRenderer.FieldCount = 1;
uniqueValRenderer.set_Field(0,"TopoRuleType");
uniqueValRenderer.DefaultSymbol = null;
uniqueValRenderer.UseDefaultSymbol = false;
uniqueValRenderer.set_FieldType(0, false);

//iterate through topology rules and add value to renderer for each
ITopologyRuleContainer topoRuleContainer = (ITopologyRuleContainer)topology;
IEnumRule enumRule = topoRuleContainer.Rules;
ITopologyRule topoRule = (ITopologyRule)enumRule.Next();
while (topoRule != null)
{
    uniqueValRenderer.AddValue(((int)topoRule.TopologyRuleType).ToString(),"Error",
    (ISymbol)BuildErrorLineSym());
    uniqueValRenderer.set_Label(((int)topoRule.TopologyRuleType).ToString(),
      topoRule.Name);

topoRule = (ITopologyRule)enumRule.Next();
}

randomColorRamp.Size = uniqueValRenderer.ValueCount;

bool bCreated = false;
randomColorRamp.CreateRamp(out bCreated);

IEnumColors enumColors = randomColorRamp.Colors;

for(int i = 0; i < uniqueValRenderer.ValueCount - 1; i++)
{
string val = uniqueValRenderer.get_Value(i);

    if (val == "")
      continue;

    ISymbol sym = uniqueValRenderer.get_Symbol(val);
    ((ISimpleLineSymbol)sym).Color = enumColors.Next();
    uniqueValRenderer.set_Symbol(val, sym);

}

uniqueValRenderer.ColorScheme = "Custom";

topologyLayer.set_Renderer(esriTopologyRenderer.esriTRLineErrors,
(IFeatureRenderer)uniqueValRenderer);

mxDocument.UpdateContents();
mxDocument.ActiveView.Refresh();

}

private ISimpleLineSymbol BuildErrorLineSym()
{
ISimpleLineSymbol simLineSymbol = new SimpleLineSymbolClass();
simLineSymbol.Style = esriSimpleLineStyle.esriSLSDashDotDot;
simLineSymbol.Width = 2.5;

return simLineSymbol;
}

ITopologyLayer.Renderer Property

Product Availability

Remarks

See Also