Description

A control to display multiple lines of text in MediaPortal with a 'spin control' to display more text, as opposed to the textboxscrollup control which automatically scrolls text up, within the boundaries of the control.

Images

Changelog

Change	Date	Version
Line Spacing in Text control	2010/10/05	1.1.0 to 1.2.0
Shadow Text in Text Control	2010/10/05	1.1.0 to 1.2.0

Tags

Textbox

Element Name	Data Type	Description
font	String	Text used to document the purpose of the button; an aid for the skinner and not read by the skinning engine.
lineSpacing	Float	Specifies the desired line spacing for the text in the control. The value must be in the format of a floating point number. Default is 1.0.
textcolor	Long	The color of the text when the button has the focus/is selected. Default is 0xFFFFFFFF (white).
textureUp	String	The image file used for the up arrow when not selected.
textureDown	String	The image file used for the down arrow when not selected.
textureUpFocus	String	The image file used for the up arrow when selected.
textureDownFocus	String	The image file used for the down arrow when selected.
spinHeight	Integer	The height of each arrow image. If the height of the image is different from what is defined, it will be scaled to fit.
spinWidth	Integer	The width of each arrow image. If the width of the image is different from what is defined, it will be scaled to fit.
spinColor	Long	The color of the text used to display the number of pages / total number of pages
spinPosX	Integer	The number of pixels the left edge of the spin control is offset from the left edge of the screen. (5)
spinPosY	Integer	The number of pixels the top edge of the spin control is offset from the top edge of the screen. (6)
label	String	The textbox text, a skin variable, or a number that corresponds to an id in the strings.xml file. Note that the sequence \r that causes a new line in a textboxscrollup control is not valid in a textbox.
textalign	Alignment	Align of the text in the textbox "left", "right" or "center". Default is "left".
shadowAngle	Integer	Angle between text and the text shadow. Default is 0.
shadowDistance	Integer	Distance between the text and the shadow. Default is 0.
shadowColor	Long	Color of the text shadow. Default is 0xFF000000 (black).

Inherited by Control

See Control for the full documentation of this control.

Element Name	Data Type	Description
id	Integer	The id of the control. The id will couple the skin file to the code, so if we later on want to check that a user pressed a button, the id will be required and must be unique. For controls that will never be referenced in the code it is safe to set it to "1"
description	String	An optional description of the control for your reference
type	String	The type of the control, for instance "button", "label", "textbox" and all other controls.
posX	Integer	The X-position on the window for this control
posY	Integer	The Y-position on the window for this control
width	Integer	The width of this control
height	Integer	The height of this control
onleft	Integer	The control id to move the focus to when the user moves left. If not specified (or zero) MediaPortal will find the closest control in that direction to move to. As of v1.7.0 Skin Settings and Skin Expressions are also supported.
onright	Integer	The control id to move the focus to when the user moves right. If not specified (or zero) MediaPortal will find the closest control in that direction to move to. As of v1.7.0 Skin Settings and Skin Expressions are also supported.
onup	Integer	The control id to move the focus to when the user moves up. If not specified (or zero) MediaPortal will find the closest control in that direction to move to. As of v1.7.0 Skin Settings and Skin Expressions are also supported.
ondown	Integer	The control id to move the focus to when the user moves down. If not specified (or zero) MediaPortal will find the closest control in that direction to move to. As of v1.7.0 Skin Settings and Skin Expressions are also supported.
colordiffuse	Long	Allows you to mix a color & a graphics texture. E.g. If you have a graphics texture like a blue button you can mix it with a yellow color diffuse and the end result will be green. Defaults to 0xFFFFFFFF
dimColor	Integer	Color for a control when it is not focussed. Defaults to half transparent (0x60ffffff)
onfocus	String	[Since 1.3] Executes a MediaPortal skin function when the control gains focus. See Skin Settings for more information.

XML examples

<control>
  <description>default textarea</description>
  <type>textbox</type>
  <id>4</id>
  <posX>220</posX>
  <posY>220</posY>
  <width>410</width>
  <height>300</height>
  <spinWidth>16</spinWidth>
  <spinHeight>16</spinHeight>
  <spinPosX>610</spinPosX>
  <spinPosY>530</spinPosY>
  <spinColor>ffffffff</spinColor>
  <textureUp>page_up_nofocus.png</textureUp>
  <textureDown>page_down_nofocus.png</textureDown>
  <textureUpFocus>page_up_focus.png</textureUpFocus>
  <textureDownFocus>page_down_focus.png</textureDownFocus>
  <image>icon-folder.png</image>
  <font>font13</font>
  <textcolor>ffffffff</textcolor>
  <textalign>left</textalign>
  <label>#plot</label>
</control>

Seitenhierarchie