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.

 ◄Summary► ◄Example►                         ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
     For hardware and mode configurations with enough memory to support
     multiple-screen pages, _setactivepage specifies the area in memory
     where graphics output is written. The <page> argument selects the
     current active page. The default page number is 0.
 
     Screen animation can be done by alternating the graphics pages
     displayed. Use the _setvisualpage function to display a completed
     graphics page while executing graphics statements in another
     active page.
 
     The _setactivepage and _setvisualpage functions can also be used
     to control text output if you use the text functions _gettextcursor,
     _settextcursor, _outtext, _settextposition, _gettextposition,
     _settextcolor, _gettextcolor, _settextwindow, and _wrapon instead
     of the standard C-language I/O functions.
 
     The CGA hardware configuration has only 16K of RAM available to
     support multiple video pages, and only in the text mode. The EGA
     and VGA configurations may be equipped with up to 256K of RAM for
     multiple video pages in graphics mode.
 
     Return Value
 
     If successful, the function returns the page number of the
     previous active page. If the function fails, it returns -1.
                                    -♦-