BorderImage QML Type

このプロパティは、ボーダー画像の中間部分を繰り返したり伸ばしたりする方法を記述します。

各プロパティのデフォルトのタイルモードはBorderImage.Stretchです。

currentFrame は現在表示されているフレームです。デフォルトは です。画像に複数のフレームが含まれている場合は、 と の間の数値を設定することで、別のフレームを表示することができます。0 0 frameCount - 1

frameCount は画像のフレーム数です。たいていの画像にはフレームが1つしかありません。

ローカルファイルシステム上の画像を別スレッドで非同期に読み込むかどうかを指定します。デフォルト値はfalseで、画像の読み込み中にユーザーインターフェイスのスレッドがブロックされます。asynchronous を true に設定すると、画像がすぐに表示されることよりも、レスポンシブなユーザインタフェースを維持する方が望ましい場合に便利です。

このプロパティは、ローカルファイルシステムから読み込まれた画像に対してのみ有効であることに注意してください。ネットワークリソース（HTTPなど）を介して読み込まれた画像は、常に非同期で読み込まれます。

4本のボーダーライン（水平2本、垂直2本）は、下図のように画像を9つのセクションに分割します：

各ボーダーライン（左、右、上、下）は、ソース画像のそれぞれのエッジからのオフセットをピクセル単位で指定します。デフォルトでは、各ボーダーラインの値は 0 です。

たとえば、次の定義では、下端を画像の下端から 10 ピクセル上に設定しています：

BorderImage {
    border.bottom: 10
    // ...
}

ボーダーラインは.sci file を使って指定することもできます。

画像をキャッシュするかどうかを指定します。デフォルト値はtrueです。cache を false に設定すると、大きな画像を扱うときに、小さな 'ui 要素' 画像を犠牲にしてキャッシュされないようにするのに便利です。

このプロパティは、画像を水平方向に反転させる（効果的にミラー画像を表示する）かどうかを保持します。

デフォルト値は false です。

このプロパティは、0.0（何もロードされていない状態）から 1.0（ロードが完了した状態）までの、画像のロードの進行状況を保持します。

statusも参照してください 。

このプロパティは、source プロパティが変更され、読み込みが非同期で行われる場合の動作を定義します。これは、asynchronous プロパティがtrue に設定されている場合、または画像がローカル・ファイル・システム上にない場合です。

retainWhileLoading がfalse （デフォルト）の場合、古い画像は即座に破棄され、新しい画像のロード中にコンポーネントはクリアされます。true に設定すると、古い画像は保持され、新しい画像の準備ができるまで表示されたままになります。

このプロパティを有効にすると、新しい画像の読み込みに時間がかかる場合にちらつきを避けることができます。その代償として、新しい画像がロードされている間、二重のバッファリングのためにメモリが余分に使用されます。

このプロパティは Qt 6.8 で導入されました。

このプロパティは、拡大縮小や変形時に画像をスムースフィルタリングするかどうかを保持します。スムースフィルタリングはより良いビジュアル品質を提供しますが、ハードウェアによっては遅くなる場合があります。画像が自然なサイズで表示される場合、このプロパティは視覚的にもパフォーマンス的にも影響を与えません。

デフォルトでは、このプロパティはtrueに設定されています。

このプロパティは、ソース画像を参照する URL を保持します。

BorderImage は、Qt がサポートする URL スキームからロードされた、Qt がサポートするあらゆる画像フォーマットを扱うことができます。

このプロパティは、.sci ファイルを参照するためにも使用できます。.sci ファイルは、QML 固有のテキストベースのフォーマットで記述され、ボーダー、画像ファイル、および指定されたボーダー画像のタイルルールを指定します。

次の.sciファイルは、画像picture.png のボーダーを各辺10に設定しています：

border.left: 10
border.top: 10
border.bottom: 10
border.right: 10
source: "picture.png"

URLは絶対URLでも、コンポーネントのURLからの相対URLでもかまいません。

QQuickImageProviderも参照して ください。

このプロパティは、読み込まれた画像の実際の幅と高さを保持します。

BorderImage では、このプロパティは読み取り専用です。

Image::sourceSizeも参照 。

このプロパティは、画像のロード状態を記述します。以下のいずれかです：

progressも参照してください 。