COM Proxy › COM Proxy Interface › Special Text Permitted Value Property Handling

Special Text Permitted Value Property Handling

If a text attribute has permitted values, then the COM Proxy surfaces two forms of properties for the same internal property: one that uses an enumeration type of the permitted values and another that takes a string.

The name of the former property is the same as given to unique attribute properties (that is, the combination of the attribute's entity view name with its entity name and attribute name) and the name of the later property is this same name with the suffix AsString.

For the former property, the name of its type is the combination of PV with the component name and the attribute entity name and attribute name. To enforce unique enumeration constant names, all permitted value names are prefixed with their enumeration type name. Additionally, if a space is used for a permitted value, its enumeration value name is the enumeration type name combined with the word spaces. For the later property (the AsString version), its type is String, which is the same type of text attributes without permitted values.

For example, text attribute HEIGHT with permitted values HIGH, MEDIUM, and LOW of component EMPLOYEE, entity view name IMPORT and entity EMPLOYEE:

Op.ImportEmployeeHeight = PVEmployeeEmployeeHeightHigh ' Setting property to HIGH

Op.ImportEmployeeHeightAsString = "MEDIUM" ' Resetting same property to MEDIUM