Click above to get retro games delivered to your door ever month!

Function:    ATINSAY()

Purpose:     Display an expression at coordinates in a specified color.

Syntax:      ATINSAY( row, column, color, string )

Arguments:   row         - Numeric value indicating the row on which to
                           display <string>.  Value must be between 0 and
                           24, or MAXROW() in the Clipper 5.0 version.

             column      - Numeric value indicating the column position on
                           which to display <string>.  Value must be
                           between 0 and 79.

             color       - Character string indicating the color setting
                           to use in displaying <string>.  This character
                           string must be consistent with Clipper's color
                           setting requirements.  See the Clipper manual
                           under SET COLOR for details.

             string      - The character string to display at screen
                           coordinates <row>,<column> in <color>

Returns:     Nothing useful, a null string.

Description: This function takes the repetition out of displaying strings
             in various color settings.   You simply give this function
             the row,column coordinates, the color setting, and the string
             to display and it does the rest, and resets the color when
             finished.

Notes:       If no parameters, an invalid number, or invalid type of
             parameters are passed, no action is taken and RLIBERROR()
             set.

Example:     *-- old way of displaying a message in White on Red, then
             *-- changing back to White on Black
             SET COLOR TO w/r
             @ 24,30 SAY 'A sample message on line 24'
             SET COLOR TO w/n

             *-- new way
             ATINSAY( 24, 30, 'w/r', 'A sample message on line 24' )

Source:      RL_ATINS.PRG

See also:    BOXASK(), CENTER(), KEYINPUT(), RJUSTIFY(), SAYINBOX()