SetScreenRegionAttribute

Sets the display adapter attribute bytes for a region of the current screen (contiguous set of 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 SetScreenRegionAttribute  (  
     int    firstLine,   
     int    numberOfLines,   
     BYTE   attribute);

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 region (in set).

attribute

(IN) Specifies the value of attribute to set; value depends on the type of monitor that is present (see the IBM Technical Reference for the Personal Computer XT).

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

Whenever output to a screen is performed, the output is written with white-on-black attribute (0x07). This nullifies the effect of this function. Therefore, this function should be called after the screen is written to.

See Also

ScrollScreenRegionDown