[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
 COL()
 Return the screen cursor column position
------------------------------------------------------------------------------
 Syntax
     COL() --> nCol
 Returns
     COL() returns an integer numeric value.  The range of the return value
     is zero to MAXCOL().
 Description
     COL() is a screen function that returns the current column position of
     the cursor.  The value of COL() changes whenever the cursor position
     changes on the screen.  Both console and full-screen commands can change
     the cursor position.  In addition, COL() is automatically set to zero
     whenever a CLEAR, CLEAR SCREEN, or CLS command is executed.
     Use COL() to position the cursor to a column relative to the current
     column.  It is generally used in combination with ROW() and all
     variations of the @ command.  In particular, use COL() and ROW() to
     create screen position-independent procedures or functions that pass the
     upper-left row and column as parameters.
     If DEVICE is SET TO PRINTER, all the output of @...SAY commands is
     directed to the printer and PROW() and PCOL() are updated instead of
     ROW() and COL().  Use these functions when you need to determine the
     position of the printhead.
 Examples
     .  This example displays a Customer name beginning at column 10.
        The customer's account status is then displayed to the right of the
        last character of the customer name using COL():
     USE Sales NEW
        CLS
        @ 1, 10 SAY "Customer Name: " + TRIM(Customer)
        @ ROW(), COL() + 1 SAY "Account status: " + Status
 Files   Library is CLIPPER.LIB.
See Also:
@...CLEAR
@...GET
@...SAY
CLEAR
MAXCOL()
PCOL()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson