QResource 类

成员函数文档

QResource::QResource(const QString &file = QString(), const QLocale &locale = QLocale())

构建一个指向 file 的 QResource。使用 locale 加载资源数据的特定本地化。

参阅 QFileInfo、QDir::searchPaths、setFileName 和 setLocale。

[noexcept] QResource::~QResource()

释放 QResource 对象的资源。

QString QResource::absoluteFilePath() const

返回此 QResource 表示的实际路径，如果资源是通过 QDir::searchPaths() 找到的，则路径中将显示。

参阅 fileName。

[protected] QStringList QResource::children() const

返回此目录中所有资源的列表，如果资源表示文件，则列表为空。

参阅 isDir。

QResource::Compression QResource::compressionAlgorithm() const

返回此资源压缩使用的压缩类型（如果有）。如果没有压缩，此函数返回 QResource::NoCompression。

如果此函数返回 QResource::ZlibCompression，则可以使用 qUncompress() 函数解压缩数据。直到 Qt 5.13，这是唯一可能的压缩算法。

如果此函数返回 QResource::ZstdCompression，则需要使用 Zstandard 库函数（<zstd.h> 头）。Qt 不提供包装器。

参阅 Zstandard 用户手册。

参阅 data() 和 isFile。

const uchar *QResource::data() const

返回对由此资源表示的只读数据的直接访问。如果资源已压缩，则返回的数据也进行了压缩。调用者必须解压缩数据或使用 uncompressedData()。如果资源是目录，则返回 nullptr。

另请参阅 uncompressedData()、size() 和 isFile()。

QString QResource::fileName() const

返回此 QResource 表示的文件的完整路径，按照传递的方式。

另请参阅 setFileName() 和 absoluteFilePath()。

[protected] bool QResource::isDir() const

如果该资源表示目录并且可能在其内部有 children()，返回 true；如果表示文件，返回 false。

另请参阅 isFile()。

[protected] bool QResource::isFile() const

如果资源表示文件并且具有数据支持，返回 true；如果表示目录，返回 false。

参阅 isDir。

bool QResource::isValid() const

如果资源确实存在于资源层次结构中，返回 true；否则返回 false。

QDateTime QResource::lastModified() const

返回文件在上传到资源之前的最后修改日期和时间。

QLocale QResource::locale() const

返回用于定位 QResource 数据的区域设置。

另请参阅 setLocale()。

[static] bool QResource::registerResource(const QString &rccFileName, const QString &mapRoot = QString())

将在资源树中指定位置注册具有给定 rccFileName 的资源，如果文件成功打开则返回 true；否则返回 false。

另请参阅 unregisterResource()。

[static] bool QResource::registerResource(const uchar *rccData, const QString &mapRoot = QString())

在资源树中指定位置注册具有给定 rccData 的资源，如果文件成功打开则返回 true；否则返回 false。

另请参阅 unregisterResource()。

void QResource::setFileName(const QString &file)

设置 QResource 以指向 file。如果 file 是绝对的，则直接打开；如果是相对的，则将在 QDir::searchPaths() 中尝试找到文件。

另请参阅 fileName() 和 absoluteFilePath()。

void QResource::setLocale(const QLocale &locale)

将QResource设置为仅加载特定区域设置的资源本地化。如果未找到特定区域的资源，则使用C语言区域。

另请参阅 locale() 和 setFileName。

qint64 QResource::size() const

返回支持该资源的存储数据的尺寸。

如果资源被压缩，此函数返回压缩数据的尺寸。有关未压缩尺寸，请参阅 uncompressedSize。

另请参阅 data，uncompressedSize 和 isFile。

QByteArray QResource::uncompressedData() const

返回资源数据，如果数据已存储压缩，则先进行解压缩。如果资源是一个目录或解压缩过程中发生错误，则返回一个null QByteArray。

另请参阅 uncompressedSize，size，compressionAlgorithm 和 isFile。

qint64 QResource::uncompressedSize() const

返回该资源中数据的尺寸。如果数据未被压缩，则此函数返回的值与 size 相同。如果它已被压缩，则此函数从存储流中提取原始未压缩数据的尺寸。

另请参阅 size，uncompressedData 和 isFile。

[静态] bool QResource::unregisterResource(const QString &rccFileName, const QString &mapRoot = QString())

取消在资源树中通过 mapRoot 指定位置的具有给定 rccFileName 的资源注册，如果资源成功卸载且没有对资源的引用，则返回 true；否则返回 false。

另请参阅 registerResource。

[静态] bool QResource::unregisterResource(const uchar *rccData, const QString &mapRoot = QString())

取消通过给定 rccData 在资源树中通过 mapRoot 指定位置的资源的注册，如果资源成功卸载且没有对资源的引用，则返回《code translate="no">true；否则返回 false。

另请参阅 registerResource。