EImage 图片
示例与代码
缩略图、翻转与下载
关闭下载入口
多图预览、缩放、旋转与键盘切图
图片
属性
closeOnPressEscapebool是否允许按 Escape 关闭。
trueenabledbool是否允许交互；false 时控件禁用。
trueerrorDelegateComponent自定义错误状态的 Component 插槽；null 使用默认内容。 委托上下文见本页示例。
nullerrorTextstring错误或加载失败的提示文字。
随当前语言变化fillModeint图片在可用空间中的缩放和填充方式。
Image.StretchImage.PreserveAspectFitImage.PreserveAspectCropImage.TileImage.TileVerticallyImage.TileHorizontallyImage.Pad
Image.PreserveAspectFitheightreal组件尺寸，单位为像素；可绑定父布局尺寸。
implicitHeighthideOnClickModalbool点击图片预览遮罩时关闭预览。
trueinfinitebool图片预览是否允许首尾循环切换。
trueinitialIndexint初始显示项的索引，从 0 开始。
0lazybool按需创建内容或加载数据；数据控件使用 load / lazyLoad。
falsemaxScalereal图片预览允许的最小或最大缩放倍数。
7minScalereal图片预览允许的最小或最大缩放倍数。
0.2placeholderDelegateComponent自定义图片加载占位的 Component 插槽；null 使用默认内容。 委托上下文见本页示例。
nullpreviewbool是否启用图片预览。
falsepreviewSrcListvar图片预览地址数组。
[]showProgressbool是否显示图片加载进度。
truesourceurl图片或媒体资源地址，支持 Qt 可加载的 URL。
""toolbarDelegateComponent自定义预览工具栏的 Component 插槽；null 使用默认内容。 委托上下文见本页示例。
nullviewerDelegateComponent自定义图片预览器的 Component 插槽；null 使用默认内容。 委托上下文见本页示例。
nullvisiblebool是否显示组件。
truewidthreal组件尺寸，单位为像素；可绑定父布局尺寸。
implicitWidthzoomRatereal每次图片缩放的倍率。
1.2previewIndexint只读当前预览图片索引。
由运行时计算previewRotationreal只读当前预览图片旋转角度。
由运行时计算previewScalereal只读当前预览图片缩放倍数。
由运行时计算previewSourcesvar只读实际可用的预览图片地址数组。
由运行时计算previewVisiblebool只读图片预览弹层是否打开。
由运行时计算statusint只读图片当前的加载状态。
Image.NullImage.ReadyImage.LoadingImage.Error
由运行时计算allowDownloadbool显示并启用预览图片保存入口。
trueshowThumbnailsbool预览时显示图片缩略图导航。
falsedownloadBusybool只读图片网络下载是否正在进行。
imageFiles.busypreviewFlippedVerticalbool只读预览图片是否已垂直翻转。
internal.flippedVerticalpreviewFlippedHorizontalbool只读预览图片是否已水平翻转。
internal.flippedHorizontal信号
loaded()图片加载成功后触发。
loadError()图片资源加载失败时触发，可用于显示替代内容。
previewShown()图片预览打开后触发。
previewClosed()图片预览关闭后触发。
previewRotated(real angle)预览图片旋转后触发，angle 为当前旋转角度。
previewSwitched(int index)切换预览图片后触发，index 为当前图片的索引。
downloaded(url destination)图片保存成功时触发，destination 为保存位置。
downloadFailed(string message)图片下载失败时触发，message 为错误信息。
方法
closePreview()关闭图片预览。
loadNow()立即加载图片，绕过等待进入可视区域的延迟。
showPreview(index)显示图片预览；index 指定初始图片。
resetPreview()恢复预览图片的初始缩放、旋转和翻转状态。
rotatePreview(angle)旋转预览图片，angle 为旋转角度。
flipPreview(vertical)翻转预览图片；vertical 为 true 时纵向翻转，否则横向翻转。
downloadPreview(destination)将当前预览图片保存到 destination。
zoomPreview(factor)按 factor 调整预览图片的缩放比例。
openPreview(index)打开图片预览；index 指定初始图片。
setActiveItem(index)将 value 或 index 指定的项目设为当前项。