/**************************************************************************** ** ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). ** All rights reserved. ** Contact: Nokia Corporation (qt-info@nokia.com) ** ** This file is part of the QtGui module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial Usage ** Licensees holding valid Qt Commercial licenses may use this file in ** accordance with the Qt Commercial License Agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and Nokia. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 2.1 requirements ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Nokia gives you certain additional ** rights. These rights are described in the Nokia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3.0 as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU General Public License version 3.0 requirements will be ** met: http://www.gnu.org/copyleft/gpl.html. ** ** If you have questions regarding the use of this file, please contact ** Nokia at qt-info@nokia.com. ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QICON_H #define QICON_H #include <QtCore/qglobal.h> #include <QtCore/qsize.h> #include <QtCore/qlist.h> #include <QtGui/qpixmap.h> QT_BEGIN_HEADER QT_BEGIN_NAMESPACE QT_MODULE(Gui) class QIconPrivate; class QIconEngine; class QIconEngineV2; class Q_GUI_EXPORT QIcon { public: enum Mode { Normal, Disabled, Active, Selected }; enum State { On, Off }; QIcon(); QIcon(const QPixmap &pixmap); QIcon(const QIcon &other); explicit QIcon(const QString &fileName); // file or resource name explicit QIcon(QIconEngine *engine); explicit QIcon(QIconEngineV2 *engine); ~QIcon(); QIcon &operator=(const QIcon &other); operator QVariant() const; QPixmap pixmap(const QSize &size, Mode mode = Normal, State state = Off) const; inline QPixmap pixmap(int w, int h, Mode mode = Normal, State state = Off) const { return pixmap(QSize(w, h), mode, state); } inline QPixmap pixmap(int extent, Mode mode = Normal, State state = Off) const { return pixmap(QSize(extent, extent), mode, state); } QSize actualSize(const QSize &size, Mode mode = Normal, State state = Off) const; void paint(QPainter *painter, const QRect &rect, Qt::Alignment alignment = Qt::AlignCenter, Mode mode = Normal, State state = Off) const; 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 { paint(painter, QRect(x, y, w, h), alignment, mode, state); } bool isNull() const; bool isDetached() const; void detach(); int serialNumber() const; qint64 cacheKey() const; void addPixmap(const QPixmap &pixmap, Mode mode = Normal, State state = Off); void addFile(const QString &fileName, const QSize &size = QSize(), Mode mode = Normal, State state = Off); QList<QSize> availableSizes(Mode mode = Normal, State state = Off) const; static QIcon fromTheme(const QString &name, const QIcon &fallback = QIcon()); static bool hasThemeIcon(const QString &name); static QStringList themeSearchPaths(); static void setThemeSearchPaths(const QStringList &searchpath); static QString themeName(); static void setThemeName(const QString &path); #ifdef QT3_SUPPORT enum Size { Small, Large, Automatic = Small }; static QT3_SUPPORT void setPixmapSize(Size which, const QSize &size); static QT3_SUPPORT QSize pixmapSize(Size which); inline QT3_SUPPORT void reset(const QPixmap &pixmap, Size /*size*/) { *this = QIcon(pixmap); } inline QT3_SUPPORT void setPixmap(const QPixmap &pixmap, Size, Mode mode = Normal, State state = Off) { addPixmap(pixmap, mode, state); } inline QT3_SUPPORT void setPixmap(const QString &fileName, Size, Mode mode = Normal, State state = Off) { addPixmap(QPixmap(fileName), mode, state); } QT3_SUPPORT QPixmap pixmap(Size size, Mode mode, State state = Off) const; QT3_SUPPORT QPixmap pixmap(Size size, bool enabled, State state = Off) const; QT3_SUPPORT QPixmap pixmap() const; #endif Q_DUMMY_COMPARISON_OPERATOR(QIcon) private: QIconPrivate *d; #if !defined(QT_NO_DATASTREAM) friend Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QIcon &); friend Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QIcon &); #endif public: typedef QIconPrivate * DataPtr; inline DataPtr &data_ptr() { return d; } }; Q_DECLARE_SHARED(QIcon) Q_DECLARE_TYPEINFO(QIcon, Q_MOVABLE_TYPE); #if !defined(QT_NO_DATASTREAM) Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QIcon &); Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QIcon &); #endif #ifdef QT3_SUPPORT typedef QIcon QIconSet; #endif QT_END_NAMESPACE QT_END_HEADER #endif // QICON_H