BorderImage QML Type

This property describes how to repeat or stretch the middle parts of the border image.

The default tile mode for each property is BorderImage.Stretch.

currentFrame is the frame that is currently visible. The default is 0. You can set it to a number between 0 and frameCount - 1 to display a different frame, if the image contains multiple frames.

frameCount is the number of frames in the image. Most images have only one frame.

Specifies that images on the local filesystem should be loaded asynchronously in a separate thread. The default value is false, causing the user interface thread to block while the image is loaded. Setting asynchronous to true is useful where maintaining a responsive user interface is more desirable than having images immediately visible.

Note that this property is only valid for images read from the local filesystem. Images loaded via a network resource (e.g. HTTP) are always loaded asynchronously.

The 4 border lines (2 horizontal and 2 vertical) break the image into 9 sections, as shown below:

Each border line (left, right, top, and bottom) specifies an offset in pixels from the respective edge of the source image. By default, each border line has a value of 0.

For example, the following definition sets the bottom line 10 pixels up from the bottom of the image:

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

The border lines can also be specified using a .sci file.

Specifies whether the image should be cached. The default value is true. Setting cache to false is useful when dealing with large images, to make sure that they aren't cached at the expense of small 'ui element' images.

This property holds whether the image should be horizontally inverted (effectively displaying a mirrored image).

The default value is false.

This property holds the progress of image loading, from 0.0 (nothing loaded) to 1.0 (finished).

See also status.

This property defines the behavior when the source property is changed and loading happens asynchronously. This is the case when the asynchronous property is set to true, or if the image is not on the local file system.

If retainWhileLoading is false (the default), the old image is discarded immediately, and the component is cleared while the new image is being loaded. If set to true, the old image is retained and remains visible until the new one is ready.

Enabling this property can avoid flickering in cases where loading the new image takes a long time. It comes at the cost of some extra memory use for double buffering while the new image is being loaded.

This property was introduced in Qt 6.8.

This property holds whether the image is smoothly filtered when scaled or transformed. Smooth filtering gives better visual quality, but it may be slower on some hardware. If the image is displayed at its natural size, this property has no visual or performance effect.

By default, this property is set to true.

This property holds the URL that refers to the source image.

BorderImage can handle any image format supported by Qt, loaded from any URL scheme supported by Qt.

This property can also be used to refer to .sci files, which are written in a QML-specific, text-based format that specifies the borders, the image file and the tile rules for a given border image.

The following .sci file sets the borders to 10 on each side for the image picture.png:

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

The URL may be absolute, or relative to the URL of the component.

See also QQuickImageProvider.

This property holds the actual width and height of the loaded image.

In BorderImage, this property is read-only.

See also Image::sourceSize.

This property describes the status of image loading. It can be one of:

See also progress.