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() 和replace()。

[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 KB。

默认设置为 10240 KB。

另请参阅 cacheLimit().