Fork MediaPortal on GitHub
MediaPortal Windows Media Center
MediaPortal Wiki > MediaPortal 1 > Contribute > Skins > Skin Architecture > Skin Controls > Updownlistcontrol

Updownlistcontrol

Was this page helpful?

    Description

    Control GUIUpDownListControl (updownlistcontrol)

    Changelog

    ChangeDateVersion
    TextColorNoFocus2013/01/271.2.0 to 1.3.0
    New color skin tag for DVD/BluRay folders2012/06/141.2.0 to 1.3.0
    Shadow text2010/10/101.0.1 to 1.1.0

    GUIUpDownListControl Tags

    Element Name Data Type Description
    font String Defines the font used for the text in the spincontrol; value is defined in fonts.xml.
    unfocusedAlpha Integer  
    suffix String Defines the character that is used as a separator when a text label is too long for the space alloted for it
    subitems list A list can have 1 or more subitems, each subitem has its own text to render on the list label. When the user presses the up/down button, the next item will be selected and shown on the list label. For more examples/info see: Skin Architecture > Skin Controls > button
    image Integer The file name of the default icon displayed in the list when an icon is not available
    • image001.jpg
    Item Element Name Data Type Description
    1 IconYOff Integer Number of pixels from the top edge of the updownlistcontrol row to the top edge of the icon
    2 IconXOff Integer Number of pixels from the left edge of the updownlistcontrol to the left edge of the icon
    3 textureFocus String The image file displayed when an item in the updownlistcontrol is selected
    4 textureHeight Integer The height, in pixels, that the textureFocus and textureNoFocus will be drawn to. When not specified, the skin engine will use the height of the image.
    5 textureUp String the image file used for the up arrow when not selected.
    5 textureUpFocus String The image file used for the up arrow when selected.
    6 textureDown String The image file used for the down arrow when not selected.
    6 textureDownFocus String The image file used for the down arrow when selected.
    7 textureNoFocus String The image file displayed when item(s) are not selected in an updownlistcontrol
    8 itemwidth Integer Width of the icon displayed on the left of the list. The icon will be resized to fit into this width, but aspect ratio will be maintained
    9 itemheight Integer Height of the icon displayed on the left of the list. The icon will be resized to fit into this height, but aspect ratio will be maintained
    • image003.jpg
    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

    Inherited by Listcontrol

    See GUIListControl for the full documentation of this control.

    Element Name Data Type Description
    spaceBetweenItems Integer The space between items. Default 2
    textureHeight Integer Default 10
    textXOff Integer The X offset of the first label
    textYOff Integer The Y offset of the first label
    textXOff2 Integer The X offset of the second label
    textYOff2 Integer The Y offset of the second label
    textXOff3 Integer The X offset of the third label
    textYOff3 Integer The Y offset of the third label
    textpadding Integer [deferred to later release]  provides "space" inside the label text to prevent overlap with graphics that follow on the right.
    textpadding2 Integer [deferred to later release ]  provides "space" inside the label2 text to prevent overlap with graphics that follow on the right. 
    textpadding3 Integer [deferred to later release ]  provides "space" inside the label3 text to prevent overlap with graphics that follow on the right. 
    itemWidth Integer Item width - default 16
    itemHeight Integer Item height - default 16
    remoteColor Long Default 0xffff0000, Color used to render text when item is remote (e.g. ftp)
    playedColor Long Default 0xffa0d0ff, Color used to render text when item is currently played
    downloadColor Long Default 0xff00ff00, Color used to render text when item is currently downloaded
    shadedColor Long Set the shaded color. Default 0x20ffffff
    textvisible1 Boolean Default true
    textvisible2 Boolean Default true
    textvisible3 Boolean Default true
    textalign String Align the first(main) label 'left', 'right' or 'center. Default is left
    textalign2 String Align the second (middle) label  'left', 'right' or 'center. Default is left
    textalign3 String Align the third (leftmost) label 'left', 'right' or 'center. Default is left
    textcontent3 String Allowed values are:  #selectedindex, #selecteditem, #selecteditem2, #rating, #duration, #shortduration, #dvdlabel, #year
    Default is empty.
    PinIconXOff Integer Default 100
    PinIconYOff Integer Default 10
    PinIconWidth Integer  
    PinIconHeight Integer  
    IconXOff Integer The X offset of the icon. Default 8
    IconYOff Integer The Y offset of the icon. Default 5
    scrollOffset Integer This is the offset from the first or last element on screen when scrolling should start.
    scrollStartDelaySec Integer Seconds it takes until scrolling starts. Default: 1
    loopDelay Integer Wait at the last/first item loopDelay ms until loop to the first/last item
    keepaspectratio Boolean Keep aspect ratio of list item image. Default false
    suffix String Default is pipe symbol
    font String The font for the first label
    font2 String The font for the second label
    font3 String The font for the third label
    textcolor Long Color of the first label when in focus. Default is 0xFFFFFFFF
    textcolor2 Long Color of the second label when in focus. Default is 0xFFFFFFFF
    textcolor3 Long Color of the third label when in focus. Default is 0xFFFFFFFF
    textcolorNoFocus Long [Since 1.3] Color of the first label when NOT in focus. Default is 0xFFFFFFFF 
    textcolorNoFocus2 Long [Since 1.3] Color of the second label when NOT in focus. Default is 0xFFFFFFFF  
    textcolorNoFocus3 Long [Since 1.3] Color of the third label when NOT in focus. Default is 0xFFFFFFFF  
    selectedColor Long Color of the selected first label. Default is 0xFFFFFFFF
    selectedColor2 Long Color of the selected second label. Default is 0xFFFFFFFF
    selectedColor3 Long Color of the selected third label. Default is 0xFFFFFFFF
    bdDvdDirectoryColor Long [Since 1.3] Color of the 1st label for DVD/BluRay items/folders. Default is 0xFFFFFFFF
    bdDvdDirectoryColor2 Long [Since 1.3] Color of the 2nd label for DVD/BluRay items/folders. Default is 0xFFFFFFFF
    bdDvdDirectoryColor3 Long [Since 1.3] Color of the 3rd label for DVD/BluRay items/folders. Default is 0xFFFFFFFF
    shadowAngle Integer Angle of text shadow relative to text.
    shadowDistance Integer Distance between text and shadow.
    shadowColor Integer Color of shadow
    folderPrefix String Default is '['
    folderSuffix String Default is ']'
    spinPosX Integer The number of pixels the left edge of the spincontrol is offset from the left edge of the screen
    spinPoxY Integer The number of pixels the top edge of the spincontrol is offset from the top edge of the screen
    spinAlign String Defines the alignment for the spin button. Default: Left
    spinCanFocus Boolean Define if the spin button can be focused. If not, onleft and onright are focused immediately. Default: yes
    textureUp String The name of the unfocused up texture
    textureDown String The name of the unfocused down texture
    textureUpFocus String The name of the focused up texture
    textureDownFocus String The name of the focused down texture
    textureFocus [border, position, textureRepeat, textureRotate, texture, colorKey, corners, cornerRotate, mask, tileFill] String The texture to display when the button has the focus/is selected
          border String With this feature you have the ability to add borders composed from textures that you identify. See Borders for a more detailled description.
          position BorderPosition Specifies the position of the border relative to the image or control rectangle edges. Valid values are OutsideImage, InsideImage, CenterImage, OutsideControl, InsideControl, CenterControl. The default value is "OutsideImage". Example: <border position="CenterControl">10</border>
          textureRepeat Boolean  
          textureRotate Boolean  
          texture String  
          colorKey Long  
          corners Boolean  
          cornerRotate Boolean  
          cornerRotate String Allows to specify a mask that defines the areas of the images that are drawn to screen. See Image Masks for more information on how to use image masks in MediaPortal.
          tileFill Boolean  
    textureNoFocus [border, position, textureRepeat, textureRotate, texture, colorKey, corners, cornerRotate, mask, tileFill] String The texture to display when the button does not have the focus/is not selected
          border String With this feature you have the ability to add borders composed from textures that you identify. See Borders for a more detailled description.
          position BorderPosition Specifies the position of the border relative to the image or control rectangle edges. Valid values are OutsideImage, InsideImage, CenterImage, OutsideControl, InsideControl, CenterControl. The default value is "OutsideImage". See Borders for a more detailled description.
          textureRepeat Boolean Specifies whether the texture used for the border should repeat or stretch inside each of the four rectangles that compose the overall border. The default value is "no". Example: <border textureRepeat="yes">10</border>
          textureRotate Boolean  
          texture String  
          colorKey Long  
          corners Boolean  
          cornerRotate Boolean  
          mask String Allows to specify a mask that defines the areas of the images that are drawn to screen. See Image Masks for more information on how to use image masks in MediaPortal.
          tileFill Boolean Will tile a texture to the rectangle rather than stretch it
    scrollbarbg String Texture for the background of the scrollbar
    scrollbartop String Texture for the top of the scrollbar
    scrollbarbottom String Texture for the bottom of the scrollbar
    spinColor Long  
    spinAlign Integer  
    spinHeight Integer  
    spinWidth Integer  
    spinPosX Integer  
    spinPosY Integer  
    unfocusedAlpha [applyToAll] Integer The alpha value to use for unfocused elements. Default is 0xFF
          applyToAll Boolean [Since 1.3]  Specifies if unfocusedAlpha should apply to only the label (default) or to all list entry elements (including label2, label3, pinIcon, and Icon). Default is "false".
    scrollbarXOff Integer  Set a negative value to move the scrollbar to the left, or a positive value to move it to the right. Default is 0.
    scrollbarwidth Integer Width of scrollbar. Default is 15.

    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.

    Notes and Examples

    <control>
      <description>default up/downlistcontrol</description>
      <type>updownlistcontrol</type>
      <id>10</id>
      <posX>260</posX>
      <posY>97</posY>
      <width>425</width>
      <height>459</height>
      <spinWidth>26</spinWidth>
      <spinHeight>27</spinHeight>
      <spinPosX>590</spinPosX>
      <spinPosY>530</spinPosY>
      <spinAlign>Left</spinAlign>
      <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>
      <textureFocus>list_sub_focus.png</textureFocus>
      <textureNoFocus>list_sub_nofocus.png</textureNoFocus>
      <textureHeight>32</textureHeight>
      <image>folder_focus.png</image>
      <itemwidth>28</itemwidth>
      <itemheight>28</itemheight>
      <spacebetweenitems>2</spacebetweenitems>
      <font>font13</font>
      <shadedColor>20ffffff</shadedColor>
      <selectedColor>FFF8BC70</selectedColor>
      <textcolor>ffffffff</textcolor>
      <textcolor2>ffffffff</textcolor2>
      <textcolor3>ffffffff</textcolor3>
      <colordiffuse>ffffffff</colordiffuse>
      <remoteColor>ffFFA075</remoteColor>
      <downloadColor>ff80ff80</downloadColor>
      <bdDvdDirectoryColor>ffcc9900</bdDvdDirectoryColor>
      <bdDvdDirectoryColor2>ffcc9900</bdDvdDirectoryColor2>
      <bdDvdDirectoryColor3>ffcc9900</bdDvdDirectoryColor3> 
      <textXOff>5</textXOff>
      <textYOff>4</textYOff>
      <textXOff2>0</textXOff2>
      <textYOff2>4</textYOff2>
      <IconXOff>8</IconXOff>
      <IconYOff>8</IconYOff>
      <onleft>2</onleft>
      <onright>2</onright>
      <onup>2</onup>
      <ondown>2</ondown>
      <suffix>|</suffix>
      <subitems>
        <subitem>item 1</subitem>
        <subitem>100</subitem>
        <subitem>#date</subitem>
      </subitems>
    </control>



    Tag page (Edit tags)
    • No tags
    Running the latest version?

    V1.8.0 - released July 2014
    Releasenews | Download
    Changelog
     | Requirements
    HTPC
    Team-MediaPortal
     
    About
    Contact |  Press
    Partners