value group

One of eleven property modes, a Value Group property is a single property that has as values an unordered set of values of any Type. The system does not limit the number of entries in a group.

A Value Group property may have none, one, or many values as values, each uniquely identified by a constant string value as subscript. Like Value List properties, Value Group properties are known as aggregate properties.

On the Clipboard display and Explorer displays, the Value Group icon identifies a Value Group property.

Example

For example, a Value Group property named StateCapital can have state codes as the subscripts. Using a data transform or a Property-Set method, you can set five values into this one property, such as:

Property reference

Value

StateCapital("MA") "Boston"
StateCapital("NY") "Albany"
StateCapital("Texas") "Austin"
StateCapital("DC") statepage.thecapital
StateCapital(.pyStateCode) "" (the null string)

where the last example uses property references for the subscript and the value. Double quotes (as shown) around the subscript literal values are optional. (In a data transform, using double quotes around literal values is recommended).

Similarly, a Value Group property of Type Integer can hold population counts, as Population("MA"), Population("NY"), and so on.

Function rules for Value Group properties

Notes:

Related Topics IconRelated terms