[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 STRSCREEN()
 Displays a string with characters and attributes on the screen
------------------------------------------------------------------------------
 Syntax

     STRSCREEN(<cCharacterstring>, [<nRow>],
        [<nColumn>]) --> cNull

 Arguments

     <cCharacterstring>  Designates the character string to display.

     <nRow>  Designates the starting line for the output.  The default is
     the cursor line.

     <nColumn>  Designates the starting column for output.

 Returns

     STRSCREEN() always returns a null string.

 Description

     STRSCREEN() displays the contents of a variable to the screen (assuming
     that it is in a particular format).  You must always have a character,
     an attribute, another character, etc., in the designated character
     string.

     <nRow> and <nColumn> specify the first row and column in which to write
     the string.

 Notes

     Warning!   The string must also contain attribute bytes.  Use
     COLORTON() to create the combined numeric attributes.

     .  Output does not alter the cursor position.

 Examples

     .  Output "ABC" at the current cursor position with a different
        attribute for each character:

        STRSCREEN("A"+CHR(1)+"B"+CHR(2)+"C"+CHR(3))

     .  Output ABC with different attributes at the current cursor
        column in line 24:

        STRSCREEN("A"+CHR(1)+"B"+CHR(2)+"C"+CHR(3), 24)

     .  Output ABC with different attributes at column 70, line 24:

        STRSCREEN("A"+CHR(1)+"B"+CHR(2)+"C"+CHR(3), 24, 70)


See Also: SCREENSTR() Introduction
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson