Difference between revisions of "VioScrollRight"

From EDM2
Jump to: navigation, search
m
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Description==
 
 
Scrolls the entire display buffer (or area specified within the display buffer) to the right.
 
Scrolls the entire display buffer (or area specified within the display buffer) to the right.
 +
 +
There had been reports on the community that this function was not implemented on the OS/2 4.5 Toolkit. [http://www.os2world.com/forum/index.php/topic,1077.0.html]
  
 
==Syntax==
 
==Syntax==
<PRE>
+
VioScrollRight(TopRow, LeftCol, BotRow, RightCol, Lines, Cell, VioHandle);
#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 = VioScrollRight(TopRow, LeftCol, BotRow,
 
      RightCol, Lines, Cell, VioHandle);
 
 
 
</PRE>
 
 
==Parameters==
 
==Parameters==
; TopRow (ULONG) - input : Top row to be scrolled.  
+
;TopRow (ULONG) - input : Top row to be scrolled.  
 
+
;LeftCol (ULONG) - input : Left column 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.  
; BotRow (ULONG) - input : Bottom row 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.
; RightCol (ULONG) - input : Right column to be 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.
; Lines (ULONG) - input : Number of lines.
+
;VioHandle (HVIO) - input : VIO presentation-space handle.
Number of lines to be inserted at the right of the screen area being scrolled. If 0 is specified, no lines are scrolled.  
+
:This must be 0, unless the caller is a Presentation Manager application; in this case, it must be the value returned by VioCreatePS.
 
+
; 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==
 
==Return Code==
 
  rc (APIRET) - returns
 
  rc (APIRET) - returns
 
 
VioScrollRight returns one of the following values:
 
VioScrollRight returns one of the following values:
 
+
* 0          NO_ERROR
* 0          NO_ERROR  
+
* 355        ERROR_VIO_MODE
* 355        ERROR_VIO_MODE  
+
* 358        ERROR_VIO_ROW
* 358        ERROR_VIO_ROW  
+
 
* 359        ERROR_VIO_COL  
 
* 359        ERROR_VIO_COL  
 
* 421        ERROR_VIO_INVALID_PARMS  
 
* 421        ERROR_VIO_INVALID_PARMS  
Line 56: Line 33:
 
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 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.  
+
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==
+
<PRE>
+
 
+
</PRE>
+
==Related Functions==
+
*
+
 
+
  
[[Category:The OS/2 API Project]]
+
[[Category:Vio]]

Revision as of 20:23, 26 February 2017

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

There had been reports on the community that this function was not implemented on the OS/2 4.5 Toolkit. [1]

Syntax

VioScrollRight(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

VioScrollRight 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.