VioScrollRight

From EDM2
Revision as of 16:02, 21 June 2016 by Martini (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Description

Scrolls the entire display buffer (or area specified within the display buffer) to the left.

Syntax

#define INCL_VIO
#include <os2.h>

ULONG     TopRow;     /*  Top row to be scrolled. */
ULONG     LeftCol;    /*  Left column to be scrolled. */
ULONG     BotRow;     /*  Bottom row to be scrolled. */
ULONG     RightCol;   /*  Right column to be scrolled. */
ULONG     Lines;      /*  Number of lines. */
PBYTE     Cell;       /*  Cell to be written. */
HVIO      VioHandle;  /*  VIO presentation-space handle. */
APIRET    rc;         /*  Return code. */

rc = VioScrollLeft(TopRow, LeftCol, BotRow,
       RightCol, Lines, Cell, VioHandle);

Parameters

TopRow (ULONG) - input 
Top row to be scrolled.
LeftCol (ULONG) - input 
Left column to be scrolled.
BotRow (ULONG) - input 
Bottom row to be scrolled.
RightCol (ULONG) - input 
Right column to be scrolled.
Lines (ULONG) - input 
Number of lines.

Number of lines to be inserted at the right of the screen area being scrolled. If 0 is specified, no lines are scrolled.

Cell (PBYTE) - input 
Cell to be written.

Address of the character-attribute pair (2 or 4 bytes) used as a fill character on inserted lines.

VioHandle (HVIO) - input 
VIO presentation-space handle.

This must be 0, unless the caller is a Presentation Manager application; in this case, it must be the value returned by VioCreatePS.

Return Code

rc (APIRET) - returns

VioScrollLeft returns one of the following values:

  • 0 NO_ERROR
  • 355 ERROR_VIO_MODE
  • 358 ERROR_VIO_ROW
  • 359 ERROR_VIO_COL
  • 421 ERROR_VIO_INVALID_PARMS
  • 436 ERROR_VIO_INVALID_HANDLE

Remarks

TopRow = 0 and LeftCol = 0 identify the top-left corner of the screen.

If a value greater than the maximum value is specified for TopRow, LeftCol, BotRow, RightCol, or Lines, the maximum value for that parameter is used.

If TopRow and LeftCol = 0, and if BotRow, RightCol, and Lines are greater than the screen lines, the entire screen is filled with the character-attribute pair defined by Cell.


Example Code


Related Functions