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

系统编程

开发平台:

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 QTOOLBUTTON_H
  38. #define QTOOLBUTTON_H
  39. #include <QtGui/qabstractbutton.h>
  40. QT_BEGIN_HEADER
  41. QT_BEGIN_NAMESPACE
  42. QT_MODULE(Gui)
  43. #ifndef QT_NO_TOOLBUTTON
  44. class QToolButtonPrivate;
  45. class QMenu;
  46. class QStyleOptionToolButton;
  47. class Q_GUI_EXPORT QToolButton : public QAbstractButton
  48. {
  49.     Q_OBJECT
  50.     Q_ENUMS(Qt::ToolButtonStyle Qt::ArrowType ToolButtonPopupMode)
  51. #ifndef QT_NO_MENU
  52.     Q_PROPERTY(ToolButtonPopupMode popupMode READ popupMode WRITE setPopupMode)
  53. #endif
  54.     Q_PROPERTY(Qt::ToolButtonStyle toolButtonStyle READ toolButtonStyle WRITE setToolButtonStyle)
  55.     Q_PROPERTY(bool autoRaise READ autoRaise WRITE setAutoRaise)
  56.     Q_PROPERTY(Qt::ArrowType arrowType READ arrowType WRITE setArrowType)
  57. public:
  58.     enum ToolButtonPopupMode {
  59.         DelayedPopup,
  60.         MenuButtonPopup,
  61.         InstantPopup
  62.     };
  63.     explicit QToolButton(QWidget * parent=0);
  64.     ~QToolButton();
  65.     QSize sizeHint() const;
  66.     QSize minimumSizeHint() const;
  67.     Qt::ToolButtonStyle toolButtonStyle() const;
  68.     Qt::ArrowType arrowType() const;
  69.     void setArrowType(Qt::ArrowType type);
  70. #ifndef QT_NO_MENU
  71.     void setMenu(QMenu* menu);
  72.     QMenu* menu() const;
  73.     void setPopupMode(ToolButtonPopupMode mode);
  74.     ToolButtonPopupMode popupMode() const;
  75. #endif
  76.     QAction *defaultAction() const;
  77.     void setAutoRaise(bool enable);
  78.     bool autoRaise() const;
  79. public Q_SLOTS:
  80. #ifndef QT_NO_MENU
  81.     void showMenu();
  82. #endif
  83.     void setToolButtonStyle(Qt::ToolButtonStyle style);
  84.     void setDefaultAction(QAction *);
  85. Q_SIGNALS:
  86.     void triggered(QAction *);
  87. protected:
  88.     QToolButton(QToolButtonPrivate &, QWidget* parent);
  89.     bool event(QEvent *e);
  90.     void mousePressEvent(QMouseEvent *);
  91.     void mouseReleaseEvent(QMouseEvent *);
  92.     void paintEvent(QPaintEvent *);
  93.     void actionEvent(QActionEvent *);
  94.     void enterEvent(QEvent *);
  95.     void leaveEvent(QEvent *);
  96.     void timerEvent(QTimerEvent *);
  97.     void changeEvent(QEvent *);
  98.     bool hitButton(const QPoint &pos) const;
  99.     void nextCheckState();
  100.     void initStyleOption(QStyleOptionToolButton *option) const;
  101. private:
  102.     Q_DISABLE_COPY(QToolButton)
  103.     Q_DECLARE_PRIVATE(QToolButton)
  104. #ifndef QT_NO_MENU
  105.     Q_PRIVATE_SLOT(d_func(), void _q_buttonPressed())
  106.     Q_PRIVATE_SLOT(d_func(), void _q_updateButtonDown())
  107.     Q_PRIVATE_SLOT(d_func(), void _q_menuTriggered(QAction*))
  108. #endif
  109.     Q_PRIVATE_SLOT(d_func(), void _q_actionTriggered())
  110. #ifdef QT3_SUPPORT
  111. public:
  112.     enum TextPosition {
  113.         BesideIcon,
  114.         BelowIcon
  115.         , Right = BesideIcon,
  116.         Under = BelowIcon
  117.     };
  118.     QT3_SUPPORT_CONSTRUCTOR QToolButton(QWidget * parent, const char* name);
  119.     QT3_SUPPORT_CONSTRUCTOR QToolButton(Qt::ArrowType type, QWidget *parent, const char* name);
  120.     QT3_SUPPORT_CONSTRUCTOR QToolButton( const QIcon& s, const QString &textLabel,
  121.                                        const QString& grouptext,
  122.                                        QObject * receiver, const char* slot,
  123.                                        QWidget * parent, const char* name=0 );
  124.     inline QT3_SUPPORT void setPixmap(const QPixmap &pixmap) { setIcon(static_cast<QIcon>(pixmap)); }
  125.     QT3_SUPPORT void setOnIconSet(const QIcon&);
  126.     QT3_SUPPORT void setOffIconSet(const QIcon&);
  127.     inline QT3_SUPPORT void setIconSet(const QIcon &icon){setIcon(icon);}
  128.     QT3_SUPPORT void setIconSet(const QIcon &, bool on);
  129.     inline QT3_SUPPORT void setTextLabel(const QString &text, bool tooltip = true) {
  130.         setText(text);
  131. #ifndef QT_NO_TOOLTIP
  132.         if (tooltip)
  133.             setToolTip(text);
  134. #else
  135.         Q_UNUSED(tooltip);
  136. #endif
  137.     }
  138.     inline QT3_SUPPORT QString textLabel() const { return text(); }
  139.     QT3_SUPPORT QIcon onIconSet() const;
  140.     QT3_SUPPORT QIcon offIconSet() const;
  141.     QT3_SUPPORT QIcon iconSet(bool on) const;
  142.     inline QT3_SUPPORT QIcon iconSet() const { return icon(); }
  143.     inline QT3_SUPPORT void openPopup()  { showMenu(); }
  144.     inline QT3_SUPPORT void setPopup(QMenu* popup) {setMenu(popup); }
  145.     inline QT3_SUPPORT QMenu* popup() const { return menu(); }
  146.     inline QT3_SUPPORT bool usesBigPixmap() const { return iconSize().height() > 22; }
  147.     inline QT3_SUPPORT bool usesTextLabel() const { return toolButtonStyle() != Qt::ToolButtonIconOnly; }
  148.     inline QT3_SUPPORT TextPosition textPosition() const
  149.     { return toolButtonStyle() == Qt::ToolButtonTextUnderIcon ? BelowIcon : BesideIcon; }
  150.     QT3_SUPPORT void setPopupDelay(int delay);
  151.     QT3_SUPPORT int popupDelay() const;
  152. public Q_SLOTS:
  153.     QT_MOC_COMPAT void setUsesBigPixmap(bool enable)
  154.         { setIconSize(enable?QSize(32,32):QSize(22,22)); }
  155.     QT_MOC_COMPAT void setUsesTextLabel(bool enable)
  156.         { setToolButtonStyle(enable?Qt::ToolButtonTextUnderIcon : Qt::ToolButtonIconOnly); }
  157.     QT_MOC_COMPAT void setTextPosition(QToolButton::TextPosition pos)
  158.         { setToolButtonStyle(pos == BesideIcon ? Qt::ToolButtonTextBesideIcon : Qt::ToolButtonTextUnderIcon); }
  159. #endif
  160. };
  161. #endif // QT_NO_TOOLBUTTON
  162. QT_END_NAMESPACE
  163. QT_END_HEADER
  164. #endif // QTOOLBUTTON_H