summaryrefslogtreecommitdiffstats
path: root/xbmc/addons/kodi-addon-dev-kit/include/kodi/gui/controls/Progress.h
blob: 8cb582bbb4d37c848a1084492aae1ffad91f8d98 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
/*
 *  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 "../../AddonBase.h"
#include "../Window.h"

namespace kodi
{
namespace gui
{
namespace controls
{

//============================================================================
///
/// \defgroup cpp_kodi_gui_controls_CProgress Control Progress
/// \ingroup cpp_kodi_gui
/// @brief \cpp_class{ kodi::gui::controls::CProgress }
/// **Window control to show the progress of a particular operation**
///
/// The progress control is used to show the progress of an item that may take
/// a long time,  or to show how far  through a movie you are.  You can choose
/// the position, size, and look of the progress control.
///
/// It has the header \ref Progress.h "#include <kodi/gui/controls/Progress.h>"
/// be included to enjoy it.
///
/// Here you find the needed skin part for a \ref Progress_Control "progress control"
///
/// @note The call of the control is only possible from the corresponding
/// window as its class and identification number is required.
///
class ATTRIBUTE_HIDDEN CProgress : public CAddonGUIControlBase
{
public:
  //==========================================================================
  ///
  /// \ingroup cpp_kodi_gui_controls_CProgress
  /// @brief Construct a new control
  ///
  /// @param[in] window               related window control class
  /// @param[in] controlId            Used skin xml control id
  ///
  CProgress(CWindow* window, int controlId) : CAddonGUIControlBase(window)
  {
    m_controlHandle = m_interface->kodi_gui->window->get_control_progress(
        m_interface->kodiBase, m_Window->GetControlHandle(), controlId);
    if (!m_controlHandle)
      kodi::Log(ADDON_LOG_FATAL,
                "kodi::gui::controls::CProgress can't create control class from Kodi !!!");
  }
  //--------------------------------------------------------------------------

  //==========================================================================
  ///
  /// \ingroup cpp_kodi_gui_controls_CProgress
  /// @brief Destructor
  ///
  ~CProgress() override = default;
  //--------------------------------------------------------------------------

  //==========================================================================
  ///
  /// \ingroup cpp_kodi_gui_controls_CProgress
  /// @brief Set the control on window to visible
  ///
  /// @param[in] visible              If true visible, otherwise hidden
  ///
  void SetVisible(bool visible)
  {
    m_interface->kodi_gui->control_progress->set_visible(m_interface->kodiBase, m_controlHandle,
                                                         visible);
  }
  //--------------------------------------------------------------------------

  //==========================================================================
  ///
  /// \ingroup cpp_kodi_gui_controls_CProgress
  /// @brief To set Percent position of control
  ///
  /// @param[in] percent              The percent position to use
  ///
  void SetPercentage(float percent)
  {
    m_interface->kodi_gui->control_progress->set_percentage(m_interface->kodiBase, m_controlHandle,
                                                            percent);
  }
  //--------------------------------------------------------------------------

  //==========================================================================
  ///
  /// \ingroup cpp_kodi_gui_controls_CProgress
  /// @brief Get the active percent position of progress bar
  ///
  /// @return                         Progress position as percent
  ///
  float GetPercentage() const
  {
    return m_interface->kodi_gui->control_progress->get_percentage(m_interface->kodiBase,
                                                                   m_controlHandle);
  }
  //--------------------------------------------------------------------------
};

} /* namespace controls */
} /* namespace gui */
} /* namespace kodi */