IUniqueValueRenderer.AddValue Method

Adds a value and corresponding symbol to the list. For multivariate cases, the specified value is a delimitted list of individual values.

[Visual Basic .NET]
Public Sub AddValue ( _
    ByVal Value As String, _
    ByVal Heading As String, _
    ByVal Symbol As ISymbol _
)

[C#]
public void AddValue (
    string Value,
    string Heading,
    ISymbol Symbol
);

[C++]
HRESULT AddValue(
  BSTR Value,
  BSTR Heading,
  ISymbol* Symbol
);

[C++]
Parameters
Value [in]

  Value is a parameter of type BSTR
Heading 

  Heading is a parameter of type BSTR
Symbol [in]

  Symbol is a parameter of type ISymbol*

Product Availability

Description

Remarks

After setting FieldCount and setting at least one Field, use this method to add a unique value and corresponding symbol to the renderer. You can later retrieve and/or change the symbol for particular value using the Symbol property.

If you pass a Value that already exists in the renderer, then the existing symbol for the Value will be replaced by the object passed as the Symbol parameter.

If FieldCount > 1 then the Value you pass should be a list of values, one for each field, separated by the FieldDelimitter. By default this is a comma.

To add a value to the renderer, and have that value be drawn with the same symbol as another existing value or values, use AddReferenceValue instead of AddValue. When more than one value is drawn with the same symbol, the values are said to be grouped.

Null Values

At ArcGIS versions 8.2 and later, special behavior was added to the UniqueValueRenderer to handle Null values. If you add the special value "<Null>" to your renderer and your database supports Nulls, then features where Field = Null will be drawn with the "<Null>" symbol. 

See Also