M5Spinner

M5Spinner 是一个环形上旋转的弧形，通常用于显示有某些操作正在进行中。

UiFlow2 示例

spinner

在 UiFlow2 中打开 core2_spinner_example.m5f2 项目。

本示例演示了一个在环形上旋转的弧形。

UiFlow2 代码块：

示例输出：

None

MicroPython 示例

spinner

本示例演示了一个在环形上旋转的弧形。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2025 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *
import m5ui
import lvgl as lv


page0 = None
spinner0 = None


def setup():
    global page0, spinner0

    M5.begin()
    Widgets.setRotation(1)
    m5ui.init()
    page0 = m5ui.M5Page(bg_c=0xFFFFFF)
    spinner0 = m5ui.M5Spinner(
        x=71,
        y=81,
        w=100,
        h=100,
        anim_t=10000,
        angle=180,
        bg_c=0xE7E3E7,
        bg_c_indicator=0x2193F3,
        parent=page0,
    )

    page0.screen_load()


def loop():
    global page0, spinner0
    M5.update()


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            m5ui.deinit()
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

示例输出：

None

API参考

M5Spinner

class m5ui.spinner.M5Spinner(*args, **kwargs)

基类：spinner

创建一个spinner对象。

参数:

x (int) – spinner的 x 坐标位置。
y (int) – spinner的 y 坐标位置。
w (int) – spinner的宽度。
h (int) – spinner的高度。
anim_t (int) – 动画时间（毫秒）。
angle (int) – spinner的角度（度）。
bg_c (int) – spinner的背景颜色（十六进制格式）。
bg_c_indicator (int) – spinner指示器的颜色（十六进制格式）。
parent (lv.obj) – 要附加spinner的父对象。如果未指定，spinner将附加到默认屏幕。

UiFlow2 代码块：

None

MicroPython 代码块：

from m5ui import M5Spinner
import lvgl as lv

m5ui.init()
spinner_0 = M5Spinner(x=120, y=80, w=60, h=30, anim_t=1000, angle=180, bg_c=0xE7E3E7, bg_c_indicator=0x0288FB, parent=page0)

set_flag(flag, value)

在对象上设置标志。如果 value 为 True，则添加标志；为 False 时移除标志。

参数:

flag (int) – 要设置的标志。
value (bool) – 为 True 时添加标志，为 False 时移除标志。

返回:

None

UiFlow2 代码块：

MicroPython 代码块：

spinner_0.set_flag(lv.obj.FLAG.HIDDEN, True)

set_pos(x, y)

设置spinner的位置。

参数:

x (int) – spinner的 x 坐标。
y (int) – spinner的 y 坐标。

UiFlow2 代码块：

MicroPython 代码块：

spinner_0.set_pos(100, 100)

set_x(x)

设置spinner的 x 坐标。

参数:: x (int) – spinner的 x 坐标。

UiFlow2 代码块：

MicroPython 代码块：

spinner_0.set_x(100)

set_y(y)

设置spinner的 y 坐标。

参数:: y (int) – spinner的 y 坐标。

UiFlow2 代码块：

MicroPython 代码块：

spinner_0.set_y(100)

set_size(width, height)

设置spinner的尺寸。

参数:

width (int) – spinner的宽度。
height (int) – spinner的高度。

UiFlow2 代码块：

MicroPython 代码块：

spinner_0.set_size(100, 50)

align_to(obj, align, x, y)

将spinner对齐到另一个对象。

参数:

obj (lv.obj) – 要对齐的对象。
align (int) – 对齐类型。
x (int) – 相对于对齐对象的 x 偏移量。
y (int) – 相对于对齐对象的 y 偏移量。

UiFlow2 代码块：

MicroPython 代码块：

spinner_0.align_to(page_0, lv.ALIGN.CENTER, 0, 0)

set_anim_params(anim_t, angle)

设置spinner的动画参数。

参数:

anim_t (int) – 动画时间（毫秒）。
angle (int) – spinner的角度（度）。

UiFlow2 代码块：

MicroPython 代码块：

spinner_0.set_anim_params(1000, 180)

set_spinner_color(color, opa, part)

设置spinner的颜色。

参数:

color (int) – spinner的颜色（十六进制格式）。
opa (int) – 颜色的不透明度（0-255）。
part (int) – 用于设置颜色的 spinner 部件。

UiFlow2 代码块：

MicroPython 代码块：

spinner_0.set_spinner_color(0x2196F3, 255, lv.PART.MAIN | lv.STATE.DEFAULT)