File: projectexplorernavigation.h

package info (click to toggle)
olive-editor 20200620-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 40,228 kB
  • sloc: cpp: 51,932; sh: 56; makefile: 7; xml: 7
file content (117 lines) | stat: -rw-r--r-- 3,154 bytes parent folder | download
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
115
116
117
/***

  Olive - Non-Linear Video Editor
  Copyright (C) 2019 Olive Team

  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation, either version 3 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program.  If not, see <http://www.gnu.org/licenses/>.

***/

#ifndef PROJECTEXPLORERLISTVIEWTOOLBAR_H
#define PROJECTEXPLORERLISTVIEWTOOLBAR_H

#include <QLabel>
#include <QPushButton>
#include <QSlider>
#include <QWidget>

#include "common/define.h"

OLIVE_NAMESPACE_ENTER

/**
 * @brief A navigation bar widget for ProjectExplorer's Icon and List views
 *
 * Unlike the Tree view, Icon and List don't follow a hierarchical view of information. This means there is no direct
 * way of navigating in and out of folders in those view types. We solve this in two ways:
 *
 * * Double clicking a Folder in those views will enter that folder
 * * This navigation bar offers a "directory up" button for leaving a folder
 *
 * This navbar also provides an icon size slider for those views (between kProjectIconSizeMinimum and
 * kProjectIconSizeMaximum) as well as text that's intended to be set to the current Folder's name (or
 * empty for the root folder).
 *
 * This widget does not actually communicate to Project or ProjectExplorer classes. It is simply UI widgets that are
 * intended to be connected in ways that do. This is the primarily responsibility of ProjectExplorer.
 *
 * By default, the directory up button is disabled (assuming root folder), the text is empty, and the icon size slider
 * is set to kProjectIconSizeDefault.
 */
class ProjectExplorerNavigation : public QWidget
{
  Q_OBJECT
public:
  ProjectExplorerNavigation(QWidget* parent);

  /**
   * @brief Sets the text string
   *
   * This text is intended to be set to the current Folder's name
   *
   * @param s
   */
  void set_text(const QString& s);

  /**
   * @brief Set whether the "directory up" button is enabled or not
   *
   * @param e
   */
  void set_dir_up_enabled(bool e);

  /**
   * @brief Set the current value of the size slider
   *
   * NOTE: Does NOT emit SizeChanged().
   *
   * @param s
   *
   * New size value to set to
   */
  void set_size_value(int s);

signals:
  /**
   * @brief Signal emitted when the directory up button is clicked
   */
  void DirectoryUpClicked();

  /**
   * @brief Signal emitted when the icon size slider changes value
   *
   * @param size
   *
   * New size set in the slider
   */
  void SizeChanged(int size);

protected:
  virtual void changeEvent(QEvent *) override;

private:
  void Retranslate();

  void UpdateIcons();

  QPushButton* dir_up_btn_;

  QLabel* dir_lbl_;

  QSlider* size_slider_;
};

OLIVE_NAMESPACE_EXIT

#endif // PROJECTEXPLORERLISTVIEWTOOLBAR_H