Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
_SetTextColor Procedure
◄Summary► ◄Details► ◄Example► ◄Back►
Argument
color Specifies color index of text color
Description
The _SetTextColor procedure sets the current text color to the
attribute (color index) specified by the color argument. Subsequent
text output from _OutText and _OutMem appears in the new color. The
default text color attribute is 7 (white).
_SetTextColor sets the color for the _OutText and _OutMem
procedures only. It does not affect the color of output from Write,
Writeln, OutGText, or graphics drawing routines.
In text video modes, a color index may be specified in the
range 0-31. Colors ranging from 0 to 15 are normal. Those in
the range 16-31 are the same as those in 0-15, but they blink.
Blinking text works only in text modes and can be chosen by adding
16 to the normal color number. The normal color range is listed
below for color modes (assuming the default palette is used):
Index Color Index Color
═════ ═══════ ═════ ═════════════
0 Black 8 Dark Gray
1 Blue 9 Light Blue
2 Green 10 Light Green
3 Cyan 11 Light Cyan
4 Red 12 Light Red
5 Magenta 13 Light Magenta
6 Brown 14 Yellow
7 White 15 Bright White
Monochrome text mode has the same range of colors indexes (0-31),
but they don't all map to unique display attributes. The unique
monochrome values are shown below:
Index Color
═════ ═════════════════════════
0 Off
1 Underline
7 On
9 High-intensity underlined
15 High-intensity
_GrStatus Returns
_GrParameterAltered