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.
setactivepage
◄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 FORTRAN 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.
In OS/2, only page 0 is valid.
Return Value
If successful, the function returns the page number of the previous
active page. If the function fails, it returns -1.
-♦-