QResource Class

メンバ関数のドキュメント

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 を持つリソースを、mapRoot で指定されたリソースツリー内の場所に登録し、ファイルのオープンに成功した場合はtrue を返し、失敗した場合はfalse を返します。

unregisterResource()も参照してください 。

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

指定されたrccData を、mapRoot で指定されたリソースツリー内の場所に登録し、ファイルのオープンに成功した場合はtrue を返し、失敗した場合はfalse を返します。

unregisterResource()も参照してください 。

void QResource::setFileName(const QString &file)

QResource をfile を指すように設定します。file は絶対パスでも相対パスでも指定できます。絶対パスの場合は直接開かれますが、相対パスの場合はQDir::searchPaths() からファイルが検索されます。

fileName() およびabsoluteFilePath()も参照してください 。

void QResource::setLocale(const QLocale &locale)

QResource を設定し、locale 向けのリソースのローカライズ版のみを読み込むようにします。特定のロケールに対応するリソースが見つからない場合は、C ロケールが使用されます。

locale() およびsetFileName()も参照してください 。

qint64 QResource::size() const

リソースの基盤となる保存データのサイズを返します。

リソースが圧縮されている場合、この関数は圧縮データのサイズを返します。非圧縮のサイズについては、uncompressedSize() を参照してください。

data()、uncompressedSize()、およびisFile()も参照してください 。

QByteArray QResource::uncompressedData() const

データが圧縮されて保存されている場合、まず解凍を行ってからリソースデータを返します。リソースがディレクトリである場合、または解凍中にエラーが発生した場合は、QByteArray が null として返されます。

関連項目： uncompressedSize()、size()、compressionAlgorithm()、およびisFile()。

qint64 QResource::uncompressedSize() const

このリソース内のデータのサイズを返します。データが圧縮されていない場合、この関数は `size()` と同じ値を返します。圧縮されている場合、この関数は保存されたストリームから元の非圧縮データのサイズを抽出します。

関連項目： size()、uncompressedData()、およびisFile()。

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

指定されたrccFileName を持つリソースを、mapRoot で指定されたリソースツリー内の場所から登録解除し、リソースのアンロードに成功し、そのリソースへの参照が存在しない場合はtrue を返し、そうでない場合はfalse を返します。

registerResource()も参照してください 。

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

指定されたrccData を持つリソースを、mapRoot で指定されたリソースツリー内の位置から登録解除します。リソースのアンロードに成功し、そのリソースへの参照が存在しない場合はtrue を返し、そうでない場合はfalse を返します。

registerResource()も参照してください 。