静态文本（label）

此控件为V2.3新增，用于替换原来的 text

功能

label控件用于在页面中显示任意静态文本。所有不会更改的说明性文字、标识性字符都可以使用label控件，例如坐标轴名称、文字描述、符号等。通过合适的布局，label控件可以作为其他控件的说明性文本。

参数

  • 显示内容: 显示的字符串(包含在单引号' '或双引号" "中的中英文字符)
  • 位置大小: 控件所在位置及所占空间大小，此参数类型为元组，写作 (a, b, c, d) 其中a/b/c/d都应该是正整形值分别表示控件的 起始行/起始列/所占行数/所占列数，其中c/d可以省略，省略时值均为1。
  • id: 控件名称，用于标识控件，控件名称不可重复，如果不需要可以不设置，此参数可以为数字或中英文字符串，写作 id="lable1" 或 id=1。若和后面要说明的switch控件联合使用，则可能需要id，详细说明见switch。
  • 对齐方式 可以为 左对齐/居中/右对齐，此参数类型非字符串，写作 左对齐不设为默认值(如果page函数中设置了本页的默认值，则和page中一样；page中没设置，则为全局默认设置值。)
  • 颜色和背景色（不设，则为默认值）
  • 字体大小（不设，则为默认值）
  • 边框格式：取值可为 隐藏/不隐藏，此参数可以省略，默认为不隐藏，此参数类型非字符串，写作 隐藏，会隐藏控件四周的线框。
  • visible: 是否显示：不显示visible=0(v3.3新增)
  • text_expr: 文字内容表达式，通过表达式动态显示文本，例如：text_expr="#500"
  • text_map: 文字内容映射，表达式不成立时显示默认文字，例如：text_map={1:"内容1", 2:"内容2"}
  • focus: 是否获取焦点：获取焦点focus=True，如果文字过多时，获取焦点可以进行翻页查看

示例

如图所示，显示lable控件的不同样式效果。

label

with page(456, 800, id="page1", text=(白色, f20x10, 居中), bg_color=(24, 24, 24)):
    label("静态文本", (1, 1, 30, 800), 居中, 青色, f32x24)

    # 绘制直线，所占行数或列数设置成0表示画宽度为1的直线
    label("", (30, 30, 1, 100), border_visible=1)
    
    # 常规文本显示
    label("常用方法", (50, 100, 50, 150), 左对齐, 绿色, f24x16)
    
    # 前景色和背景色根据宏变量数值显示指定颜色
    label("动态颜色", (150, 100, 50, 150), fg_expr="#500", fg_map={0:红色, 1:绿色}, bg_expr="#500+10", bg_map={10:灰色, 11:黑色})
    
    # border_size 部分软件版本可用
    label("边框显示", (250, 100, 50, 150), border_visible=1, border_color=黄色, border_size=5)
    
    # 圆角边框，部分软件版本可用
    label("圆角边框", (50, 300, 150, 200), bg_color=(45, 45, 45), radius=20)
    
    # 可变文本显示，部分软件版本可用
    label("默认文本", (250, 300, 50, 150), text_expr="#500", text_map={0:"#500=0", 1:"#500=1"})
    
    # 文本框焦点，内容过多时可以进行翻页查看
    label("第一行内容1\n第二行内容2\n第三行内容3\n第四行内容4\n第五行内容5\n第六行内容6", (50, 600, 80, 150), focus=True)

    menu("页面", "page1")

由于软件版本原因，不同版本软件所使用的功能可能不同，以实际使用的软件版本功能为准。