ScrollScreenRegionUp

Scrolls up a portion of the current screen (a set of contiguous rows)

Local Servers:nonblocking
Remote Servers:N/A
Classification:3.x, 4.x, 5.x, 6.x
Service:Screen Handling

Syntax

  #include <nwconio.h>  
   
  int ScrollScreenRegionUp  (  
     int   firstLine,   
     int   numberOfLines); 
  

Parameters

firstLine

(IN) Specifies the row number of the first row in the set. The top row of the screen is 0.

numberOfLines

(IN) Specifies the number of rows in region (in set).

Return Values

The following table lists return values and descriptions.

Value

Hex

Name

Description

0

(0x00)

ESUCCESS

Successful.

23

(0x17)

ENO_SCRNS

Screen I/O was attempted when no screens were open.

Remarks

This function scrolls a portion of the screen up. (The top line of the region is replaced by the next-to-the-top line. The next-to-the-top line is replaced by the line below it, and so on. Finally, the bottom line of the region is cleared.) All of the lines on the screen that are not in the defined region are not affected.

See Also

CopyToScreenMemory, SetScreenRegionAttribute