QPixmapCache Class

成员函数文档

[static] int QPixmapCache::cacheLimit()

返回缓存限制（单位为千字节）。

默认缓存限制为 10240 KB。

另请参阅 setCacheLimit()。

[static] void QPixmapCache::clear()

从缓存中移除所有像素图。

[static] bool QPixmapCache::find(const QPixmapCache::Key &key, QPixmap *pixmap)

在缓存中查找与给定的key 关联的缓存像素图。如果找到了该像素图，该函数将pixmap 设置为该像素图，并返回true ；否则，它保持pixmap 不变，并返回false 。如果未找到该像素图，则说明key 已失效，因此将释放该空间以供下次插入使用。

[static] bool QPixmapCache::find(const QString &key, QPixmap *pixmap)

在缓存中查找与给定的key 关联的缓存像素图。如果找到了该像素图，该函数将pixmap 设置为该像素图，并返回true ；否则，它保持pixmap 不变，并返回false 。

示例：

QPixmap pm;
if (!QPixmapCache::find("my_big_image", &pm)) {
    pm.load("bigimage.png");
    QPixmapCache::insert("my_big_image", pm);
}
painter->drawPixmap(0, 0, pm);

[static] QPixmapCache::Key QPixmapCache::insert(const QPixmap &pixmap)

将给定的pixmap 的副本插入缓存，并返回一个可用于检索该 的键。

当插入一个像素图时，如果缓存即将超过其上限，则会移除像素图，直到有足够的空间来插入该像素图为止。

当需要更多空间时，最旧的位图（在缓存中最近访问次数最少的）将被删除。

另请参阅 setCacheLimit()。

[static] bool QPixmapCache::insert(const QString &key, const QPixmap &pixmap)

将与key 关联的位图pixmap 的副本插入缓存。

Qt 库插入的所有位图的键名都以“$qt”开头，因此您自己的位图键名绝不能以“$qt”开头。

当插入一个像素图且缓存即将超过其限制时，系统会删除像素图，直到有足够的空间来插入该像素图为止。

当需要更多空间时，最旧的位图（在缓存中最近访问次数最少的）将被删除。

如果对象已插入缓存，该函数返回true ；否则返回false 。

另请参阅 setCacheLimit()。

[static] void QPixmapCache::remove(const QPixmapCache::Key &key)

从缓存中移除与 `key ` 关联的像素图，并释放该键以便将来插入。

[static] void QPixmapCache::remove(const QString &key)

从缓存中删除与key 关联的像素图。

[static] void QPixmapCache::setCacheLimit(int n)

将缓存限制设置为n 千字节。

默认设置为 10240 KB。

另请参阅 cacheLimit()。