8.1.4 Qualified Properties

Many ActiveX components use properties with qualifying arguments. The syntax for a qualified property is:

     Component.property<qualifier>

For example this is how you would refer to a qualified ColumnWidth property which sets the width of a particular column in the ActiveX grid:

     #Com_Grid.ColumnWidth<1>

You can retrieve the value this property the same way as you would a non-qualified property:

     IF '#Com_Grid.ColumnWidth<1> *GT 100'
*          * Some code
     ENDIF

Similarly, you can set the value of a qualified property the same way as would a non-qualified property:

     SET COM(#Com_Grid) ColumnWidth<1>(50)

You can use a field as the qualifier. In this example the qualifier of the column is set by the field #STD_NUM:

     SET COM(#Com_Grid) ColumnWidth<#STD_NUM>(50)

A property can have more than one qualifier. For example a Cell property of an ActiveX grid can have two qualifying arguments (referring to row and column) to indicate the position of a cell in the grid:

     #Com_Grid.Cell<1,1>