ScreenMix() - combine a string of charcaters with string of colours
Mixes characters and colours of a screen
──────────────────────────────────────────────────────────────────────────────
Syntax
ScreenMix(<cChar>, <cAttrString>, [<nRow>], [<nCol>]) -->cNull
Arguments
<cChar> is the a string of charcters to use.
<cAttrString> is which colour strings to mix with the characters in the
<cChar>.
<nRow> is the starting row at which the resulting string is to be
displayed. The default is the cursor line.
<nCol> is the starting column at which the resulting string will be
displayed. The default is the cursor column.
Returns
ScreenMix() always returns a null string, or "".
Description
ScreenMix() may be used to combine a plain character string with a
string of colour atributes to create a screen image which can then be
displayed to the active window.
ScreenMix() applies the first colour attribute, <cAttrString>, to the
first <cChar> and so on.
<nRow) and <nCol> are used to determine where the resulting screen
should be displayed from.
Notes
■ This function does not alter the cursor position.
Examples
■ The folowing charceters are used to represene the basic strings:
cChar: = "1Help"
cAttrString: = CHR(116) + REPLICATE(CHR(113), 5)
■ Show output at the current cursor position:
ScreenMix(cChar, cAttrString)
■ Show output at line 24 at the cursor column:
ScreenMix(cChar, cAttrString, 24)
■ Show output at line 0, column 0 of the active window:
ScreenMix(cChar, cAttrString, 0, 0)
Files: Library is MRWINDOW.LIB.