[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
COMMON PARAMETERS
Common Parameters - Most functions use the same parameter names. Rather
than repeating them for each routine, detailed descriptions for those
parameters are listed below.
Screen Coordinates - QWIKC routines work in absolute coordinates to give
you full control of the screen. The routines do not check for bounds on
the screen, so be sure to stay in range. The upper left column on the
screen is row 1, column 1, which is also called 1-based. The routines also
wrap to the next line; they do not truncate at end-of-line. For example,
row=1 and col=255 is equivalent to row=3 and col=15 on a screen with 80
columns. But this is not a recommended practice for variable screen
widths.
row/col - row and col were chosen in lieu of the X/Y scheme used in TC.
Since QWIKC is for only text modes, the screen is treated like a word
processor with rows and columns. It is more intuitive to use the X/Y
scheme in graphics and the row/col scheme for text.
coll/colr - In the self-centering routines, the left and right columns are
simply averaged. To center on the full width of an 80 column display, set
coll=1 and colr=80. To center on a certain column number, set both values
equal to that column number. Or, to center on any screen, set coll=1 and
colr=crt_cols.
rows/cols - Using rows/cols is much easier than row2/col2 to describe the
height and width of a block such as:
qstoretomem( row, col, rows, cols, myptr );
Should you decide to move a block, only row and col need to be changed, and
therefore rows and cols don't need to be mentally recalculated and altered.
Please keep cols no greater than crt_cols. Zero values will simply exit
the routine.
astr - This parameter contains the address of the string.
Online resources provided by: http://www.ClipX.Net --- NG 2 HTML conversion by Dave Pearson