Please enable JavaScript to view this site.

ESL Documentation

Drawing Statement

Display text in a graphical region or key.

[[color] COLOR] [font FONT_NAME]

[text [align|center]] TEXT_STRING

color COLOR

A color keyword, a string value representing a color keyword, or an integer value representing a color number corresponding to a color available on your system.

font FONT_NAME

The name of the font in which you want the TEXT_STRING to appear. You may use either system or ESL fonts. (See the description of the font is Font Reference Definition.)

You cannot change the font of a control at runtime.

text align

Left-justify text at the current position of the text cursor. This is the default.

text center

Center text both horizontally and vertically at the current position of the text cursor.

TEXT_STRING

A string value representing the text to be displayed.

Description

Any characters, including Extended ASCII characters (if the font is a non-proportional Windows font), can be specified in the text to be displayed.

Each text statement is independent of all others; any graphical region or key can have any number of different text statements.

After the text has been displayed, the text cursor is moved to the position immediately following the string. The graphics cursor does not move.

Any Windows font can be displayed in a graphical region.

If you omit the font or color specification, the text string will be drawn in the color or font currently in effect.

If the program is compiled with External Strings, then any string literals used in this statement will be externalized.

Example

key OK_KEY at position 10 10

"OK"

key GoAhead_KEY at position 100 100

blue font "medium" text align "Press any key"

blue font Normal_Font text align "to continue"

disabled key Agenda_KEY at position 30 45

color COLOR_A text center Agenda

response to Send

add to Buttons

move to 25 25

"Button " Button1 # Displays text string

# consisting of string

# literal "Button ", with

# contents of string variable

# Button1 appended.

See Also

font Reference

font is Font Reference Definition

overwrite Drawing Statement

text of Object Inquiry Built-in Function

text of item Item Inquiry Built-in Function