qdockwidget.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:5k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtGui module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QDYNAMICDOCKWIDGET_H
  38. #define QDYNAMICDOCKWIDGET_H
  39. #include <QtGui/qwidget.h>
  40. QT_BEGIN_HEADER
  41. QT_BEGIN_NAMESPACE
  42. QT_MODULE(Gui)
  43. #ifndef QT_NO_DOCKWIDGET
  44. class QDockAreaLayout;
  45. class QDockWidgetPrivate;
  46. class QMainWindow;
  47. class QStyleOptionDockWidget;
  48. class Q_GUI_EXPORT QDockWidget : public QWidget
  49. {
  50.     Q_OBJECT
  51.     Q_FLAGS(DockWidgetFeatures)
  52.     Q_PROPERTY(bool floating READ isFloating WRITE setFloating)
  53.     Q_PROPERTY(DockWidgetFeatures features READ features WRITE setFeatures NOTIFY featuresChanged)
  54.     Q_PROPERTY(Qt::DockWidgetAreas allowedAreas READ allowedAreas
  55.                WRITE setAllowedAreas NOTIFY allowedAreasChanged)
  56.     Q_PROPERTY(QString windowTitle READ windowTitle WRITE setWindowTitle DESIGNABLE true)
  57. public:
  58.     explicit QDockWidget(const QString &title, QWidget *parent = 0, Qt::WindowFlags flags = 0);
  59.     explicit QDockWidget(QWidget *parent = 0, Qt::WindowFlags flags = 0);
  60.     ~QDockWidget();
  61.     QWidget *widget() const;
  62.     void setWidget(QWidget *widget);
  63.     enum DockWidgetFeature {
  64.         DockWidgetClosable    = 0x01,
  65.         DockWidgetMovable     = 0x02,
  66.         DockWidgetFloatable   = 0x04,
  67.         DockWidgetVerticalTitleBar = 0x08,
  68.         DockWidgetFeatureMask = 0x0f,
  69.         AllDockWidgetFeatures = DockWidgetClosable|DockWidgetMovable|DockWidgetFloatable, // ### remove in 5.0
  70.         NoDockWidgetFeatures  = 0x00,
  71.         Reserved              = 0xff
  72.     };
  73.     Q_DECLARE_FLAGS(DockWidgetFeatures, DockWidgetFeature)
  74.     void setFeatures(DockWidgetFeatures features);
  75.     DockWidgetFeatures features() const;
  76.     void setFloating(bool floating);
  77.     inline bool isFloating() const { return isWindow(); }
  78.     void setAllowedAreas(Qt::DockWidgetAreas areas);
  79.     Qt::DockWidgetAreas allowedAreas() const;
  80.     void setTitleBarWidget(QWidget *widget);
  81.     QWidget *titleBarWidget() const;
  82.     inline bool isAreaAllowed(Qt::DockWidgetArea area) const
  83.     { return (allowedAreas() & area) == area; }
  84. #ifndef QT_NO_ACTION
  85.     QAction *toggleViewAction() const;
  86. #endif
  87. Q_SIGNALS:
  88.     void featuresChanged(QDockWidget::DockWidgetFeatures features);
  89.     void topLevelChanged(bool topLevel);
  90.     void allowedAreasChanged(Qt::DockWidgetAreas allowedAreas);
  91.     void visibilityChanged(bool visible);
  92.     void dockLocationChanged(Qt::DockWidgetArea area);
  93. protected:
  94.     void changeEvent(QEvent *event);
  95.     void closeEvent(QCloseEvent *event);
  96.     void paintEvent(QPaintEvent *event);
  97.     bool event(QEvent *event);
  98.     void initStyleOption(QStyleOptionDockWidget *option) const;
  99. private:
  100.     Q_DECLARE_PRIVATE(QDockWidget)
  101.     Q_DISABLE_COPY(QDockWidget)
  102.     Q_PRIVATE_SLOT(d_func(), void _q_toggleView(bool))
  103.     Q_PRIVATE_SLOT(d_func(), void _q_toggleTopLevel())
  104.     friend class QDockAreaLayout;
  105.     friend class QDockWidgetItem;
  106.     friend class QMainWindowLayout;
  107.     friend class QDockWidgetLayout;
  108.     friend class QDockAreaLayoutInfo;
  109. };
  110. Q_DECLARE_OPERATORS_FOR_FLAGS(QDockWidget::DockWidgetFeatures)
  111. #endif // QT_NO_DOCKWIDGET
  112. QT_END_NAMESPACE
  113. QT_END_HEADER
  114. #endif // QDYNAMICDOCKWIDGET_H