Label control: Difference between revisions
>Asteron (→Tag Descriptions: aligny) |
>Jmarshall No edit summary |
||
Line 9: | Line 9: | ||
<visible>true</visible> | <visible>true</visible> | ||
<align>center</align> | <align>center</align> | ||
<aligny>center</aligny> | |||
<scroll>false</scroll> | <scroll>false</scroll> | ||
<label>6</label> | <label>6</label> | ||
<info>MusicPlayer.Artist</info> | |||
<number></number> | <number></number> | ||
< | <angle>30</angle> | ||
<haspath>false</haspath> | <haspath>false</haspath> | ||
<font>font14</font> | <font>font14</font> | ||
<textcolor>FFB2D4F5</textcolor> | <textcolor>FFB2D4F5</textcolor> | ||
<shadowcolor>ff000000</shadowcolor> | |||
<wrapmultiline>false</wrapmultiline> | |||
</control> | </control> | ||
</xml> | </xml> | ||
Line 34: | Line 38: | ||
{| class="dtable" | {| class="dtable" | ||
|- class="userrow" | |- class="userrow" | ||
| class="usercell" | '''align''' | | class="usercell" | '''align''' | ||
Line 80: | Line 58: | ||
| class="usercell" | '''number''' | | class="usercell" | '''number''' | ||
| class="usercell" | 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) | | class="usercell" | 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) | ||
|- class="userrow" | |||
| class="usercell" | '''angle''' | |||
| class="usercell" | The angle the text should be rendered at, in degrees. A value of 0 is horizontal. | |||
|- class="userrow" | |- class="userrow" | ||
| class="usercell" | '''haspath''' | | class="usercell" | '''haspath''' | ||
Line 92: | Line 73: | ||
| class="usercell" | '''shadowcolor''' | | class="usercell" | '''shadowcolor''' | ||
| class="usercell" | Specifies the color of the drop shadow on the text, in AARRGGBB format. | | class="usercell" | Specifies the color of the drop shadow on the text, in AARRGGBB format. | ||
|- class="userrow" | |- class="userrow" | ||
| class="usercell" | '''wrapmultiline''' | | class="usercell" | '''wrapmultiline''' |
Revision as of 01:37, 24 July 2007
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. |