Fork MediaPortal on GitHub
MediaPortal Windows Media Center
MediaPortal Wiki > MediaPortal 1 > Contribute > Plugins > Plugin Related Changes > 1.1.0 to 1.2.0 > Rename ViewMode to Layout in GUIFacadeControl

Rename ViewMode to Layout in GUIFacadeControl

Was this page helpful?

    Purpose

    • Required:  Yes
    • Type of Change:  Rework

    In an effort to promote consistency and reduce confusion between code and UI terminology, facade related properties and methods have been renamed from ViewMode to Layout to reflect what the UI calls "Layout", and reduce confusion with "View" controls (what is usually referred to as a DB View, in UI the "Switch View" button).

    Description of Change

    The following public enums, properties and methods have been renamed. If your plugin uses any of these, they must be updated accordingly for it to work.

    • GUIFacadeControl.ViewMode to GUIFacadeControl.Layout
    • GUIFacadeControl.ListView to GUIFacadeControl.ListLayout
    • GUIFacadeControl.PlayListView to GUIFacadeControl.PlayListLayout
    • GUIFacadeControl.AlbumListView to GUIFacadeControl.AlbumListLayout
    • GUIFacadeControl.FilmstripView to FilmstripLayout
    • GUIFacadeControl.CoverFlowView to GUIFacadeControl.CoverFlowLayout
    • GUIFacadeControl.ThumbnailView to GUIFacadeControl.ThumbnailLayout
    • GUIFacadeControl.View to GUIFacadeControl.CurrentLayout
    • GUIFacadeControl.CurrentView to GUIFacadeControl.LayoutControl
    • Removed Views enum from BaseShare.ShareData and Share classes and use GUIFacadeControl.Layout directly

    Optional, but strongly encouraged changes:

    • For saving and loading the last used layout, your plugin should use the entry "layout" instead of "view", to keep consistency with how internal plugins behave now in this respect.
    • When exposing control ids for skins, use consistent values for the common controls. see here for the values and more information: Common Control IDs

    Additional Information and References

    • Mantis Issue: 3201
    • Related xml(s):  Enter the name of any xml(s), affected by the change.
    • Window ID:  Enter the xml Window ID(s) here.
    • Related GUI property/control:  Enter the name of the GUI property AND skin control (i.e. GUI.listcontrol and listcontrol) and link it to the related Wiki page under Skin Architecture.

    XML/Code Samples

    Sample of change for loading last used layout:

    Old:

    currentViewMode = (GUIFacadeControl.ViewMode)xmlreader.GetValueAsInt(SerializeName, "view", defaultViewMode);

    New:

    currentLayout = (GUIFacadeControl.Layout)xmlreader.GetValueAsInt(SerializeName, "layout", defaultLayout);

    Screenshots

     




    Running the latest version?

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