Site navigation

Last Edit

Page last modified 22:14, 1 Dec 2010 by diebagger
MediaPortal Wiki > MediaPortal 1 > Contribute > Skins > Skin Related Changes > 1.1.0 to 1.2.0 > Listcontrol Popup Additional Info While Scrolling

Listcontrol Popup Additional Info While Scrolling


    • Required:  No
    • Type of Change:  Feature

    This patch allows to display additional info about the currently selected item during scrolling through a listview. One example is to show the first letter of the item in a popup (See first image below) although the plugin that implements the list can freely decide what to show. Other possible scenarios are to show the year when browsing through lists with dates or genres/groups if the list is sorted this way. The idea originated from this forum thread and was further discussed and finally implemented in this thread.


    Description of Change

    To implement this feature the skin properties #scrolling.up and #scrolling.down were added to indicate if the list is currently scrolling. Skin designers can use these properties to dynamically show information (e.g. popups) only when the user is scrolling. Also the property #selecteditem.scrolllabel was added where the values are stored that should be shown. By default the first letter of the currently selected item is shown but this might not be the most suitable text in all situations, which is why the plugin that implements the listcontrol can override this with the event GetFirstLetterScrollText (GUIListControl).

    If the plugin doesn't explicitly enable this feature the skin designer has the possibility to enable this anyhow by setting the listcontrol property explicitlyEnableFirstLetterScroll to yes.


    Additional Information and References

    Mantis Issue


    Related xml(s)


    Windows IDs


    Related GUI Control

    GUIListControl(listcontrol), GUIFacadeViewControl (facadeview)

    GUI Properties
    • listcontrol -> explicitlyEnableFirstLetterScroll
    • #scrolling.down
    • #scrolling.down
    • #selecteditem.scrolllabel




    Date added

    Wed, 01 Dec 2010

    XML/Code Samples

    How plugins can set the value shown during scrolling

    private void SetupListScrolling()
           if (null != facadeLayout && null != facadeLayout.ListLayout)
             facadeLayout.ListLayout.GetScrollLabel += new GUIListControl.GetScrollLabelDelegate(ListLayout_GetScrollLabel);
        string ListLayout_GetScrollLabel(GUIListItem item)
          return item.Label3;

    How skins can enable the feature by default






    Running the latest version?

    V1.15.0 - released June 2016
    Releasenews | Download
    | Requirements

    MediaPortal RSS Feeds

    windows media centerNews & Blogs
    htpcP&S: New


    Contact | Press