Page tree


Search

  Wiki Navigation

    Loading...


 Recently Updated


 Latest Releases

 MediaPortal 1.22 
            Releasenews | Download
 MediaPortal 2 2.2.1 
            Releasenews | Download

Table of Contents

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>
  •  
    •  
  •  

   

 

This page has no comments.