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 icon identifies a Value Group
property.
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.
Value List
property. It returns true if the string lookFor is equal to one of the values in the Value List
(or Value Group)
property named lookIn.Value Group
(or Value List
) property, where collectionEntry identifies the property, comparator is a string containing a comparator (such as = or <=), value is a String
or Double
value, and multiplicity is the literal value ALL
or ANY
. Returns true if all (or any) of the values meet the comparison. Returns false if the Value Group
property contains no entries.Value Group
property, the internal value of this property is StringGroup
, not Value Group
.