Edit Control: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
m (section page content)
Line 3: Line 3:
=== Example ===
=== Example ===
<source lang="xml">
<source lang="xml">
   <control type="editcontrol" id="1">
   <control type="edit" id="1">
         <description>My First edit control</description>
         <description>My First edit control</description>
         <posx>80</posx>
         <posx>80</posx>
Line 13: Line 13:
         <hinttext>Enter search string</hinttext>
         <hinttext>Enter search string</hinttext>
         <font>font14</font>
         <font>font14</font>
<textoffsetx>10</textoffsetx>
         <textcolor>FFB2D4F5</textcolor>
         <textcolor>FFB2D4F5</textcolor>
<disabledcolor>FF000000</disabledcolor>
<invalidcolor>FFFFFFFF</invalidcolor>
<texturefocus>button-focus.png</texturefocus>
<texturenofocus>button-nofocus.png</texturenofocus>
<pulseonselect>no</pulseonselect>
   </control>
   </control>
</source>
</source>

Revision as of 14:29, 1 March 2014

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.

Example

  <control type="edit" id="1">
        <description>My First edit control</description>
        <posx>80</posx>
        <posy>60</posy>
        <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>

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.

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 XBMC 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.


See also

Development: