This document is archived and information here might be outdated. Recommended version. |
ArcObjects namespaces > Carto > ESRI.ArcGIS.Carto > Interfaces > IU > IUniqueValueRenderer Interface > IUniqueValueRenderer.ReferenceValue Property (ArcObjects .NET 10.4 SDK) |
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
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.