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

系统编程

开发平台:

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 QSPLITTER_H
  38. #define QSPLITTER_H
  39. #include <QtGui/qframe.h>
  40. #include <QtGui/qsizepolicy.h>
  41. QT_BEGIN_HEADER
  42. QT_BEGIN_NAMESPACE
  43. QT_MODULE(Gui)
  44. #ifndef QT_NO_SPLITTER
  45. class QSplitterPrivate;
  46. class QTextStream;
  47. template <typename T> class QList;
  48. class QSplitterHandle;
  49. class Q_GUI_EXPORT QSplitter : public QFrame
  50. {
  51.     Q_OBJECT
  52.     Q_PROPERTY(Qt::Orientation orientation READ orientation WRITE setOrientation)
  53.     Q_PROPERTY(bool opaqueResize READ opaqueResize WRITE setOpaqueResize)
  54.     Q_PROPERTY(int handleWidth READ handleWidth WRITE setHandleWidth)
  55.     Q_PROPERTY(bool childrenCollapsible READ childrenCollapsible WRITE setChildrenCollapsible)
  56. public:
  57.     explicit QSplitter(QWidget* parent = 0);
  58.     explicit QSplitter(Qt::Orientation, QWidget* parent = 0);
  59.     ~QSplitter();
  60.     void addWidget(QWidget *widget);
  61.     void insertWidget(int index, QWidget *widget);
  62.     void setOrientation(Qt::Orientation);
  63.     Qt::Orientation orientation() const;
  64.     void setChildrenCollapsible(bool);
  65.     bool childrenCollapsible() const;
  66.     void setCollapsible(int index, bool);
  67.     bool isCollapsible(int index) const;
  68.     void setOpaqueResize(bool opaque = true);
  69.     bool opaqueResize() const;
  70.     void refresh();
  71.     QSize sizeHint() const;
  72.     QSize minimumSizeHint() const;
  73.     QList<int> sizes() const;
  74.     void setSizes(const QList<int> &list);
  75.     QByteArray saveState() const;
  76.     bool restoreState(const QByteArray &state);
  77.     int handleWidth() const;
  78.     void setHandleWidth(int);
  79.     int indexOf(QWidget *w) const;
  80.     QWidget *widget(int index) const;
  81.     int count() const;
  82.     void getRange(int index, int *, int *) const;
  83.     QSplitterHandle *handle(int index) const;
  84.     void setStretchFactor(int index, int stretch);
  85. Q_SIGNALS:
  86.     void splitterMoved(int pos, int index);
  87. protected:
  88.     virtual QSplitterHandle *createHandle();
  89.     void childEvent(QChildEvent *);
  90.     bool event(QEvent *);
  91.     void resizeEvent(QResizeEvent *);
  92.     void changeEvent(QEvent *);
  93.     void moveSplitter(int pos, int index);
  94.     void setRubberBand(int position);
  95.     int closestLegalPosition(int, int);
  96. #ifdef QT3_SUPPORT
  97. public:
  98.     QT3_SUPPORT_CONSTRUCTOR QSplitter(QWidget* parent, const char* name);
  99.     QT3_SUPPORT_CONSTRUCTOR QSplitter(Qt::Orientation, QWidget* parent, const char* name);
  100.     enum ResizeMode { Stretch, KeepSize, FollowSizeHint, Auto };
  101.     QT3_SUPPORT void setResizeMode(QWidget *w, ResizeMode mode);
  102.     inline QT3_SUPPORT void moveToFirst(QWidget *w) { insertWidget(0,w); }
  103.     inline QT3_SUPPORT void moveToLast(QWidget *w) { addWidget(w); }
  104.     inline QT3_SUPPORT void setCollapsible(QWidget *w, bool collapse)
  105.     { setCollapsible(indexOf(w), collapse); }
  106.     QT3_SUPPORT void setMargin(int margin) { setContentsMargins(margin, margin, margin, margin); }
  107.     QT3_SUPPORT int margin() const 
  108.     { int margin; int dummy; getContentsMargins(&margin, &dummy, &dummy, &dummy);  return margin; }    
  109. #endif
  110. private:
  111.     Q_DISABLE_COPY(QSplitter)
  112.     Q_DECLARE_PRIVATE(QSplitter)
  113. private:
  114.     friend class QSplitterHandle;
  115. };
  116. //#ifdef QT3_SUPPORT
  117. #ifndef QT_NO_TEXTSTREAM
  118. Q_GUI_EXPORT QTextStream& operator<<(QTextStream&, const QSplitter&);
  119. Q_GUI_EXPORT QTextStream& operator>>(QTextStream&, QSplitter&);
  120. #endif
  121. //#endif
  122. class QSplitterHandlePrivate;
  123. class Q_GUI_EXPORT QSplitterHandle : public QWidget
  124. {
  125.     Q_OBJECT
  126. public:
  127.     QSplitterHandle(Qt::Orientation o, QSplitter *parent);
  128.     void setOrientation(Qt::Orientation o);
  129.     Qt::Orientation orientation() const;
  130.     bool opaqueResize() const;
  131.     QSplitter *splitter() const;
  132.     QSize sizeHint() const;
  133. protected:
  134.     void paintEvent(QPaintEvent *);
  135.     void mouseMoveEvent(QMouseEvent *);
  136.     void mousePressEvent(QMouseEvent *);
  137.     void mouseReleaseEvent(QMouseEvent *);
  138.     bool event(QEvent *);
  139.     void moveSplitter(int p);
  140.     int closestLegalPosition(int p);
  141. private:
  142.     Q_DISABLE_COPY(QSplitterHandle)
  143.     Q_DECLARE_PRIVATE(QSplitterHandle)
  144. };
  145. #endif // QT_NO_SPLITTER
  146. QT_END_NAMESPACE
  147. QT_END_HEADER
  148. #endif // QSPLITTER_H