pqViewFrame.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Copyright (c) Kitware Inc.
// SPDX-FileCopyrightText: Copyright (c) Sandia Corporation
// SPDX-License-Identifier: BSD-3-Clause
#ifndef pqViewFrame_h
#define pqViewFrame_h
 
#include "pqComponentsModule.h"
#include <QMap>
#include <QPointer>
#include <QScopedPointer>
#include <QUuid>
#include <QWidget>
 
class QDragEnterEvent;
class QDragMoveEvent;
class QDropEvent;
class QFrame;
class QLabel;
class QMenu;
class QToolBar;
class QToolButton;
class pqServerManagerModelItem;
class pqView;
 
class PQCOMPONENTS_EXPORT pqViewFrame : public QWidget
{
  Q_OBJECT
  typedef QWidget Superclass;
 
public:
  pqViewFrame(QWidget* parent = nullptr);
  ~pqViewFrame() override;
 
  void setTitle(const QString& text);
  QString title() const;
 
  void setCentralWidget(QWidget* widget, pqView* view = nullptr);
  QWidget* centralWidget() const;
 
  void setBorderColor(const QColor& clr);
  const QColor& borderColor() const { return this->BorderColor; }
 
  bool isBorderVisible() const { return this->BorderVisible; }
 
  bool isTitleBarVisible() const { return this->TitleBarVisible; }
 
  enum StandardButton
  {
    NoButton = 0x0000,
    SplitHorizontal = 0x0001,
    SplitVertical = 0x0002,
    Maximize = 0x0004,
    Restore = 0x0008,
    Close = 0x0010
  };
 
  Q_DECLARE_FLAGS(StandardButtons, StandardButton);
 
  void setStandardButtons(StandardButtons buttons);
  StandardButtons standardButtons() const { return this->Buttons; }
 
  void addTitleBarAction(QAction* action);
  QAction* addTitleBarAction(const QString& title);
  QAction* addTitleBarAction(const QIcon& icon, const QString& title);
 
  QAction* addTitleBarSeparator();
 
  void removeTitleBarActions();
 
  QMenu* contextMenu() const;
 
  QUuid uniqueID() const { return this->UniqueID; }
 
Q_SIGNALS:
  void buttonPressed(int button);
 
  void actionTriggered(QAction* action);
 
  void swapPositions(const QString& other);
 
  void finishDrag(pqViewFrame* source);
 
public Q_SLOTS:
  void setBorderVisibility(bool val)
  {
    this->BorderVisible = val;
    this->updateComponentVisibilities();
  }
 
  void setTitleBarVisibility(bool val)
  {
    this->TitleBarVisible = val;
    this->updateComponentVisibilities();
  }
 
  void setDecorationsVisibility(bool val)
  {
    this->DecorationsVisible = val;
    this->updateComponentVisibilities();
  }
 
  void onViewNameChanged(pqServerManagerModelItem*);
 
  bool eventFilter(QObject*, QEvent*) override;
 
protected:
  virtual void updateComponentVisibilities();
 
  void drag();
  void dragEnter(QDragEnterEvent*);
  void drop(QDropEvent*);
 
protected Q_SLOTS: // NOLINT(readability-redundant-access-specifiers)
  void buttonClicked();
  void contextMenuRequested(const QPoint&);
 
protected: // NOLINT(readability-redundant-access-specifiers)
  bool DecorationsVisible;
  bool TitleBarVisible;
  bool BorderVisible;
  QColor BorderColor;
  StandardButtons Buttons;
  QPointer<QToolBar> ToolBar;
  QPointer<QWidget> CentralWidget;
  QPointer<QMenu> ContextMenu;
  QUuid UniqueID;
  QPoint DragStartPosition;
  typedef QMap<StandardButton, QPointer<QToolButton>> StandardToolButtonsMap;
  StandardToolButtonsMap StandardToolButtons;
  QPalette PaletteWithBorder;
  QPalette PaletteWithoutBorder;
  QString PlainTitle;
 
private:
  Q_DISABLE_COPY(pqViewFrame)
 
  
  QToolButton* createButton(QAction* action);
 
  class pqInternals;
  const QScopedPointer<pqInternals> Internals;
private Q_SLOTS: // NOLINT(readability-redundant-access-specifiers)
  void finishedDrag(pqViewFrame* source);
};
 
Q_DECLARE_OPERATORS_FOR_FLAGS(pqViewFrame::StandardButtons);
 
#endif