DisplayScreenLine

Displays a line on the specified screen.

Library:LibC
Classification:NetWare OS
Service:Screen Support

Syntax

  #include <screen.h> 
   
  int DisplayScreenLine (
     scr_t      scrID,
     uint32_t   line,
     uint32_t   col,
     uint32_t   length,
     uint8_t   *textAndAttr);
  

Parameters

scrID

(IN) Specifies the screen.

line

(IN) Specifies the position of the line by specifying a row number.

col

(IN) Specifies the position of the line by specifying a column number.

length

(IN) Specifies the length of the line.

textAndAttr

(IN) Points to the line character to display; one byte for a character, and one byte for the corresponding attribute.

Return Values

If successful, returns 0.

See Also

Example

  #include <screen.h>
  #include <stdio.h>
  #include <stdlib.h>
  
  int main( void) {
     scr_t scr = GetActiveScreen();
     unsigned int i;
     setscreenmode( 0);
     for ( i = 0; i < 25; ++i) {
        unsigned char text_and_attr[ 2 * 80];
        int j;
        for ( j = 0; j < 80; ++j) {
           text_and_attr[ 2 * j] = ( unsigned char)( ’A’ + i);
           text_and_attr[ 2 * j + 1] = ( unsigned char)( COLOR_ATTR_WHITE
                                      + COLOR_ATTR_OLIVE * 16);
        }
     DisplayScreenLine( scr, i, 0, sizeof( text_and_attr),
                        text_and_attr);
     }
     ScrollScreenArea( scr, 2, 5, 5, 20, 1, COLOR_ATTR_RED * 16,
                       SCROLL_UP);
     return EXIT_SUCCESS;
  }