控件是skin的实体。他们定义一切从按钮,到文本标签,以可视化布局。手册的这一部分将解释每详细每个控制。
6.1 Label Control
label control用于XBMC显示文本。可以选择的字体,大小,颜色,位置和要显示的文本的内容。
6.1.1 Example
<control type="label" id="1">
<description>My First label</description>
<left>80</left>
<top>60</top>
<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>
<font>font14</font>
<textcolor>FFB2D4F5</textcolor>
<shadowcolor>ff000000</shadowcolor>
<wrapmultiline>false</wrapmultiline>
<scrollspeed>50</scrollspeed>
<scrollsuffix> - </scrollsuffix>
</control>
6.1.2 Auto size labels
将 标签包含在grouplist 中,用auto属性的宽度,并设置合适的最大值和最小值。 允许标签宽动态改变适配标签文本的长度。允许image或其它控件对齐到实际标签文本的右侧,无论label 的宽度是多少。<width min="29" max="200">auto</width>
由于XBMC Gotham,只需指定<宽度>汽车</宽>也支持。
6.1.3 Multi-line labels
如果你想让你的标签多行显示,你可以插入一个行字符在标签中,例如:<label>This will be on the first line[CR]And this will be on the second line</label>
另外,如果你想让你的标签符合<width>参数,但是仍然希望在一行中显示更多内容,可以如下设置:
<wrapmultiline>true</wrapmultiline>
这会导致文本被分割(在文中空间)为多行。请注意,如果一个字大于<width>那么它不会被分割,并且仍会溢出。
6.1.4 可用标签
除了默认控件标签下面的标签可用。请注意,每个标签仅是小写。这一点很重要,因为XML标签是区分大小写的。Tag
标签 | 描述 |
---|---|
align | 可以是 left, right, 或者 center。在给定的<width>标签中对齐文本,默认 left |
aligny | 可以是 top或者 center.在给定的<height >标签中对齐文本 .默认 top |
scroll | 为true时, 如果文字比标签的 <width>长,将会滚动 .如果是false,文字会被截断. 默认false. |
label | 指定需要绘制的文本,在这里需要在string.xml中定义条目 ( Kodi 的 strings.xml或者你自己的strings.xml 文件),如果你愿意的话,你也可以硬编码一段文字,但当然这不会是本地化的。你可以使用完整的标签格式的语法,你也可以通过使用$INFO和$LOCALIZE格式指定多个信息。 |
info | 指定一段要显示的信息. 指定应显示的信息。科迪会自动填充这个信息代替<label> . See here for more information. |
number | 指定需要显示的数字。这仅仅是允许使用数字而不是文字标签(任何在<label> 中给出的数字用于在string.xml中查找) |
angle | 文本应该呈现的角度,值为0时是水平的。 |
haspath | 指定标签是否填充路径,在保持实际文件名全长的同时,长路径将会被压缩。 |
font | 从 font.xml中指定字体。 |
textcolor | 指定文字的颜色, in hex AARRGGBB format, or a name from the colour theme. |
shadowcolor | 指定文字阴影的颜色, in AARRGGBB format, or a name from the colour theme. |
wrapmultiline | 如果为true,任何不能一行适配的文字都会被适配多行。 any text that doesn't fit on one line will be wrapped onto multiple lines. |
scrollspeed | 以每秒像素为单位的文本滚动速度。默认为60。 |
scrollsuffix | 指定滚动标签使用的后缀。默认为“|”。 |