HusAnimatedImage 动态图片

February 2, 2026 · View on GitHub

← 返回主目录

← 返回本类别目录

HusAnimatedImage 动态图片

可预览的动态图片。

  • 模块 { HuskarUI.Basic }

  • 继承自 { AnimatedImage }


支持的代理:


支持的属性:

属性名类型默认值描述
animationEnabledboolHusTheme.animationEnabled是否开启动画
previewEnabledbooltrue是否启用预览
hoveredbool(readonly)-鼠标是否悬浮
hoverCursorShapeintQt.PointingHandCursor悬浮时鼠标形状(来自 Qt.*Cursor)
fallbackurl''加载失败时显示的图像占位符
placeholderurl''加载时显示的图像占位符
itemsarray[]预览图片源

{items}支持的属性:

属性名类型可选/必选描述
urlurl必选图片源

代码演示

示例 1 - 基本用法

基本用法与 HusImage 一致。

import QtQuick
import HuskarUI.Basic

Column {
    spacing: 10

    HusSwitch {
        id: previewEnabledSwitch
        checkedText: 'Enable'
        uncheckedText: 'Disable'
        checked: true
    }

    HusAnimatedImage {
        width: 200
        height: width
        source: 'https://gw.alipayobjects.com/zos/rmsportal/LyTPSGknLUlxiVdwMWyu.gif'
        previewEnabled: previewEnabledSwitch.checked
    }
}