Edit Control

From Official Kodi Wiki
Jump to: navigation, search

The edit control allows a user to input text in XBMC. You can choose the font, size, colour, location and header of the text to be displayed.

1 Example

  <control type="edit" id="1">
        <description>My First edit control</description>
        <left>80</left>
        <top>60</top>
        <width>250</width>
        <visible>true</visible>
        <aligny>center</aligny>
        <label>Search</label>
        <hinttext>Enter search string</hinttext>
        <font>font14</font>
	<textoffsetx>10</textoffsetx>
        <textcolor>FFB2D4F5</textcolor>
	<disabledcolor>FF000000</disabledcolor>
	<invalidcolor>FFFFFFFF</invalidcolor>
	<texturefocus>button-focus.png</texturefocus>
	<texturenofocus>button-nofocus.png</texturenofocus>
	<pulseonselect>no</pulseonselect>
  </control>

2 Available tags

In addition to the Default Control Tags the following tags are available. Note that each tag is lower case only. This is important, as xml tags are case-sensitive.

Tag Description
aligny Can be top or center. Aligns the text within its given control <height>. Defaults to top
label

Specifies the header text which should be shown. You should specify an entry from the strings.xml here (either the Kodi strings.xml or your skin's strings.xml file), however you may also hardcode a piece of text also if you wish, though of course it will not be localized. You can use the full label formatting syntax and you may also specify more than one piece of information here by using the $INFO and $LOCALIZE formats.strings.xml)

hinttext Specifies the text which should be displayed in the edit label control, until the user enters some text. It can be used to provide a clue as to what a user should enter in this control.
font Specifies the font to use from the font.xml file.
textcolor Specifies the color the text should be, in hex AARRGGBB format, or a name from the colour theme.
textwidth Will truncate any text that's too long.


3 See also

Development: