File indexing completed on 2024-06-02 03:47:32

 #ifndef DockWidgetTabH
 #define DockWidgetTabH
 /*******************************************************************************
 ** Qt Advanced Docking System
 ** Copyright (C) 2017 Uwe Kindler
 **
 ** This library is free software; you can redistribute it and/or
 ** modify it under the terms of the GNU Lesser General Public
 ** License as published by the Free Software Foundation; either
 ** version 2.1 of the License, or (at your option) any later version.
 **
 ** This library 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
 ** Lesser General Public License for more details.
 **
 ** You should have received a copy of the GNU Lesser General Public
 ** License along with this library; If not, see <http://www.gnu.org/licenses/>.
 ******************************************************************************/
 
 
 //============================================================================
 /// \file   DockWidgetTab.h
 /// \author Uwe Kindler
 /// \date   27.02.2017
 /// \brief  Declaration of CDockWidgetTab class
 //============================================================================
 
 
 //============================================================================
 //                                   INCLUDES
 //============================================================================
 #include <QFrame>
 #include <QSize>
 
 #include "ads_globals.h"
 
 namespace ads
 {
 class CDockWidget;
 class CDockAreaWidget;
 struct DockWidgetTabPrivate;
 class CDockManager;
 
 /**
  * A dock widget tab that shows a title and an icon.
  * The dock widget tab is shown in the dock area title bar to switch between
  * tabbed dock widgets
  */
 class ADS_EXPORT CDockWidgetTab : public QFrame
 {
     Q_OBJECT
     Q_PROPERTY(bool activeTab READ isActiveTab WRITE setActiveTab NOTIFY activeTabChanged)
     Q_PROPERTY(QSize iconSize READ iconSize WRITE setIconSize)
 
 private:
     DockWidgetTabPrivate* d; ///< private data (pimpl)
     friend struct DockWidgetTabPrivate;
     friend class CDockWidget;
     friend class CDockManager;
     friend class CAutoHideDockContainer;
     void onDockWidgetFeaturesChanged();
 
 private Q_SLOTS:
     void detachDockWidget();
     void autoHideDockWidget();
     void onAutoHideToActionClicked();
 
 protected:
     virtual void mousePressEvent(QMouseEvent* ev) override;
     virtual void mouseReleaseEvent(QMouseEvent* ev) override;
     virtual void mouseMoveEvent(QMouseEvent* ev) override;
     virtual void contextMenuEvent(QContextMenuEvent* ev) override;
 
     /**
      * Double clicking the tab widget makes the assigned dock widget floating
      */
     virtual void mouseDoubleClickEvent(QMouseEvent *event) override;
 
 public:
     using Super = QFrame;
     /**
      * Default Constructor
      * param[in] DockWidget The dock widget this title bar belongs to
      * param[in] parent The parent widget of this title bar
      */
     CDockWidgetTab(CDockWidget* DockWidget, QWidget* parent = nullptr);
 
     /**
      * Virtual Destructor
      */
     virtual ~CDockWidgetTab();
 
     /**
      * Returns true, if this is the active tab
      */
     bool isActiveTab() const;
 
     /**
      * Set this true to make this tab the active tab
      */
     void setActiveTab(bool active);
 
     /**
      * Sets the dock area widget the dockWidget returned by dockWidget()
      * function belongs to.
      */
     void setDockAreaWidget(CDockAreaWidget* DockArea);
 
     /**
      * Returns the dock area widget this title bar belongs to.
      * \return This function returns 0 if the dock widget that owns this title
      * bar widget has not been added to any dock area yet.
      */
     CDockAreaWidget* dockAreaWidget() const;
 
     /**
      * Returns the dock widget this title widget belongs to
      */
     CDockWidget* dockWidget() const;
 
     /**
      * Sets the icon to show in title bar
      */
     void setIcon(const QIcon& Icon);
 
     /**
      * Returns the icon
      */
     const QIcon& icon() const;
 
     /**
      * Returns the tab text
      */
     QString text() const;
 
     /**
      * Sets the tab text
      */
     void setText(const QString& title);
 
     /**
      * Returns true if text is elided on the tab's title
      */
     bool isTitleElided() const;
 
     /**
      * This function returns true if the assigned dock widget is closable
      */
     bool isClosable() const;
 
     /**
     * Track event ToolTipChange and set child ToolTip 
     */
     virtual bool event(QEvent *e) override;
 
     /**
      * Sets the text elide mode
      */
     void setElideMode(Qt::TextElideMode mode);
 
     /**
      * Update stylesheet style if a property changes
      */
     void updateStyle();
 
     /**
      * Returns the icon size.
      * If no explicit icon size has been set, the function returns an invalid
      * QSize
      */
     QSize iconSize() const;
 
     /**
      * Set an explicit icon size.
      * If no icon size has been set explicitly, than the tab sets the icon size
      * depending on the style
      */
     void setIconSize(const QSize& Size);
 
 public Q_SLOTS:
     virtual void setVisible(bool visible) override;
 
 Q_SIGNALS:
     void activeTabChanged();
     void clicked();
     void closeRequested();
     void closeOtherTabsRequested();
     void moved(const QPoint& GlobalPos);
     void elidedChanged(bool elided);
 }; // class DockWidgetTab
 }
  // namespace ads
 //-----------------------------------------------------------------------------
 #endif // DockWidgetTabH