CanvasDrawText



Release:

4.6  •  5.0  •  5.1  •  5.2  •  5.3  •  5.4  •  6.0  •  6.1


CanvasDrawText( canvas, text, x, y, font, fontSize, color, bold, italic, hAlign, vAlign )

Draws text on a canvas.

  • «canvas» is a canvas obtained from calling the Canvas() function, or a canvas context obtained by calling the CanvasContext() function.
  • «text» is the text to draw.
  • «x», «y»: The location where the text will display.
  • «font»: (Optional) the textual TrueType font name, such as 'Arial', 'Comic Sans MS', 'Times New Roman'.
  • «fontSize»: (Optional) Font size in points. Defaults to 11.
  • «color»: (Optional) Either a textual color name or a color integer. See Color parameters for an enumeration of textual color names and a description of color integers. Defaults to 'Black'.
  • «bold», «italic»: (Optional) When true, the text is draw in bold or italic font respectively.
  • «hAlign»: (Optional) Horizontal alignment relative to «x», either 'Left', 'Center' or 'Right'. Default is 'Left'.
  • «vAlign»: (Optional) Vertical alignment relative to «y», either 'Top', 'Middle' or 'Bottom'. Default is 'Top'.
  • «measureOnly»: (Optional) Requires Analytica 5.2 When true, text is not drawn. Use this to measure the bounding box without actually drawing.

When drawn to a context where the coordinate frame as been scaled, the text (and the interpretation of «fontSize» is scaled as well. When the x- and y-axes are scaled differently, the text will be squashed or stretched. When one logical unit along x corresponds to two device pixels, then text will be twice as wide as it would be if rendered at the same «fontSize» without scaling.

Return value

New to Analytica 5.2

Returns null in Analytica 5.0 and Analytica 5.1. Starting in Analytica 5.2, returns the coordinates of the bounding box.


See also

Comments


You are not allowed to post comments.