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

Group

Was this page helpful?
    edit.png

    On Mon, 06 Dec 2010, Dadeo suggested that this page or content is incomplete and needs to be expanded or rewritten to link to Layouts and Animations and explain the relationships. Also to ActionGroup which is a special type of Group control.  Why is Layout not a skin control?

    Changelog

    ChangeDateVersion
    Table Layout for Group control2010/10/051.1.0 to 1.2.0
    StackLayout shift buttons2010/12/031.1.0 to 1.2.0
    Camera Support2011/12/171.2.0 to 1.3.0

    Element Name Data Type Description
    layout String The layout to use on subcontrols. Can be GridLayout, RingLayout or StackLayout.
    animation String Animation to apply to all subcontrols.
    camera [xpos, ypos] Boolean If true then the camera position is enabled, otherwise it is disabled.  See Camera Position for more information.
          xpos Integer The x position of the camera
          ypos Integer The y position of the camera.

    Inherited Tags from GUIControl

    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 button
    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)

    Notes and Examples

    StackLayout examples

    Vertical StackLayout with 10px spacing between buttons and collapsable:

    <control>
      <description>group</description>
      <type>group</type>
      <layout>StackLayout(Vertical,10,true)</layout>
      <animation effect="fade" time="500">WindowOpen</animation>
    </control>

     

    Vertical StackLayout with 2px spacing between buttons and not collapsable:

    <control>
    <description>group</description>
    <type>group</type>
    <layout>StackLayout(Vertical,2,false)</layout>
    <animation effect="fade" time="500">WindowOpen</animation>
    </control>

     

    Horizontal StackLayout with 10px spacing between buttons and not collapsable:

    <control>
      <description>group</description>
      <type>group</type>
      <layout>StackLayout(Horizontal,10)</layout>
      <animation effect="fade" time="500">WindowOpen</animation>
    </control>



    Running the latest version?

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