Function GraStringAt() Foundation
Displays character string using a graphic function.
GraStringAt( [<oPS>], [<aPoint>], <cString> ) --> lSuccess
The return value of GraStringAt() is .T. (true) if the character string was drawn, otherwise it is .F. (false). If the return value equals .F., the cause of the error can be determined using GraError().
The function GraStringAt() draws characters or character strings using graphic functions. After output the pen position is at the end of the character string. GraStringAt() differs from QOut() and DispOut() in that GraStringAt() cannot be used in the VIO-mode (text mode). The graphic output of characters occurs using an XbpFont object which makes a font available. GraStringAt() always uses the font set by GraSetFont().
The space required for output of a characters string varies depending on which font is active. For exact positioning of characters, the coordinates for the area required to display a character string is determined with the function GraQueryTextBox().
Since the display of characters occurs using graphic primitives, the function GraStringAt() can also be called within a graphic segment. The character string <cString> is then displayed each time the function GraSegDraw() is executed. If a segment is scaled or rotated, a vector font must be active since these types of graphic transformations cannot be executed with bitmap fonts.
Using the function GraSetAttrString(), the display of characters of a vector font can be modified in several ways.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.