Kodi ——6 Controls （3） Button Control

6.3 Button Control

    button control用於在kodi中創建按鈕，你可以選擇位置、大小和按鈕的外觀，同時可以選擇創建按鈕的時候執行那種操作。

6.3.1 Example

<control type="button" id="1">
      <description>My first button control</description>
      <left>80</left>
      <top>60</top>
      <width>250</width>
      <height>200</height>
      <visible>true</visible>
      <colordiffuse>FFFFFFFF</colordiffuse>
      <texturefocus colordiffuse="FFFFAAFF">myfocustexture.png</texturefocus>
      <texturenofocus colordiffuse="FFFFAAFF">mynormaltexture.png</texturenofocus>
      <label>29</label>
      <wrapmultiline>true</wrapmultiline>
      <font>font12</font>
      <textcolor>FFFFFFFF</textcolor>
      <focusedcolor>FFFFFFFF</focusedcolor>
      <disabledcolor>80FFFFFF</disabledcolor>
      <invalidcolor>FFFFFFFF</invalidcolor>
      <align></align>
      <aligny></aligny>
      <textoffsetx></textoffsetx>
      <textoffsety></textoffsety>
      <pulseonselect></pulseonselect>
      <onclick>XBMC.ActivateWindow(MyVideos)</onclick>
      <onfocus>-</onfocus>
      <onunfocus>-</onunfocus>
      <onup>2</onup>
      <ondown>3</ondown>
      <onleft>1</onleft>
      <onright>1</onright>
</control>

6.3.2 Available tags

    除了默認控件標籤下面的標籤可用。請注意，每個標籤僅是小寫。這一點很重要，因爲XML標籤是區分大小寫的。

tag	Description
texturefocus	當按鈕獲取焦點時，指定需要顯示的圖片。 See here for additional information about textures.
texturenofocus	當按鈕失去焦點時，指定需要顯示的圖片。
label	按鈕上要用到的標籤，可以在string.xml中定義，或者只是一個文字標籤。
font	按鈕標籤需要的字體。 定義在 fonts.xml.
textcolor	Color used for displaying the button label. In AARRGGBB hex format, or a name from the colour theme.
focusedcolor	Color used for the button label when the button has in focus. In AARRGGBB hex format or a name from the colour theme.
disabledcolor	Color used for the button label if the button is disabled. In AARRGGBB hex format or a name from the colour theme.
invalidcolor	Color used for the button if the user entered some invalid value. In AARRGGBB hex format or a name from the colour theme.
shadowcolor	Specifies the color of the drop shadow on the text, in AARRGGBB format, or a name from the colour theme.
angle	The angle the text should be rendered at, in degrees. A value of 0 is horizontal.
align	Label horizontal alignment on the button. Defaults to left, can also be center or right.
aligny	Label vertical alignment on the button. Defaults to top, can also be center.
textoffsetx	Amount to offset the label from the left (or right) edge of the button when using left or right alignment.
textoffsety	Amount to offset the label from the top edge of the button when using top alignment.
textwidth	Will truncate any text that's too long.
onclick	指定在按下按鈕時執行的操作。應該是一個內置的功能。在這裏看到更多的信息。您可能有多個<onclick>標籤，他們會按順序執行 See here for more information.
onfocus	Specifies the action to perform when the button is focused. Should be a built in function. The action is performed after any focus animations have completed. See here for more information.
onunfocus	Specifies the action to perform when the button loses focus. Should be a built in function.
wrapmultiline	Will wrap the label across multiple lines if the label exceeds the control width.