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


IUniqueValueRenderer.ReferenceValue Property (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (Carto)  

IUniqueValueRenderer.ReferenceValue Property

Reference value for the specified value.

[Visual Basic .NET]
Public Function get_ReferenceValue ( _
    ByVal Value As String _
) As String
[C#]
public string get_ReferenceValue (
    string Value
);
[C++]
HRESULT get_ReferenceValue(
  BSTR Value,
  BSTR* refValue
);
[C++]

Parameters Value [in] Value is a parameter of type BSTR refValue [out, retval] refValue is a parameter of type BSTR

Product Availability

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

Description

ReferenceValue returns the value for the referenced class index and the specified position within that class.

Remarks

Reference values are used to create grouped categories where several values map to the same symbol.

When there is no grouping, meaning that each category is defined by a single value-symbol pair, then you can look up the symbol for a given feature by using the Symbol property and passing the value.

When there is grouping -- meaning that more that one value is associated with the same symbol -- then you need to additionally check to see if the value has a ReferenceValue. If it does, to access the symbol that the feature will be drawn with, use the Symbol property and pass the ReferenceValue of the value.

When there is no Reference Value

When checking this property, an error will be raised if the string passed for the Value parameter has no associated reference value. You can catch this error and continue accordingly by using the error handling structures supported by your programming language.

See Also

IUniqueValueRenderer Interface