Set Text - Status Bar SENDMSG() Function 20

Syntax

TF$=SENDMSG(sysgui,id,20,int,string${,context{,ERR=lineref}})

Description

This function sets the status bar text. The returned string indicates the success or failure of the operation: $01$ indicates success, while $00$ indicates failure.

Parameter

Description

sysgui

SYSGUI channel.

id

Status bar control ID.

20

Number of this SENDMSG() function.

int

A two-byte integer. The first byte sets the segments display characteristics, as follows:

$01$ Prevents a border from being drawn around the segment.

$02$ Draws text with a border to appear higher than the plane of the window.

$04$ Displays text from right-to-left for use in Hebrew or Arabic systems.

The second byte is the segment's zero-based index number.

string$

Text string to be displayed in the segment. To center the text within the segment, preface it with a single tab character ($09$). To right-justify the text within the segment, preface it with two tab characters.

Example

The following sets the second displayed segment with a pop out border in centered text:

TF$=SENDMSG(sysgui,id,20,dec($0201$),$09$+"Second Segment")