Window.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 "AddonCallback.h"
#include "AddonString.h"
#include "Control.h"
#include "swighelper.h"
 
#include <limits.h>
#include <vector>
 
namespace XBMCAddon
{
  namespace xbmcgui
  {
    // Forward declare the interceptor as the AddonWindowInterceptor.h
    // file needs to include the Window class because of the template
    class InterceptorBase;
 
    //
    class Action : public AddonClass
    {
    public:
      Action() = default;
 
#ifndef SWIG
      explicit Action(const CAction& caction) { setFromCAction(caction); }
 
      void setFromCAction(const CAction& caction);
 
      long id = -1;
      float fAmount1 = 0.0f;
      float fAmount2 = 0.0f;
      float fRepeat = 0.0f;
      unsigned long buttonCode = 0;
      std::string strAction;
 
      // Not sure if this is correct but it's here for now.
      AddonClass::Ref<Control> control; // previously pObject
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getId();
#else
      long getId() { XBMC_TRACE; return id; }
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getButtonCode();
#else
      long getButtonCode() { XBMC_TRACE; return buttonCode; }
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getAmount1();
#else
      float getAmount1() { XBMC_TRACE; return fAmount1; }
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getAmount2();
#else
      float getAmount2() { XBMC_TRACE; return fAmount2; }
#endif
    };
 
    //==========================================================================
    // This is the main class for the xbmcgui.Window functionality. It is tied
    //  into the main Kodi windowing system via the Interceptor
    //==========================================================================
    //
    //
    class Window : public AddonCallback
    {
      friend class WindowDialogMixin;
      bool isDisposed = false;
 
      void doAddControl(Control* pControl, CCriticalSection* gcontext, bool wait);
      void doRemoveControl(Control* pControl, CCriticalSection* gcontext, bool wait);
 
    protected:
#ifndef SWIG
      InterceptorBase* window;
      int iWindowId = -1;
 
      std::vector<AddonClass::Ref<Control> > vecControls;
      int iOldWindowId = 0;
      int iCurrentControlId = 3000;
      bool bModal = false;
      CEvent m_actionEvent;
 
      bool canPulse = false;
 
      // I REALLY hate this ... but it's the simplest fix right now.
      bool existingWindow = true;
      bool destroyAfterDeInit = false;
 
      explicit Window(bool discrim);
 
      void deallocating() override;
 
      static int getNextAvailableWindowId();
 
      void setWindow(InterceptorBase* _window);
 
      void popActiveWindowId();
 
      Control* GetControlById(int iControlId, CCriticalSection* gc);
 
      SWIGHIDDENVIRTUAL void PulseActionEvent();
      SWIGHIDDENVIRTUAL bool WaitForActionEvent(unsigned int milliseconds);
#endif
 
    public:
      explicit Window(int existingWindowId = -1);
 
      ~Window() override;
 
#ifndef SWIG
      SWIGHIDDENVIRTUAL bool    OnMessage(CGUIMessage& message);
      SWIGHIDDENVIRTUAL bool    OnAction(const CAction &action);
      SWIGHIDDENVIRTUAL bool    OnBack(int actionId);
      SWIGHIDDENVIRTUAL void    OnDeinitWindow(int nextWindowID);
 
      SWIGHIDDENVIRTUAL bool IsDialogRunning() const
      {
        XBMC_TRACE;
        return false;
      }
      SWIGHIDDENVIRTUAL bool IsDialog() const
      {
        XBMC_TRACE;
        return false;
      }
      SWIGHIDDENVIRTUAL bool IsModalDialog() const
      {
        XBMC_TRACE;
        return false;
      }
      SWIGHIDDENVIRTUAL bool IsMediaWindow() const
      {
        XBMC_TRACE;
        return false;
      }
      SWIGHIDDENVIRTUAL void    dispose();
 
      inline void interceptorClear() { CSingleLock lock(*this); window = NULL; }
#endif
 
      //
      //
 
      // callback takes a parameter
#ifdef DOXYGEN_SHOULD_USE_THIS
      onAction(...);
#else
      virtual void onAction(Action* action);
#endif
 
      // on control is not actually on Window in the api but is called into Python anyway.
#ifdef DOXYGEN_SHOULD_USE_THIS
      void onControl(...);
#else
      virtual void onControl(Control* control);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      onClick(...);
#else
      virtual void onClick(int controlId);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      onDoubleClick(...);
#else
      virtual void onDoubleClick(int controlId);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      onFocus(...);
#else
      virtual void onFocus(int controlId);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      onInit(...);
#else
      virtual void onInit();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      show();
#else
      SWIGHIDDENVIRTUAL void show();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setFocus(...);
#else
      SWIGHIDDENVIRTUAL void setFocus(Control* pControl);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setFocusId(...);
#else
      SWIGHIDDENVIRTUAL void setFocusId(int iControlId);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getFocus();
#else
      SWIGHIDDENVIRTUAL Control* getFocus();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getFocusId();
#else
      SWIGHIDDENVIRTUAL long getFocusId();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      removeControl(...);
#else
      SWIGHIDDENVIRTUAL void removeControl(Control* pControl);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      removeControls(...);
#else
      SWIGHIDDENVIRTUAL void removeControls(std::vector<Control*> pControls);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getHeight();
#else
      SWIGHIDDENVIRTUAL long getHeight();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getWidth();
#else
      SWIGHIDDENVIRTUAL long getWidth();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      setProperty(...);
#else
      SWIGHIDDENVIRTUAL void setProperty(const char* key, const String& value);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getProperty(...);
#else
      SWIGHIDDENVIRTUAL String getProperty(const char* key);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      clearProperty(...);
#else
      SWIGHIDDENVIRTUAL void clearProperty(const char* key);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      clearProperties();
#else
      SWIGHIDDENVIRTUAL void clearProperties();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      close();
#else
      SWIGHIDDENVIRTUAL void close();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      doModal();
#else
 
      SWIGHIDDENVIRTUAL void doModal();
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      addControl(...);
#else
      SWIGHIDDENVIRTUAL void addControl(Control* pControl);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      addControls(...);
#else
      SWIGHIDDENVIRTUAL void addControls(std::vector<Control*> pControls);
#endif
 
#ifdef DOXYGEN_SHOULD_USE_THIS
      getControl(...);
#else
      SWIGHIDDENVIRTUAL Control* getControl(int iControlId);
#endif
    };
  }
}