ListItem.h

/*
 *  Copyright (C) 2005-2018 Team Kodi
 *  This file is part of Kodi - https://kodi.tv
 *
 *  SPDX-License-Identifier: GPL-2.0-or-later
 *  See LICENSES/README.md for more information.
 */
 
#pragma once
 
#include "AddonClass.h"
#include "AddonString.h"
#include "Alternative.h"
#include "Dictionary.h"
#include "FileItem.h"
#include "InfoTagMusic.h"
#include "InfoTagVideo.h"
#include "ListItem.h"
#include "Tuple.h"
#include "commons/Exception.h"
 
#include <map>
#include <vector>
 
 
namespace XBMCAddon
{
  namespace xbmcgui
  {
    XBMCCOMMONS_STANDARD_EXCEPTION(ListItemException);
 
    // This is a type that represents either a String or a String Tuple
    typedef Alternative<StringOrInt,Tuple<String, StringOrInt> > InfoLabelStringOrTuple;
 
    // This type is either a String or a list of InfoLabelStringOrTuple types
    typedef Alternative<StringOrInt, std::vector<InfoLabelStringOrTuple> > InfoLabelValue;
 
    // The type contains the dictionary values for the ListItem::setInfo call.
    // The values in the dictionary can be either a String, or a list of items.
    // If it's a list of items then the items can be either a String or a Tuple.
    typedef Dictionary<InfoLabelValue> InfoLabelDict;
 
    //
    class ListItem : public AddonClass
    {
    public:
#if !defined SWIG && !defined DOXYGEN_SHOULD_SKIP_THIS
      CFileItemPtr item;
      bool m_offscreen;
#endif
 
      ListItem(const String& label = emptyString,
               const String& label2 = emptyString,
               const String& path = emptyString,
               bool offscreen = false);
 
#if !defined SWIG && !defined DOXYGEN_SHOULD_SKIP_THIS
      inline explicit ListItem(CFileItemPtr pitem) :
        item(pitem), m_offscreen(false)
      {}
 
      static inline AddonClass::Ref<ListItem> fromString(const String& str)
      {
        AddonClass::Ref<ListItem> ret = AddonClass::Ref<ListItem>(new ListItem());
        ret->item.reset(new CFileItem(str));
        return ret;
      }
#endif
 
      ~ListItem() override;
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getLabel();
#else
      String getLabel();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getLabel2();
#else
      String getLabel2();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setLabel(...);
#else
      void setLabel(const String& label);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setLabel2(...);
#else
      void setLabel2(const String& label);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setArt(...);
#else
      void setArt(const Properties& dictionary);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setIsFolder(...);
#else
      void setIsFolder(bool isFolder);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setUniqueIDs(...);
#else
      void setUniqueIDs(const Properties& dictionary, const String& defaultrating = "");
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setRating(...);
#else
      void setRating(std::string type, float rating, int votes = 0, bool defaultt = false);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      addSeason(...);
#else
      void addSeason(int number, std::string name = "");
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getArt(key);
#else
      String getArt(const char* key);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getUniqueID(key);
#else
      String getUniqueID(const char* key);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getRating(key);
#else
      float getRating(const char* key);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getVotes(key);
#else
      int getVotes(const char* key);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      select(...);
#else
      void select(bool selected);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      isSelected();
#else
      bool isSelected();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setInfo(...);
#else
      void setInfo(const char* type, const InfoLabelDict& infoLabels);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setCast(...);
#else
      void setCast(const std::vector<Properties>& actors);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setAvailableFanart(...);
#else
      void setAvailableFanart(const std::vector<Properties>& images);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      addAvailableArtwork(...);
#else
      void addAvailableArtwork(std::string url, std::string art_type = "", std::string preview = "", std::string referrer = "", std::string cache = "", bool post = false, bool isgz = false, int season = -1);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      addStreamInfo(...);
#else
      void addStreamInfo(const char* cType, const Properties& dictionary);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      addContextMenuItems(...);
#else
      void addContextMenuItems(const std::vector<Tuple<String,String> >& items, bool replaceItems = false);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setProperty(...);
#else
      void setProperty(const char * key, const String& value);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setProperties(...);
#else
      void setProperties(const Properties& dictionary);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getProperty(...);
#else
      String getProperty(const char* key);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setPath(...);
#else
      void setPath(const String& path);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setMimeType(...);
#else
      void setMimeType(const String& mimetype);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setContentLookup(...);
#else
      void setContentLookup(bool enable);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setSubtitles(...);
#else
      void setSubtitles(const std::vector<String>& subtitleFiles);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getPath();
#else
      String getPath();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getVideoInfoTag();
#else
      xbmc::InfoTagVideo* getVideoInfoTag();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getMusicInfoTag();
#else
      xbmc::InfoTagMusic* getMusicInfoTag();
#endif
 
private:
      std::vector<std::string> getStringArray(const InfoLabelValue& alt, const std::string& tag, std::string value = "");
 
      CVideoInfoTag* GetVideoInfoTag();
      const CVideoInfoTag* GetVideoInfoTag() const;
    };
 
#ifndef DOXYGEN_SHOULD_SKIP_THIS
    typedef std::vector<ListItem*> ListItemList;
#endif
  }
}