NAME

MESSAGE − display a message on a workstation

SYNOPSIS

C Syntax

void
pmessage ( ws, msg )
Pintws;workstation identifier
char∗msg;message string

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

MESSAGE displays a message (character string) on the specified workstation.  See Execution below for a description of the placement of the message on the workstation. 

C Input Parameters

wsThe workstation to send the message to. 

msgThe null terminated array of char (character string) to display on the workstation. 

Execution

MESSAGE displays the specified character string on the specified workstation.  The location of the message’s display is dependent upon the workstation type as follows:

x_tool and x_drawable workstation types
If the workstation has a text subwindow associated with it, the message is written to that window.  If a STRING input device is also active and using the text subwindow, the message will be interleaved (correctly) with the operator input. 

If the workstation does not have a text subwindow associated with it, the message will be written to the lower left corner of the workstation’s graphics window and will be removed upon the next clearing of that window.  See UPDATE WORKSTATION and SET DISPLAY UPDATE STATE for a description of when the window is cleared.  See WORKSTATION TYPE SET for a description of how to associate a text subwindow with a workstation. 

The MESSAGE function only display a message when the PM is running.  If the PM is not running then the function is silently ignored. 

When the PM is running the message function causes a window to pop up on the display.  The window contains the message and a button labelled “Done”.  Selecting the Done button causes the window to disappear. 

The message window is implemented with Athena widgets.  The resource database attributes recognized by the message window and the default values are:

∗message.box.orientationvertical,
∗message.box.allowResizeTrue,
∗message∗label.resizeTrue,
∗message∗button.labelDone

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

SEE ALSO

WORKSTATION TYPE SET (3P)

September 02, 1992