[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPMSG - Message

GPMSG (wsid, length, text)

Purpose

Use GPMSG to display a message on the specified workstation.

The message text appears in the lower left corner of the workstation viewport and is clipped to this viewport.

The message is unaffected by deferral state settings and remains displayed until removed by another message. It can be cleared by calling GPMSG with a length of zero.

The appearance (size and color) of the message text is workstation dependent. The workstation's primary character set is used to convert the text if necessary.

For workstation-specific information about message text, see information about character sets in The graPHIGS Programming Interface: Technical Reference

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

length -- specified by user, fullword integer

Length of text to be displayed (>=0)

text -- specified by user, variable length character string

Message to be displayed.

Error Codes

25
SPECIFIED WORKSTATION DOES NOT EXIST
197
MESSAGE STRING LENGTH < ZERO

Related Subroutines

None

RCP code

201327876 (X'0C000504')


[ Previous | Next | Contents | Glossary | Home | Search ]