Qt 常用类 （9）—— QIcon

QIcon 类代表图标，实现在 QtGui 共享库中。QIcon 对象可以认为是一系列图像的组合，每个图像代表窗口在某种状态下应该1显示的图标。

构造

QIcon 类支持以下构造函数：

[plain] view
plaincopy

QIcon(); // 构造一个空图像构成的图标

QIcon(const QPixmap &pixmap); // 从 Pixmap 对象构造函数

QIcon(const QString &filename); // 从图像文件构造图标

当从 QPixmap 对象构造图标时，系统会自动产生窗口不同状态下对应的图像，比如窗口在禁用状态下其图标为灰色。从文件构造图标时，文件并不是立刻加载，而是当图标要显示时才加载。

添加图像

下面的成员函数可以从图像文件中向 QIcon 对象添加图像：

[plain] view
plaincopy

void addFile(const QString &filename, const QSize &size = QSize(), Mode mode = Normal, State state = Off);

其中各个参数的含义解释如下。

1）filename：文件名。

2）size：指定大小。

3）mode：指定使用模式，即窗口在何种状态下使用这个图像。

4）state：指定使用状态。

Mode 为 QIcon 类的成员类型，有以下取值。

1）QIcon::Normal：窗口为使能状态，但未激活。

2）QIcon::Disabled：窗口为禁用状态。

3）QIcon::Active：窗口为激活状态。

4）QIcon::Selected：窗口被选中。

当窗口的状态切换时，默认的图标绘制函数会自动根据窗口的状态重绘图标。如果窗口还有所谓的开关状态（比如一个按钮可以有按下和弹起两个状态），则还可以根据 state 参数来选择不同的图像。state 参数为 State 类型，这也是一个 QIcon 类的成员类型，它有以下取值。

QIcon::Off：窗口在关状态。

QIcon::On：窗口在开状态。

另外一个成员函数可以直接将 QPixmap 对象添加到 QIcon 对象中：

[plain] view
plaincopy

void addPixmap(const QPixmap &pixmap, Mode mode = Normal, State state = Off);

这里的 pixmap 参数是要添加的 QPixmap 对象，mode 参数和 state 参数的含义与 addFile 函数中相同。

获取图像

下面的成员函数可以获取 QIcon 对象中的图像：

[plain] view
plaincopy

QPixmap pixmap(const QSize &size, Mode mode = Normal, State state = Off) const;

其中参数 size 是指定的大小，参数 mode 和 state 则是使用模式和状态。这个函数还有以下重载版本：

[plain] view
plaincopy

QPixmap pixmap(int w, int h, Mode mode = Normal, State state = Off) const;

QPixmap pixmap(int extent, Mode mode = Normal, State state = Off) const;

它们分别等价于以下的函数调用：

[plain] view
plaincopy

pixmap(QSize(w, h), mode, state);

pixmap(QSize(extent,, extent), mode, state);

注意返回的图像大小可能比指定的小，但不会比指定的大。

判断

以下成员函数可以判断 QIcon 对象是否为空图像构成的图标：

[plain] view
plaincopy

bool isNull() const; // 判断是否为空图像构成的图标