Inside Macintosh: Telephony /

Chapter 2 - Telephone Terminals / Telephone Terminals Reference

Telephone Terminals Functions / Monitoring and Controlling Telephone Terminals

TELSetDisplay

Sets the text displayed on a terminal or the display mode of the terminal.

pascal TELErr TELSetDisplay (
                     TELHandle hTEL, 
                     short index, 
                     short displayMode, 
                     ConstStr255Param text);

hTEL

A handle to a telephone record associated with a telephone terminal.

index

A value the indicates which item of the displayed text to set. See "Display Items" on page 2-11 for a description of the available display items.

displayMode

The desired display mode of the specified terminal. See "Display Modes" on page 2-10 for a description of the available display modes.

text

On entry, a Pascal-style string that contains the desired text of the specified item on the display of the specified terminal. Your application is responsible for disposing of that string.

function result

A result code.

DESCRIPTION

The TELSetDisplay function sets the display text and mode of the display item on the terminal device specified by the hTEL and index parameters to the values specified in the text and displayMode parameters.

SPECIAL CONSIDERATIONS

Some terminals might not support the TELSetDisplay function.