class Label —— 显示文本。

Label 是用于显示文本的基本对象类型。

MicroPython 应用示例：

 1# SPDX-FileCopyrightText: 2024 M5Stack Technology CO LTD
 2#
 3# SPDX-License-Identifier: MIT
 4
 5import os, sys, io
 6import M5
 7from M5 import *
 8
 9
10label0 = None
11
12
13def setup():
14    global label0
15
16    M5.begin()
17    Widgets.fillScreen(0x222222)
18    label0 = Widgets.Label("Text", 38, 47, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
19
20    label0.setText(str("Label"))
21    label0.setFont(Widgets.FONTS.DejaVu12)
22
23
24def loop():
25    global label0
26    M5.update()
27
28
29if __name__ == "__main__":
30    try:
31        setup()
32        while True:
33            loop()
34    except (Exception, KeyboardInterrupt) as e:
35        try:
36            from utility import print_error_msg
37
38            print_error_msg(e)
39        except ImportError:
40            print("please update to latest firmware")

UiFlow2 应用示例：

example.png

cores3_label_example.m5f2

Constructors

class Widgets.Label(text: str, x: int, y: int, text_sz: float, text_c: int = 0xFFFFFF, bg_c: int = 0x000000, font=None, parent=None)

创建一个 Label 对象。它接受以下参数：

  • text 是要显示的文本。

  • x 为显示的起始 X 轴坐标。

  • y 为显示的起始 Y 轴坐标。

  • text_sz 是用于显示文本的字体大小，通常为 1.0。

  • text_c 是用于显示文本的字体颜色。默认值为白色。

  • bg_c 是显示文本的背景颜色，默认为黑色。

  • font 是用于显示文本的字体集合。对于内置字体，请参见 Widgets.FONTS。

  • parent 是 Label 对象的输出目标，默认输出到 LCD，也可以输出到 Canvas。

Methods

Label.setColor(text_c: int, bg_c: int = -1)

设置 Label 对象的文本字体颜色。接受以下参数：

  • text_c 是用于显示文本的字体颜色。

  • bg_c 是显示文本的背景颜色，默认为黑色。

UIFLOW2：

setColor.png

Label.setCursor(x: int, y: int)

设置 Label 对象的起始坐标。接受以下参数：

  • x 为显示的起始 X 轴坐标。

  • y 为显示的起始 Y 轴坐标。

UIFLOW2：

setCursor.png

Label.setFont(font)

设置 Label 对象的字体。

参数:

font – 支持内置字体和字体文件（例如 .bin （lvgl 二进制字体格式）或 .vlw （Processing 字体格式））。有关内置字体列表、状态以及设备支持的完整信息，请参见 Display.setFont() 。 Widgets.FONTS 使用的字体与 M5.Display 相同。

UIFLOW2：

setFont.png

Label.setSize(text_sz: float)

设置 Label 对象的文本字体大小，text_sz 为显示文本的字体大小。

UIFLOW2：

setSize.png

Label.setText(text: str)

设置 Label 对象的文本内容。

UIFLOW2：

setText.png

Label.setVisible(visible: bool)

设置 Label 对象的 visible 属性，当 visible 为 True 时，Label 对象内容将可见，否则将不可见。

UIFLOW2：

setVisible.png