CCOL, CLINE, CLINES, and CSIZE Phrases

AT CLINE NUMBER cline-num

AT CCOL NUMBER ccol-num

CSIZE   {IS} clength  [CELL ]
        {= }          [CELLS]

CLINES  {IS} cheight  [CELL ]
        {= }          [CELLS]

1. The CCOL, CLINE, CLINES, and CSIZE phrases provide an alternate method for specifying the placement (row and column) or size (height and width), or both, of a control for display on a non-graphical system. Together these phrases are called the character coordinate phrases. In any context where the COL, LINE, LINES, and SIZE phrases can be specified for a control, you can also specify the corresponding character coordinate phrase. These phrases make it easier to use controls on both graphical and non-graphical systems. See The Character Coordinate Phrases for more information.
2. You specify the character coordinate phrases in exactly the same fashion as their regular counterparts (i.e., CLINE is similar to LINE, CCOL to COL, etc.). All of the syntax supported by one phrase works in the corresponding phrase. For example, a Screen Section control item that has a twin set of column offsets is:

   entry-field, col + 2, ccol + 1, ...

   When the application is run on a graphical host system, the character coordinate phrases have no effect (exception: in some contexts the values are evaluated, so any relevant table indexes should be set to legal values to prevent access violations). When the application is run on a character-based host, the character coordinate phrases substitute for their counterparts. For example, if you specify both LINE and CLINE for a control, the CLINE specification will be used as the line number on a character-based system. Omitting a character coordinate phrase causes the regular counterpart to be used instead.

3. If you specify the CELLS option in either the SIZE or CSIZE phrase, then you must use the CELLS option in both phrases. The same rule applies to the use of the CELLS option with the LINES and CLINES phrases.