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.

◄Overview►  ◄Changes►                                 ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_VIO
 
USHORT VioScrollRt(usTopRow, usLeftCol, usBotRow, usRightCol, cbColumns,
    pbCell, hvio)
USHORT usTopRow;      /* top row                  */
USHORT usLeftCol;     /* left column              */
USHORT usBotRow;      /* bottom row               */
USHORT usRightCol;    /* right column             */
USHORT cbColumns;     /* number of blank columns  */
PBYTE pbCell;         /* pointer to cell to write */
HVIO hvio;            /* video handle             */
 
The VioScrollRt function scrolls the current screen toward the right.
 
The VioScrollRt function is a family API function.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
usTopRow    Specifies the top row of the screen area to scroll.
 
usLeftCol   Specifies the leftmost column of the screen area to scroll.
 
usBotRow    Specifies the bottom row of the screen area to scroll.
 
usRightCol  Specifies the rightmost column of the screen area to scroll.
 
cbColumns   Specifies the number of columns of spaces to be inserted at the
            left. If this parameter is zero, no columns are inserted.
 
pbCell      Points to a character/attribute combination, called a cell, that
            fills the screen area left blank by the scrolling.
 
hvio        Identifies an advanced video-input-and-output (AVIO)
            presentation space. For AVIO programs, this handle must have
            been created previously using the VioCreatePS function. For
            other programs, hvio must be NULL.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value, which may be one of the following:
 
     ERROR_VIO_COL
     ERROR_VIO_INVALID_HANDLE
     ERROR_VIO_ROW
 
Comments
 
If the usTopRow and usLeftCol parameters are zero, they identify the
upper-left corner of the screen. If you specify a value greater than the
maximum for usTopRow, usLeftCol, usBotRow, usRightCol, or cbColumns, the
maximum value for that parameter is used. Maximum values depend upon the
dimensions of the screen being used.
 
You can use the VioScrollUp function to clear the screen by setting
usTopRow and usLeftCol to zero and usBotRow, usRightCol, and cbColumns to
their maximum values. The function clears the screen by using the
character/attribute combination pointed to by the pbCell parameter.
 
Example
 
This example calls VioScrollRt to fill the first ten columns at the left of
the screen with red hearts on a black background (a value of 0xFFFF is used
for usBotRow and usRightCol).
 
BYTE bCell[2];
bCell[0] = 0x03;     /* heart character     */
bCell[1] = 0x04;     /* red attribute (EGA) */
VioScrollRt(0,       /* top row             */
    0,               /* left column         */
    0xFFFF,          /* bottom row          */
    0xFFFF,          /* right column        */
    10,              /* columns             */
    bCell,           /* cell to write       */
    0);              /* video handle        */
 
See Also
 
VioCreatePS, VioScrollDn, VioScrollLf, VioScrollUp
 
                                      ♦