| <u><center>y</center></u> || number || the ''y'' coordinate of the beginning of the string. Relative to ''position''.
| <u><center>y</center></u> || number || the ''y'' coordinate of the beginning of the string. Relative to ''position''.
|-
|-
−
| <u><center>position</center></u> || string || the string’s anchor point. It can either be "baseline", “bottom”, “middle”, or “top”.
+
| <u><center>position</center></u> || string || the string’s anchor point (vertical alignment). It can either be "baseline", “bottom”, “middle”, or “top”. See screenshot below.
|}
|}
−
== Example ==
+
+
The ''position'' argument is optional, and defaults to "bottom" when not specified in apilevels < 2.3. For apilevels >= 2.3, the default is "top".
+
+
== Example ==
<syntaxhighlight>function on.paint(gc)
<syntaxhighlight>function on.paint(gc)
gc:drawString("Hello World", 0, 0, "top")
gc:drawString("Hello World", 0, 0, "top")
end</syntaxhighlight>
end</syntaxhighlight>
will display Hello World at the top-left part of the screen.
will display Hello World at the top-left part of the screen.
+
+
+
== Good to know ==
+
In order to clear up what 'position' does, here's an animated image with the 4 possibilities, showing a text that is drawn at the same 60;60 coordinates, but with different "position" attributes.<br />