OutputToScreenWithAttribute

Displays a message on a selected screen, in the specified color.

Library:LibC
Classification:NetWare OS
Service:Screen Support

Syntax

  #include <screen.h> 
   
  int OutputToScreenWithAttribute (
     scr_t         scrID,
     uint8_t       attr,
     const char   *format,
     ...);

Parameters

scrID

(IN) Specifies the screen ID where the message is to be displayed.

attr

(IN) Specifies the screen (character) attributes for the characters written to the specified screen. Specify one of the following.

Flag

Value

Description

COLOR_ATTR_NONE

0

Black, no color at all

COLOR_ATTR_NAVY

1

Dim blue

COLOR_ATTR_BLUE

(0x01|8)

Blue

COLOR_ATTR_GREEN

2

Green

COLOR_ATTR_LIME

(0x02|8)

Bright green

COLOR_ATTR_TEAL

3

Dim cyan

COLOR_ATTR_CYAN

(0x03|8)

Cyan

COLOR_ATTR_MAROON

4

Dim red

COLOR_ATTR_RED

(0x04|8)

Red

COLOR_ATTR_PURPLE

5

Purple

COLOR_ATTR_MAGENTA

(0x05|8)

Bright purple

COLOR_ATTR_OLIVE

6

Brown, dim yellow

COLOR_ATTR_YELLOW

(0x06|8)

Normal yellow

COLOR_ATTR_SILVER

7

Normal white, dim, and unhighlighted

COLOR_ATTR_GREY

8

Dimmed white

COLOR_ATTR_WHITE

15

Bright, highlighted white
format

(IN) Points to a null-terminated, ASCII control string similar to that used with the printf function (except for floating point specifiers). See Print Format Control Strings.

...

Specifies arguments indicated by the format parameter.

Return Values

Returns zero if successful. Otherwise, the following:

Hex

Description

0xFFFFFFFF

Failure; invalid screen ID specified.

See Also