DspStr
Displays a string at a specified AN.
Note: This function is only used for V3.xx and V4.xx animations, and was superseded in later releases.
Syntax
DspStr(AN, sFont, sText [, iLength] [, iAlignMode] [, iLengthMode])
AN:
The AN where the text will be displayed.
sFont:
The name of the font that is used to display the text. The Font Name needs to be defined in the Fonts database. If the font is not found, the default font is used.
sText:
The text to display.
iLength:
Length of the Text to display, either in characters or pixels depending on Mode (default -1, no truncation)
iAlignMode:
The alignment of the text string:
0 - Left Justified (default)
1 - Right Justified.
2 - Center Justified.
iLengthMode:
The length mode of the text string:
0 - Length as pixels truncated (default)
1 - Length as pixels truncated with ellipsis
2 - Length interpreted as characters.
Return Value
0 (zero) if successful, otherwise an error is returned.
Related Functions
Example
DspStr(25,"RedFont","Display this text");
/* Displays "Display this text" using "RedFont" at AN25. "RedFont" needs to be defined in the Fonts database. */
See Also