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.

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 Type Integer can hold population counts, as Population("MA"), Population("NY"), and so on.

Function rules for Value Group properties

• IsInPropertyList(LookFor, LookIn) — Useful for searching through the elements of a 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.
• entrySatisfiesCondition(collectionEntry, comparator, value, multiplicity) — A more general function for testing the elements of a Value Group (or Value List) property, where collectionEntry identifies the property, comparitor 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.

Notes

Subscript values must be an identifier, starting with a letter. As a best practice, use only letters and digits in the subscripts.

The 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.

	aggregate, property mode, string, Type, Value List
	How to reference parts of aggregate properties Property Form — Completing the General tab — Value modes How to enter identifiers

Definitions — V