Page tree


Search


 Recently Updated



 Latest Releases

 MediaPortal 1.17 Final
            Releasenews | Download
 MediaPortal 2.1 Final 
            Releasenews | Download

Table of Contents

Description

This control aggregates the look and behavior of the spin control and the button control. The up/down arrows are able to be independently focused for control. As the button is clicked the focused arrow scrolls the list of available values and displays each new value to the left of the up/down arrows.

Changelog

Change

Date

Version

No changes yet for this control

 

 

 

 

Elements in spincontrol and how alignment works

Item

Element Name

Data Type

Description

1

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.

2

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.

3

textureDown

String

The image file used for the down arrow when not selected.

3

textureDownFocus

String

The image file used for the down arrow when selected.

4

textureUp

String

the image file used for the up arrow when not selected.

4

textureUpFocus

String

The image file used for the up arrow when selected.

5

spinColor

String

The color of the text used to display the number of pages / total number of pages

 

 

How the Spincontrol is aligned around spinPosX with spinAlign set to Left

 

How the Spincontrol is aligned around spinPosX with spinAlign set to Right

Tags

GUISpinControl (spincontrol)


On Mon, 06 Dec 2010, Dadeo suggested that this page or content is incomplete and needs to be expanded with descriptions of all properties

Property Name

Data Type

Description

showrange

Boolean

Sets the value to the label text when the button is highlighted.

digits

Integer

Will prepend "0" the given number of times.

reverse

Boolean

The up/down button switches place.

textcolor

Long

 

font

String

 

textureUp

String

 

textureDown

String

 

textureUpFocus

String

 

textureDownFocus

String

 

align

Alignment

 

spintype

SpinType

Int, Float, Text or Disc.

orientation

eOrientation

Horizontal or Vertical

cycleItems

Boolean

 

shadowAngle

Integer

 

shadowDistance

Integer

 

shadowColor

Long

 

prefixText

String

 

suffixText

String

 

textXOff

Integer

The number of pixels the text label is offset from the left edge of the button image.

textYOff

Integer

The number of pixels the text label is offset from the top edge of the button image.

onclick

String

[Since 1.3] Executes a MediaPortal skin function when the button is clicked.  See Skin Settings for more information.

Inherited by GUIControl

See GUIControl 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 spin control</description>
  <type>spincontrol</type>
  <id>2</id>
  <posX>330</posX>
  <posY>126</posY>
  <textureUp>page_up_nofocus.png</textureUp>
  <textureDown>page_down_nofocus.png</textureDown>
  <textureUpFocus>page_up_focus.png</textureUpFocus>
  <textureDownFocus>page_down_focus.png</textureDownFocus>
  <align>left</align>
  <width>16</width>
  <height>16</height>
  <font>font13</font>
  <reverse>yes</reverse>
  <textcolor>ffffffff</textcolor>
  <disabledcolor>60ffffff</disabledcolor>
  <spintype>text</spintype>
  <showrange>yes</showrange>
  <orientation>vertical</orientation>
</control>
  •  

   

 

This page has no comments.