_settextwindow

Description

Creates a text window.

#include <graph.h>

void __far _settextwindow( short r1, short c1, short r2, short c2 );

r1, c1 Upper-left corner of window  
r2, c2 Lower-right corner of window  

Remarks

The _settextwindow function specifies a window in row and column coordinates where the text output to the screen by the _outtext or _outmem function is displayed. The arguments (r1, c1) specify the upper-left corner of the text window, and the arguments (r2, c2) specify the lower-right corner of the text window.

Text is output from the top of the text window down. When the text window is full, the uppermost line scrolls up out of it.

Note that this function does not affect the output of presentation-graphics text (e.g., labels, axis marks, etc.), the output of the font display routine _outgtext, or the output of the standard I/O routine printf. Use the _setviewport function to control the display area for presentation graphics or fonts.

Return Value

None. Use the _grstatus function to check conditions of success or failure.

Compatibility

Standards:None

16-Bit:DOS

32-Bit:None

See Also

_gettextposition, _gettextwindow, _grstatus, _outmem, _outtext, _scrolltextwindow, _settextposition

Example

See the example for _scrolltextwindow.