Textbox Control
From DevWiki
Applications,Boxee GUI API,Controls
Contents |
Overview
Textbox control is used for showing a large multipage piece of text. Textbox properties include position, size, and look of the text. The main advantage of using a textbox is the ability to scroll through the text and control scrolling using a scrollbar.
Example
<control type="textbox" id="100"><posx>80</posx>
<posy>60</posy>
<width>250</width>
<height>200</height>
<font>font21</font>
<textcolor>white</textcolor>
<pagecontrol>60</pagecontrol>
<autoscroll delay="3000" time="1000" repeat="10000">!Control.HasFocus(100)</autoscroll>
</control>
Available Tags
In addition to the Default Control Properties the following tags are available. Note that all XML tags are in lower case.
| Element | Description | Required |
|---|---|---|
| info | Specifies the information showed in the label taken from strings.xml or as a GUI information. | Yes, if label not specified. |
| font | Font used for the button label. From the skin /720p/fonts.xml. | Yes |
| textcolor | Color used for displaying the button label. In AARRGGBB hex format or a name from the skin color themes /colors/defaults.xml. | Yes |
| shadowcolor | Specifies the color of the drop shadow on the text. In AARRGGBB hex format or a name from the skin color themes /colors/defaults.xml. | No |
| pagecontrol | Specifies the <id> of the page control used to control the textbox. The page control can be a Scroll Bar Control. | No |
| autoscroll | Specifies the timing and conditions of any autoscrolling the textbox should have. Times are in milliseconds. The content is delayed for the given delay, then scrolls at a rate of one line per time interval until the end. If the repeat tag is present, it then delays for the repeat time, fades out over 1 second, and repeats. You can use any bool condition to specify when autoscrolling should be allowed. | No |
