[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 ROW()
 Return the screen row position of the cursor
------------------------------------------------------------------------------
 Syntax

     ROW() --> nRow

 Returns

     ROW() returns the cursor row position as an integer numeric value.  The
     range of the return value is zero to MAXROW().

 Description

     ROW() is a screen function that returns the current row or line position
     of the screen cursor.  The value of ROW() is updated by both console and
     full-screen commands and functions.  @...SAY only updates ROW() when the
     current DEVICE is the SCREEN.

     ROW() is used with COL() and all variations of the @ command to position
     the cursor to a new line relative to the current line.  In particular,
     you can use ROW() and COL() to create screen position-independent
     procedures or functions where you pass the upper-left row and column as
     parameters.

     ROW() is related to PROW() and PCOL(), which track the current printhead
     position instead of the screen cursor position.

 Examples

     .  In this example, ROW() simulates the LIST command, displaying
        text on the same line but in different columns:

        LOCAL nRow
        USE Customer INDEX CustName NEW
        DO WHILE .NOT. EOF()
           CLS
           @ 1, 1 SAY PADR("Name", LEN(CustName))
           @ ROW(), COL() + 2 SAY PADR("Address", ;
                 LEN(Address))
           @ ROW(), COL() + 2 SAY PADR("Phone", LEN(Phone))
           nRow = 0
           DO WHILE nRow++ <= 15 .AND. (!EOF())
              @ ROW() + 1, 1 SAY CustName
              @ ROW(), COL() + 2 SAY Address
              @ ROW(), COL() + 2 SAY Phone
              SKIP
           ENDDO
           WAIT
        ENDDO
        CLOSE Customer

 Files   Library is CLIPPER.LIB.


See Also: ?|?? @...GET @...SAY PCOL() PROW()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson