Object Controls

Mnemonic Processing

 

To trap and handle key mnemonics generated from your application, an ODC Server can contain a property 'Mnemonics that contains the Object ID for a mnemonic processor. The system invokes this mnemonic processor when encountering any of the following mnemonics:

Mnemonic

Method Call

Description

'BEEP'

'Beep(sound$)

Play sound.

'CAPTION'

'Caption(ttl$)

Set caption line text.

'COLOUR'

'Colour(clr$)

Set foreground colour.

'_COLOUR'

'_Colour(clr$)

Set background colour.

'CS'

'ClearScreen( )

Clear the screen and delete all graphics.

'DO'

'DropObjects(c,l,w,h)

Drop all objects within specified area. This mnemonic is generally sent when change folder tabs.

'FONT'

'Font(fnt$, sz, atr$, angle)

Set current font.

'FRAME'

'Frame(x1,y1,x2,y2,wide,ttl$)

Create a frame.

'IMAGE'(n$)

'Image(n$)

Set current image name.

'IMAGE'(DELETE n$)

'ImageDelete(n$)

Delete name image.

'IMAGE'(DISABLE n$)

'ImageDisable(n$)

Disable/hide image.

'IMAGE'(ENABLE n$)

'ImageEnable(n$)

Enable/show image.

'OPTION'

'Option(opt$, value$)

Set option value.

'PICTURE'

'Picture(x1,y1,x2,y2,path$,mode)

Display a picture.

'TEXT'

'Text(x1,y1,x2,y2.txt$,atr$)

Display text. If only one x/y coordinate is given, x2 and y2 will be zero.

When processing any of the above methods, a non-zero return value indicates that the mnemonic should not be sent to the terminal.

A return value of zero or no method present causes the normal mnemonic processing to take place.