Editing WoW:API FontString SetText

{{widgetmethod}}

== Synopsis ==

  FontString:SetText(string text)

== Description ==

Sets the text to be displayed in the fontstring. The text will have the color given to it via the fontinstance definition (or a [[API_FontString_SetTextColor|FontString:SetTextColor]] call). You may however use [[UI_Escape_Sequences|escape sequences]] to modify the string's appearance.

NOTE: FontString has a limit of ~4000 chars.

== Examples ==
  FontString:SetText('|cff000000This text is black,|r |cffff0000while this text will be red.|r')
will return
  <font style="color: black">This text is black, </font><font style="color: red">while this text will be red.</font>

----
;''Notes''
* The ''Font'' must be set before calling this function. This is not done for you if the FontString is created via [[API Frame CreateFontString|Frame:CreateFontString]]. There are 3 ways to ensure the ''Font'' is set:
** Send in an ''inheritsFrom'' value to [[API Frame CreateFontString|Frame:CreateFontString]].
** Set the ''inheritsFrom'' via [[API FontInstance SetFontObject|FontInstance:SetFontObject]].
** Set the font directly via [[API FontInstance SetFont|FontInstance:SetFont]].