Label control
The label control is used for displaying text in XBMC. You can choose the font, size, colour, location and contents of the text to be displayed.
Example
<xml>
<control type="label" id="1"> <description>My First label</description> <posx>80</posx> <posy>60</posy> <width>250</width> <visible>true</visible> <align>center</align> <aligny>center</aligny> <scroll>false</scroll> <label>6</label> <info>MusicPlayer.Artist</info> <number></number> <angle>30</angle> <haspath>false</haspath> font14 <textcolor>FFB2D4F5</textcolor> <shadowcolor>ff000000</shadowcolor> <wrapmultiline>false</wrapmultiline> </control>
</xml>
Multi-Line Labels
If you want your label control to span multiple lines, you can insert a new line character in your label. For example: <xml>
<label>This will be on the first line And this will be on the second line</label>
</xml> Also, if you want your label control to conform to the <width> parameter, but still want to be able to give it more content than will fit on one line, then setting: <xml>
<wrapmultiline>true</wrapmultiline>
</xml> will cause the text to be cut up (at the spaces in the text) onto multiple lines. Note that if a single word is larger than <width> then it will not be cut, and will still overflow.
Tag Descriptions
Note that each tag is lower case only. This is important, as xml tags are case-sensitive.
align | Can be left, right, or center. Aligns the text within the given label <width>. Defaults to left |
aligny | Can be top or center. Aligns the text within its given label <height>. Defaults to top |
scroll | When true, the text will scroll if longer than the label's <width>. If false, the text will be truncated. Defaults to false. |
label |
Specifies the text which should be drawn. You should specify an entry from the strings.xml here, however you may also specify a piece of text yourself if you wish, though ofcourse it will not be localisable. You may also specify more than one piece of information here by using the $INFO and $LOCALIZE formats. |
info |
Specifies the information that should be presented. XBMC will auto-fill in this info in place of the <label>. See here for more information. |
number | Specifies a number that should be presented. This is just here to allow a skinner to use a number rather than a text label (as any number given to <label> will be used to lookup in strings.xml) |
angle | The angle the text should be rendered at, in degrees. A value of 0 is horizontal. |
haspath | Specifies whether or not this label is filled with a path. Long paths are shortened by compressing the file path while keeping the actual filename full length. |
font | Specifies the font to use from the font.xml file. |
textcolor | Specifies the color the text should be, in hex AARRGGBB format. |
shadowcolor | Specifies the color of the drop shadow on the text, in AARRGGBB format. |
wrapmultiline | If true, any text that doesn't fit on one line will be wrapped onto multiple lines. |