GRAPHIC CELL statement

Purpose | Sets or retrieves the next print position, based upon the row and column position of a text cell.

Syntax

GRAPHIC CELL = RowValue&, ColValue&

GRAPHIC CELL TO RowVar&, ColVar&

GRAPHIC COL TO ColVar&

GRAPHIC ROW TO RowVar&

Function Form:

ColVar& = GRAPHIC(COL)

RowVar& = GRAPHIC(ROW)

Remarks

GRAPHIC CELL is used to set or retrieve the print position, based upon the row and column position of a Text Cell. That is the row column position where the next printed text will be displayed. These operations are very similar to GRAPHIC GET POS and GRAPHIC SET POS, except that the position is reported in text rows and columns, rather than Page Units. The current graphic position is translated to a row and column number, based upon the standard character size in a fixed width font, or the average character size for a variable width font.

RowValue& specifies the horizontal screen row (starting at 1) at which to position the cursor. ColValue& specifies the vertical screen column (starting at 1) at which to position the cursor. Since row and column numbers start at one (1), the upper left corner of the window is considered to be cell 1,1.

The first form of GRAPHIC CELL moves the print position to the desired row and column. If a value given is zero (0), that parameter is ignored and that position is not changed.

The second form of GRAPHIC CELL retrieves the current print position, and assigns the values to the variables specified by RowVar& and ColVar&. Every point which falls within a text character cell is reported as that Row/Column position. If the graphic position is not at the upper left corner of the text character, you may get imprecise or unexpected results. This can occur if you perform a graphic operation other than GRAPHIC PRINT which leaves the "Last Point Referenced" at a mid-cell position.

The remaining forms allow you to retrieve just a single value, either row or column, and are supported in both statement and function form.

See also | GRAPHIC CELL SIZE, GRAPHIC GET POS, GRAPHIC SET FONT, GRAPHIC SET POS, GRAPHIC SET SCROLLTEXT, GRAPHIC SET WORDWRAP, GRAPHIC SET WRAP, GRAPHIC SPLIT