Qt 文档

内容

可伸缩边界图像 QML 类型

Neptune 3 的可伸缩边界图像组件。更多信息...

自Qt 5.11
继承

Item

属性

详细描述

ScalableBorderImage 提供了一个根据 Sizes.scale 进行缩放的 BorderImage。它使 BorderImage 能够根据任何像素密度进行拉伸或缩小。

参见 Neptune 3 UI 组件和接口 了解更多可用的 Neptune 3 UI 组件。

示例用法

以下示例使用 ScalableBorderImage

import QtQuick 2.10
import shared.controls 1.0

Item {
    id: root

    ScalableBorderImage {
        id: topImage
        source: "app-fullscreen-top-bg"
    }
}

属性文档

asynchronous : bool

指定本地文件系统中的图像应异步在单独的线程中加载。默认值是 false，这会导致用户界面线程在图像加载时被阻塞。将 asynchronous 设置为 true 在保持响应式用户界面比立即显示图像更受欢迎时很有用。

请注意，此属性仅对从本地文件系统读取的图像有效。通过网络资源（例如 HTTP）加载的图像始终异步加载。


border : var

此属性包含工具列当前选中索引。

此属性的默认值是 0。


cache : bool

指定是否应缓存图像。默认值是 true。当处理大图像时，将 cache 设置为 false 是有用的，以确保不会以小“UI 元素”图像为代价进行缓存。


horizontalTileMode : 枚举

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


mirror : bool

此属性表示图像是否应水平翻转（实际上显示的是镜像图像）。

此属性的默认值为 false。


progress : real

此属性表示图像加载的进度，从 0.0（未加载任何内容）到 1.0（完成）。


smooth : bool

此属性表示在缩放或变换图像时是否对图像进行平滑滤波。平滑滤波可以提供更好的视觉效果，但在某些硬件上可能较慢。如果图像以其实际大小显示，此属性没有视觉或性能影响。

默认情况下，此属性设置为 true。


source : url

此属性用于保存引用源图像的 URL。

BorderImage 可以处理 Qt 支持的任何图像格式，并通过 Qt 支持的任何 URL 方案加载。

此属性也可以用来引用 .sci 文件，这些文件是以 QML 特定的文本格式编写的，用于指定边框、图像文件和特定边框图像的平铺规则。


sourceSize : QSize

此属性保存已加载图像的实际宽度和高度。


status : 枚举

此属性描述了图像加载的状态。可以是以下之一：


verticalTileMode : 枚举

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

  • BorderImage.Stretch - 缩放图像以适应可用区域。
  • BorderImage.Repeat - 直到没有更多空间为止，平铺图像。可能会裁剪最后一个图像。
  • BorderImage.Round - 类似于 Repeat，但将图像缩放下来以确保最后一个图像不会被裁剪。

©2019 Luxoft Sweden AB。本文件中包含的文档贡献归其各自的所有者拥有。
本文件提供的文档根据 Free Software Foundation 发布的 GNU Free Documentation License 版本 1.3 的条款进行许可。
Qt 和相应的标志是芬兰的 Qt Company Ltd. 以及世界其他地区的商标。所有其他商标均为其各自所有者的财产。