The ValueItemCollection object contains a collection and properties which define the association between an underlying data value and its visual representation within the list. The ValueItemCollection contains a collection of zero or more ValueItem objects. Each ValueItem supports two main properties: Value, the underlying data value, and DisplayValue, its visual representation. Both properties are of type Object.

Each C1DataColumn object owns one ValueItemCollection object, which is initially empty.

In code, you can manipulate the collection of ValueItem pairs as you would any other List for WinForms or Visual Studio collection. ValueItems can be added, removed, or manipulated through the ValueItemCollection object.

At design time, a ValueItem Collection Editor is available through the C1List Designer. For more information, see Using the ValueItem Collection Editor.