[<<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:
?|??
@...SAY
COL()
MAXROW()
PROW()
SET DEVICE
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson