MediaPortal Windows Media Center
MediaPortal Wiki > MediaPortal 1 > Contribute > Skins > Skin Architecture > Skin Controls > Menu

Menu

Was this page helpful?

    Description

    The Menu control is used on the classic MyHome and MyPlugins windows to display a scrollable menu of items/plugins installed and enabled, as setup in the Home plugin in Configuration.

    Changelog

    ChangeDateVersion
    Shadow text2010/10/101.0.1 to 1.1.0

    Tags

    A list of all the tags that are available for skin designers.

    Menu

    Element Name Data Type Description
    spaceBetweenButtons Integer Vertical space between buttons. Default is 8.
    textcolor Long The color of the text when the button has the focus/is selected. Default is 0xFFFFFFFF (white).
    textColorNoFocus Long The color of the text when the button is not selected. Default is 0xFFFFFFFF (white).
    textAlign Alignment Alignment of the text on each button, possible values are Left, Right or Center. Default is left.
    buttonWidth Integer Width of the buttons. Default is 60.
    buttonHeight Integer Height of the buttons. Default is 30.
    buttonTextXOff Integer The number of pixels the text label is offset from the left edge of the button image. Default is 10.
    buttonTextYOff Integer The number of pixels the text label is offset from the top edge of the button image. Default is 8.
    buttonOffset Integer Offset from the border to the buttons. Default is 25.
    buttonFont String The font to use to display the button text.
    numberOfButtons Integer The number of visible buttons at the same time. Default is 5.
    textureBackground String The texture to display as a menu background
    textureButtonFocus String The texture to display when the button has the focus/is selected.
    textureButtonNoFocus String The texture to display when the button is not selected.
    textureHoverNoFocus String The hover to display when the button is not selected
    hoverX Integer The number of pixels the hover image is offset from the left edge of the menu.
    hoverY Integer The number of pixels the hover image is offset from the top edge of the menu.
    hoverWidth Integer The width of the hover image.
    hoverHeight Integer The height if the hover image.
    hoverKeepAspectratio Boolean Set if the aspectratio of the texture needs to be preserved during rendering. Default is false.
    scrollTimeMin Integer The minimum number of milliseconds scrolling with keyboard/remote can take. Default is 100.
    scrollTime Integer The maximum number of milliseconds scrolling with keyboard/remote can take. Default is 160.
    mouseScrollTimeMin Integer The minimum number of milliseconds scrolling with mouse can take. Default is 250.
    mouseScrollTime Integer The maximum number of milliseconds scrolling with mouse can take. Default is 600.
    spaceAfterSelected Integer ?
    showAllHover Boolean ?
    horizontal Boolean Should the menu be horizontal instead of vertical. Default is false.
    shadowAngle Integer Angle of shadow relative to text.
    shadowDistance Integer Distance between shadow and text.
    shadowColor Long Color of shadow. Default is 0xFF000000 (black).
    hover[flipX] Boolean Display a 'miror' image of the hover horizontally
    hover[flipY] Boolean Display a 'miror' image of the hover vertically
    hover[diffuse] String Sets the level of dif
    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
    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
    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
    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
    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>Menu</description>
          <type>menu</type>
          <animation effect="fade" time="300">WindowOpen</animation>
          <animation effect="fade" time="300">WindowClose</animation>
          <animation effect="zoom" start="20,20" end="100,100" center="640,360" time="250">WindowOpen</animation>
          <animation effect="zoom" start="100,100" end="1,1" center="640,360" time="250">WindowClose</animation>
          <id>50</id>
          <posX>672</posX>
          <posY>160</posY>
          <width>500</width>
          <textcolor>ffffffff</textcolor>
          <textColorNoFocus>ffa9d0f7</textColorNoFocus>
          <dimColor>80ffffff</dimColor>
          <buttonTextXOff>38</buttonTextXOff>
          <buttonTextYOff>10</buttonTextYOff>
          <buttonOffset>28</buttonOffset>
          <buttonFont>font18</buttonFont>
          <buttonHeight>77</buttonHeight>
          <spaceBetweenButtons>0</spaceBetweenButtons>
          <numberOfButtons>5</numberOfButtons>
          <textureButtonFocus>hp_selectionbar_focus.png</textureButtonFocus>
          <textureButtonNoFocus>hp_selectionbar_nofocus.png</textureButtonNoFocus>
          <hoverX>141</hoverX>
          <hoverY>225</hoverY>
          <hoverWidth>515</hoverWidth>
          <hoverHeight>383</hoverHeight>
          <hoverKeepAspectratio>yes</hoverKeepAspectratio>
          <scrollTime>120</scrollTime>
          <scrollTimeMin>50</scrollTimeMin>
          <textureBackground>emtpy.png</textureBackground>
          <onright>13</onright>
          <onleft>10</onleft>
        </control>



    Running the latest version?

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