qicon.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 QICON_H
  38. #define QICON_H
  39. #include <QtCore/qglobal.h>
  40. #include <QtCore/qsize.h>
  41. #include <QtGui/qpixmap.h>
  42. QT_BEGIN_HEADER
  43. QT_BEGIN_NAMESPACE
  44. QT_MODULE(Gui)
  45. class QIconPrivate;
  46. class QIconEngine;
  47. class QIconEngineV2;
  48. class Q_GUI_EXPORT QIcon
  49. {
  50. public:
  51.     enum Mode { Normal, Disabled, Active, Selected };
  52.     enum State { On, Off };
  53.     QIcon();
  54.     QIcon(const QPixmap &pixmap);
  55.     QIcon(const QIcon &other);
  56.     explicit QIcon(const QString &fileName); // file or resource name
  57.     explicit QIcon(QIconEngine *engine);
  58.     explicit QIcon(QIconEngineV2 *engine);
  59.     ~QIcon();
  60.     QIcon &operator=(const QIcon &other);
  61.     operator QVariant() const;
  62.     QPixmap pixmap(const QSize &size, Mode mode = Normal, State state = Off) const;
  63.     inline QPixmap pixmap(int w, int h, Mode mode = Normal, State state = Off) const
  64.         { return pixmap(QSize(w, h), mode, state); }
  65.     inline QPixmap pixmap(int extent, Mode mode = Normal, State state = Off) const
  66.         { return pixmap(QSize(extent, extent), mode, state); }
  67.     QSize actualSize(const QSize &size, Mode mode = Normal, State state = Off) const;
  68.     void paint(QPainter *painter, const QRect &rect, Qt::Alignment alignment = Qt::AlignCenter, Mode mode = Normal, State state = Off) const;
  69.     inline void paint(QPainter *painter, int x, int y, int w, int h, Qt::Alignment alignment = Qt::AlignCenter, Mode mode = Normal, State state = Off) const
  70.         { paint(painter, QRect(x, y, w, h), alignment, mode, state); }
  71.     bool isNull() const;
  72.     bool isDetached() const;
  73.     void detach();
  74.     int serialNumber() const;
  75.     qint64 cacheKey() const;
  76.     void addPixmap(const QPixmap &pixmap, Mode mode = Normal, State state = Off);
  77.     void addFile(const QString &fileName, const QSize &size = QSize(), Mode mode = Normal, State state = Off);
  78. #ifdef QT3_SUPPORT
  79.     enum Size { Small, Large, Automatic = Small };
  80.     static QT3_SUPPORT void setPixmapSize(Size which, const QSize &size);
  81.     static QT3_SUPPORT QSize pixmapSize(Size which);
  82.     inline QT3_SUPPORT void reset(const QPixmap &pixmap, Size /*size*/) { *this = QIcon(pixmap); }
  83.     inline QT3_SUPPORT void setPixmap(const QPixmap &pixmap, Size, Mode mode = Normal, State state = Off)
  84.         { addPixmap(pixmap, mode, state); }
  85.     inline QT3_SUPPORT void setPixmap(const QString &fileName, Size, Mode mode = Normal, State state = Off)
  86.         { addPixmap(QPixmap(fileName), mode, state); }
  87.     QT3_SUPPORT QPixmap pixmap(Size size, Mode mode, State state = Off) const;
  88.     QT3_SUPPORT QPixmap pixmap(Size size, bool enabled, State state = Off) const;
  89.     QT3_SUPPORT QPixmap pixmap() const;
  90. #endif
  91.     Q_DUMMY_COMPARISON_OPERATOR(QIcon)
  92. private:
  93.     QIconPrivate *d;
  94. #if !defined(QT_NO_DATASTREAM)
  95.     friend Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QIcon &);
  96.     friend Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QIcon &);
  97. #endif
  98. public:
  99.     typedef QIconPrivate * DataPtr;
  100.     inline DataPtr &data_ptr() { return d; }
  101. };
  102. Q_DECLARE_SHARED(QIcon)
  103. Q_DECLARE_TYPEINFO(QIcon, Q_MOVABLE_TYPE);
  104. #if !defined(QT_NO_DATASTREAM)
  105. Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QIcon &);
  106. Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QIcon &);
  107. #endif
  108. #ifdef QT3_SUPPORT
  109. typedef QIcon QIconSet;
  110. #endif
  111. QT_END_NAMESPACE
  112. QT_END_HEADER
  113. #endif // QICON_H