页面（page）

功能

page函数用于设置本页面的基本属性，包括将页面划分成的行、列数，此页中text和data控件的默认属性。代码格式上page函数和with联合使用用于分隔页面之间的代码。

每一个自定义界面最多支持256个页面

参数

  • 此页被划分的行数
  • 此页被划分的列数
  • id：每个page都有自己的唯一id，任意两个page的id不能重复，可以为数字或中英文字符串，写作 id="page1" 或 id=1。
  • bg_color：设置页面的背景色
  • 若本页单独对text控件或data控件字体有整体设置，可加入text和data参数，text和data属性仅在本页面有效。若不想单独设置，则下面两个参数可以省略，省略时将采用默认设置。
  • first：第一次进入页面时捕获焦点的控件id。格式为 first=id，id为此页面中可捕获焦点的控件id
  • prev：上一页的页面id，按下数控系统按键板上的上一页按键跳转到相应id的页面。格式为 prev=id
  • next：下一页的页面id，按下数控系统按键板上的下一页按键跳转到相应id的页面。格式为 next=id

first/prev/next为V2.1新增参数，bg_color为3.0新增

示例

自定义界面采用矩阵布局的形式，可以用page函数将页面划分成指定的行数和列数。下图将页面分成10行5列，红色虚线仅表示页面的划分情况，实际使用时不会出现，图中的最小矩形为此页面的最小可操作区域，划分的行列数越多对页面的设计就越精细。

page

#此页面共10行，5列，id为"page",此页中的静态字符text控件默认为红色,字体大小为f24x12, 左对齐。此页中的数据data控件默认为黄色，字体大小为f24x12
page(10, 5, id="page", bg_color=白色, text=(红色, f24x12, 左对齐), data=(黄色, f24x12))

自定义界面可以包含多个页面，page函数和with联合使用用于分隔页面之间的代码。

#冒号下面所有缩进4个格的控件函数生成的控件、菜单都属于这一页
with page(10, 5, id="机床调试", text=(红色, f24x12, 左对齐)):
    text("宏变量", (1, 1))      #静态字符text控件占此页的第1行，第1列
    data("#500", (1, 2))       #数据data控件占此页的第1行，第2列
    
#这是另一个页面
with page(4, 5, id="刀架信号", data=(黄色, f24x12)):
    text("系统参数", (1, 1))    #静态字符text控件占此页的第1行，第1列
    data("P414", (1, 2))       #数据data控件占此页的第1行，第2列