WoW:XML/FontString - Revision history

Move page script: Move page script moved page XML/FontString to WoW:XML/FontString without leaving a redirect

2023-08-15T04:49:23Z

Move page script moved page XML/FontString to XML/FontString without leaving a redirect

← Older revision	Revision as of 04:49, 15 August 2023
(No difference)

Bear at 01:49, 22 September 2019

2019-09-22T01:49:17Z

← Older revision		Revision as of 01:49, 22 September 2019
Line 3:		Line 3:

	== Inheritance ==		== Inheritance ==
	Inherited by: none, Inherits: [[XML/LayoutFrame\|LayoutFrame]], Defined in: [[XML/Layer\|Layer]], [[XML/Button\|Button]], ~~others<br/>~~		:Inherited by: none, Inherits: [[XML/LayoutFrame\|LayoutFrame]], Widget API: [[UIOBJECT FontString\|FontString]]
	~~Widget API: [[UIOBJECT FontString\|UIObject FontString]]~~		:Defined in: [[XML/Layer\|Layer]], [[XML/Button\|Button]], ...

	== Elements ==		== Elements ==
Line 29:		Line 29:

	== Summary ==		== Summary ==
	''The Fontstring element is used to display a text in the user interface. The text displayed by the Fontstring element can be changed with the LUA function ~~<fontstringobject>~~:SetText() or read with the function ~~<fontstringobject>~~:GetText().''		The Fontstring element is used to display a text in the user interface. The text displayed by the Fontstring element can be changed with the LUA function fontStringObject:SetText() or read with the function fontStringObject:GetText().

	=== Example ===		=== Example ===
Line 36:		Line 36:
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<[[XML/Font\|Font]] name="MyFont" font="myfont.ttf" virtual="true">		<[[XML/Font\|Font]] name="MyFont" font="myfont.ttf" virtual="true">
	<FontHeight>		<nowiki><FontHeight>
	<AbsValue val="12"/>		<AbsValue val="12"/>
	</FontHeight>		</FontHeight>
Line 52:		Line 52:
	</Layer>		</Layer>
	</Layers>		</Layers>
	</Frame>		</Frame></nowiki>
	</Ui>		</Ui>


	This example creates a Font that is used by a FontString.		This example creates a Font that is used by a FontString.
Line 72:		Line 71:

	=== Another Example ===		=== Another Example ===
			<pre>
	<FontString name="$parentFontString" font="Fonts\FRIZQT__.TTF"		<FontString name="$parentFontString" font="Fonts\FRIZQT__.TTF"
	text="Example Text" justifyH="LEFT" justifyV="TOP">		text="Example Text" justifyH="LEFT" justifyV="TOP">
	<Color r="1" g="0.8" b="1" a="1"/>		<Color r="1" g="0.8" b="1" a="1"/>
	<FontHeight val="12"/>		<FontHeight val="12"/>
	<Anchors>		<Anchors>
	<Anchor point="TOPLEFT" relativeTo="$parent" x="20" y="-20" />		<Anchor point="TOPLEFT" relativeTo="$parent" x="20" y="-20" />
	</Anchors>		</Anchors>
	<Shadow>		<Shadow>
	<Offset x="1" y="1" />		<Offset x="1" y="1" />
	<Color r="0" g="0" b="0"/>		<Color r="0" g="0" b="0"/>
	</Shadow>		</Shadow>
	</FontString>		</FontString>
			</pre>

	== Notes ==		== Notes ==
	* <FontString> must be within a ''[[XML_User_Interface#Layers_and_Textures\|<Layer>]]		* <nowiki><FontString></nowiki> must be within a [[XML_User_Interface#Layers_and_Textures\|<Layer>]]
	* attribute 'font' needs to be set in order for element "FontHeight" to work		* attribute 'font' needs to be set in order for element 'FontHeight' to work

	== See also ==		== See also ==
	* [{{wdnlink\|FrameXML/Fonts.xml}} FrameXML/Fonts.xml] - for the system default list of inheritable fonts		* {{wdnlink\|FrameXML/Fonts.xml}} FrameXML/Fonts.xml - for the system default list of inheritable fonts
	* [[Widget_API#FontString]] for more code		* [[Widget_API#FontString]] for more code
	[[Category:XML elements]]		[[Category:XML elements]]

Bear at 01:49, 22 September 2019

2019-09-22T01:49:16Z

← Older revision		Revision as of 01:49, 22 September 2019
Line 3:		Line 3:

	== Inheritance ==		== Inheritance ==
	Inherited by: none, Inherits: [[XML/LayoutFrame\|LayoutFrame]], Defined in: [[XML/Layer\|Layer]], [[XML/Button\|Button]], others<br />		Inherited by: none, Inherits: [[XML/LayoutFrame\|LayoutFrame]], Defined in: [[XML/Layer\|Layer]], [[XML/Button\|Button]], others<br/>
	Widget API: [[UIOBJECT FontString\|UIObject FontString]]		Widget API: [[UIOBJECT FontString\|UIObject FontString]]

	== Elements ==		== Elements ==
	* FontHeight ([[XML/Value\|Value]])		* FontHeight ([[XML/Value\|Value]]) - screen height of the font, 'font' attribute must also be set
	* [[XML/Color\|Color]]		* [[XML/Color\|Color]]
	* [[XML/Shadow\|Shadow]]		* [[XML/Shadow\|Shadow]]
Line 13:		Line 13:
	== Attributes ==		== Attributes ==
	* name (string) - name of this layout frame		* name (string) - name of this layout frame
	* inherits (string) - a virtual [[XML/Font\|Font]] or [[XML/FontString\|FontString]] to inherit properties from.		* inherits (string) - a virtual [[XML/Font\|Font]], [[XML/FontFamily\|FontFamily]] or [[XML/FontString\|FontString]] to inherit properties from.
	* virtual (bool) - Default is 'false'.		* virtual (bool) - Default is 'false'.
	* font (string) - resource path to an actual wow font file. not a reference to [[XML/Font\|Font]] or [[XML/FontString\|FontString]].		* font (string) - resource path to an actual wow font file. '''not''' a reference to [[XML/Font\|Font]], [[XML/FontFamily\|FontFamily]] or [[XML/FontString\|FontString]].
	* spacing (float) - alters the natural text character spacing. Default is '0'.		* spacing (float) - alters the natural text character spacing. Default is '0'.
	* outline ([[XML/OUTLINE\|OUTLINE]]) - Default is 'NONE'.		* outline ([[XML/OUTLINE\|OUTLINE]]) - Default is 'NONE'.
Line 22:		Line 22:
	* justifyH ([[XML/JUSTIFYH\|JUSTIFYH]]) - Default is 'CENTER'.		* justifyH ([[XML/JUSTIFYH\|JUSTIFYH]]) - Default is 'CENTER'.
	* bytes - storage bytes to set asside as an optimization to hold text internally. Default is '255'.		* bytes - storage bytes to set asside as an optimization to hold text internally. Default is '255'.
	* text - actual text to be displayed.		* text - actual text to be displayed, or predefined WoW constant that gets replaced with localized text.
	* nonspacewrap - if enabled, will break on characters instead of words. effective only when wordwrap is enabled.		* nonspacewrap - if enabled, will break on characters instead of words. effective only when wordwrap is enabled.
	* wordwrap - enables traditional word wrap, where text will wrap around to a new line if it exceeds the frontstring frame width, breaking at the end of the last word that fits the width on any particular line.		* wordwrap - enables traditional word wrap, where text will wrap around to a new line if it exceeds the frontstring frame width, breaking at the end of the last character or word that fits the width on any particular line.
	* maxLines - the maximum number of lines to render, independant of the size of the fontstring box. text will be constrained by either the heigth of the fontstring frame or the maxLines setting, whichever is smaller.		* maxLines - the maximum number of lines to render, independant of the size of the fontstring box. text will be constrained by either the heigth of the fontstring frame or the maxLines setting, whichever is smaller.
	* indented - indents all but the first line of text. effective only when wordwrap is enbled. Default is 'false'.		* indented - indents all but the first line of text. effective only when wordwrap is enbled. Default is 'false'.
Line 32:		Line 32:

	=== Example ===		=== Example ===

	<[[XML/Ui\|Ui]] xmlns="http://www.blizzard.com/wow/ui/"		<[[XML/Ui\|Ui]] xmlns="http://www.blizzard.com/wow/ui/"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<[[XML/Font\|Font]] name="MyFont" font="myfont.ttf" virtual="true">		<[[XML/Font\|Font]] name="MyFont" font="myfont.ttf" virtual="true">
	<FontHeight>		<FontHeight>
Line 53:		Line 54:
	</Frame>		</Frame>
	</Ui>		</Ui>


	This example creates a Font that is used by a FontString.		This example creates a Font that is used by a FontString.

	== Details ==		== Details ==
			=== Specific Options ===
			* outline = NORMAL, THICK
			* monochrome = true, false
			* justifyV = TOP, MIDDLE, BOTTOM
			* justifyH = LEFT, CENTER, RIGHT

	~~outline~~ = ~~"NORMAL" or "THICK", monochrome~~ = ~~"true" or "false", justifyV~~ = ~~"TOP", "MIDDLE" or "BOTTOM", justifyH~~ = ~~"LEFT"~~, ~~"RIGHT"~~, ~~"CENTER"~~		=== Inheritance ===
			FontString 'Inherits', in addition to being able to be set to another FontString, can also be set to an existing Font or FontFamily. If set, the current FontString will take on all of that Font's settings, unless overridden in the current FontString.
	~~inherits~~ can be set to an existing ~~font~~. If set, the current FontString will take on all of that ~~font~~'s settings, unless overridden in the current FontString.

	~~Note: ''<FontString>'' must be within a ''[[XML_User_Interface#Layers_and_Textures\|<Layer>]], Attribute "font" needs to be set for element "FontHeight" to work''~~

	~~:{{icon-shortcut}}'''See [{{wdnlink\|FrameXML/Fonts.xml}} FrameXML/Fonts.xml]''' for the system default list of inheritable fonts!~~

	~~Code: [[Widget_API#~~FontString~~\|FontString Widget API]]~~		=== Localization ===
			In addition to setting a 'text' value to a localized string programmatically via WoW Lua run after the XML is loaded, text can also be replaced with a localized string automatically via one of the WoW pre-defined localization constants. For example text="GENERAL_MACROS" would get replaced with text="General Macros" for English text settings, or the Spanish version for Spanish text settings. The value must be one of the pre-defined localization constants or the FontString will simply display the literal text you gave it for the 'text' attribute.

	==== Example ====		=== Another Example ===

	<FontString name="$parentFontString" font="Fonts\FRIZQT__.TTF" text="Example Text" justifyH="LEFT" justifyV="TOP">		<FontString name="$parentFontString" font="Fonts\FRIZQT__.TTF"
			text="Example Text" justifyH="LEFT" justifyV="TOP">
	<Color r="1" g="0.8" b="1" a="1"/>		<Color r="1" g="0.8" b="1" a="1"/>
	<FontHeight val="12"/>		<FontHeight val="12"/>
Line 81:		Line 85:
	</Shadow>		</Shadow>
	</FontString>		</FontString>


			== Notes ==
			* <FontString> must be within a ''[[XML_User_Interface#Layers_and_Textures\|<Layer>]]
			* attribute 'font' needs to be set in order for element "FontHeight" to work

			== See also ==
			* [{{wdnlink\|FrameXML/Fonts.xml}} FrameXML/Fonts.xml] - for the system default list of inheritable fonts
			* [[Widget_API#FontString]] for more code
	[[Category:XML elements]]		[[Category:XML elements]]

95.91.225.37: /* was somehow not given */

2013-12-04T11:25:59Z

</FontString> was somehow not given

← Older revision		Revision as of 11:25, 4 December 2013
Line 48:		Line 48:
	<Anchor point="TOP"/>		<Anchor point="TOP"/>
	</Anchors>		</Anchors>
	</~~Texture~~>		</FontString>
	</Layer>		</Layer>
	</Layers>		</Layers>

Bear at 00:54, 19 September 2013

2013-09-19T00:54:01Z

@@ Line 1: / Line 1: @@
-Derived from: [[XML/LayoutFrame|LayoutFrame]]
+{{uixmlelem}}
-Elements: FontHeight, Color, Shadow
+== Inheritance ==
-Attributes: font, bytes, text, spacing, outline, monochrome, nonspacewrap, justifyV, justifyH, maxLines, inherits
+== Elements ==
 ''The Fontstring element is used to display a text in the user interface. The text displayed by the Fontstring element can be changed with the LUA function <fontstringobject>:SetText() or read with the function <fontstringobject>:GetText().''
 outline = "NORMAL" or "THICK", monochrome = "true" or "false", justifyV = "TOP", "MIDDLE" or "BOTTOM", justifyH = "LEFT", "RIGHT", "CENTER"
-inherits can be set to an existing font.  If set, the current FontString will take on all of that font's settings, unless overridden in the current FontString.
+inherits can be set to an existing font. If set, the current FontString will take on all of that font's settings, unless overridden in the current FontString.
-Note: ''<FontString>'' must be within a ''[[XML_User_Interface#Layers_and_Textures|<Layer>]], Attribute "font" needs to be set for element "FontHeight" to work''
+Note: ''<FontString>'' must be within a ''[[XML_User_Interface#Layers_and_Textures|&lt;Layer&gt;]], Attribute "font" needs to be set for element "FontHeight" to work''
 :{{icon-shortcut}}'''See [{{wdnlink|FrameXML/Fonts.xml}} FrameXML/Fonts.xml]''' for the system default list of inheritable fonts!

WoWWiki>SinusPi: /* Example */ case

2009-12-06T03:21:46Z

Example: case

← Older revision		Revision as of 03:21, 6 December 2009
Line 23:		Line 23:
	<FontHeight val="12"/>		<FontHeight val="12"/>
	<Anchors>		<Anchors>
	<Anchor point="TOPLEFT" relativeTo="$parent">		<Anchor point="TOPLEFT" relativeTo="$parent" x="20" y="-20" />
	~~<Offset>~~
	~~<AbsDimension~~ x="20" y="-20"/>
	~~</Offset>~~
	~~</Anchor~~>
	</Anchors>		</Anchors>
	<Shadow>		<Shadow>
	<~~offset>~~		<Offset x="1" y="1" />
	~~<AbsDimension~~ x="1" y="1"/>		<Color r="0" g="0" b="0"/>
	<~~/offset>~~
	~~<color~~ r="0" g="0" b="0"/>
	</Shadow>		</Shadow>
	</FontString>		</FontString>
	[[Category:XML elements]]		[[Category:XML elements]]

WoWWiki>Krinya007: /* Example */

2009-12-05T22:28:47Z

Example

← Older revision		Revision as of 22:28, 5 December 2009
Line 21:		Line 21:
	<FontString name="$parentFontString" font="Fonts\FRIZQT__.TTF" text="Example Text" justifyH="LEFT" justifyV="TOP">		<FontString name="$parentFontString" font="Fonts\FRIZQT__.TTF" text="Example Text" justifyH="LEFT" justifyV="TOP">
	<Color r="1" g="0.8" b="1" a="1"/>		<Color r="1" g="0.8" b="1" a="1"/>
	<FontHeight>		<FontHeight val="12"/>
	~~<AbsValue~~ val="12"/>
	~~</FontHeight~~>
	<Anchors>		<Anchors>
	<Anchor point="TOPLEFT" relativeTo="$parent">		<Anchor point="TOPLEFT" relativeTo="$parent">

WoWWiki>SinusPi: Created page with 'Derived from: LayoutFrame Elements: FontHeight, Color, Shadow Attributes: font, bytes, text, spacing, outline, monochrome, nonspacewrap, justifyV, justifyH,…'

2009-09-17T12:37:04Z

Created page with 'Derived from: LayoutFrame Elements: FontHeight, Color, Shadow Attributes: font, bytes, text, spacing, outline, monochrome, nonspacewrap, justifyV, justifyH,…'

New page

Derived from: [[XML/LayoutFrame|LayoutFrame]]

Elements: FontHeight, Color, Shadow

Attributes: font, bytes, text, spacing, outline, monochrome, nonspacewrap, justifyV, justifyH, maxLines, inherits

''The Fontstring element is used to display a text in the user interface. The text displayed by the Fontstring element can be changed with the LUA function <fontstringobject>:SetText() or read with the function <fontstringobject>:GetText().''

outline = "NORMAL" or "THICK", monochrome = "true" or "false", justifyV = "TOP", "MIDDLE" or "BOTTOM", justifyH = "LEFT", "RIGHT", "CENTER"

inherits can be set to an existing font. If set, the current FontString will take on all of that font's settings, unless overridden in the current FontString.

Note: ''<FontString>'' must be within a ''[[XML_User_Interface#Layers_and_Textures|<Layer>]], Attribute "font" needs to be set for element "FontHeight" to work''

:{{icon-shortcut}}'''See [{{wdnlink|FrameXML/Fonts.xml}} FrameXML/Fonts.xml]''' for the system default list of inheritable fonts!

Code: [[Widget_API#FontString|FontString Widget API]]

==== Example ====

<FontString name="$parentFontString" font="Fonts\FRIZQT__.TTF" text="Example Text" justifyH="LEFT" justifyV="TOP">
<Color r="1" g="0.8" b="1" a="1"/>
<FontHeight>
<AbsValue val="12"/>
</FontHeight>
<Anchors>
<Anchor point="TOPLEFT" relativeTo="$parent">
<Offset>
<AbsDimension x="20" y="-20"/>
</Offset>
</Anchor>
</Anchors>
<Shadow>
<offset>
<AbsDimension x="1" y="1"/>
</offset>
<color r="0" g="0" b="0"/>
</Shadow>
</FontString>
[[Category:XML elements]]