自定义面板(panel)

V3.0新增

功能

面板panel用于在屏幕上显示的局部窗口,和页面page相似,但需要和显示面板菜单、关闭面板菜单配合使用。当打开局部窗口时,光标进入局部窗口区域

参数

  • 面板尺寸:设置面板尺寸(行高,列宽),为了与page页面区分,使用时页面尺寸应小于分辨率或页面推荐尺寸
    • height: 面板显示高度
    • width: 面板显示宽度
  • id: 页面的id,用于交叉引用
  • name: 名称(标题)
  • text: 指定页面文本默认的颜色,字体,对齐方式,边框可见性
  • data: 指定页面数值默认的颜色,字体,对齐方式,边框可见性
  • first: 默认的焦点控件(第一次进入时的焦点位置)
  • bg_color: 页面的背景颜色
  • rows: 总行数
  • colums: 总列数
  • viewport_width: 视口宽度,此数值大于面板显示高度时,将显示竖向滚动条(V7.1版本可用)
  • viewport_height: 视口高度,此数值大于面板显示宽度时,将显示横向滚动条(V7.1版本可用)
  • scroll_width: 可设置滚动条宽度(V7.1版本可用)

示例

通常panel会叠加在页面上方,用于显示内容。其panel可显示的数据与page页面相同,但panel页面尺寸要小于页面的尺寸。

panel

with page(456, 800, id="page1", text=(白色, f20x10, 居中), bg_color=(24, 24, 24)):
    label("", (1, 1, 30, 300), 居中, 蓝色)

    menu("面板", 显示面板("mianban"))

with panel(200, 300, id="mianban", text=(白色, f20x10, 居中), bg_color=(145, 145, 145)):
    label("面板标题", (1, 1, 30, 300), 居中, 青色, bg_color=蓝色)

    label("显示内容", (70, 10, 30, 100))

    button("退出面板", (120, 170, 50, 100), focus=True, action=关闭面板)

    spring()
    menu("退出面板", 关闭面板)  # 部分软件不可用,请自行测试