BorderImage QML Type

该属性描述了如何重复或拉伸边框图像的中间部分。

每个属性的默认平铺模式都是BorderImage.Stretch。

currentFrame 是当前可见的框架。默认值为 。如果图像包含多个帧，可以将其设置为 和 之间的一个数字，以显示不同的帧。0 0 frameCount - 1

frameCount 是图像的帧数。大多数图像只有一帧。

指定本地文件系统上的图像应在单独的线程中异步加载。默认值为 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 支持的任何图像格式，从 Qt 支持的任何 URL 方案加载。

该属性还可用于引用 .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 。