ScrollScreenRegionDown

Scrolls down 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 ScrollScreenRegionDown  (  
     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 (zero).

numberOfLines

(IN) Specifies the number of rows in the 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 down. (The bottom line of the region is replaced by the next-to-the-bottom line. The next-to-the-bottom line is replaced by the line above it, and so on. Finally, the first 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