Back Forward 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. PEPEN B-18541 3/10/06

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. In a model or 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.

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

Function rules for Value Group properties

Notes

NoteSubscript values must be a Java identifier, starting with a letter. As a best practice, use only letters and digits in the subscripts. SR-553

NoteThe standard property Rule-Obj-Property.pyPropertyMode holds the mode of a property rule. For a Value Group property, the internal value of this property is StringGroup, not Value Group.

Definitions aggregate, Java identifier, property mode, string, Type, Value List
Related topics How to reference parts of aggregate properties
Property Form — Completing the General tab — Value modes

How to enter a Java identifier

UpDefinitions — V