开关（switch）

功能

以指示灯的形式描述K/D/F区伺服参数和系统参数的位型数据，可以手动改变位型数据，所以仅支持可写的位型数据。

支持的数据

  • 诊断参数：K/D/F区(其中V5版本的数控系统软件F区写入范围为F5200~F5231，V6版本的数控系统软件F区写入范围为F19000~F19031)的位型数据
  • 系统位型参数：格式可为 P1105.0[1]、P001.1，中括号内为轴号，括号内可以是一个数字，也可以是一个变量或者表达式。例如P1105.0[D1]，则轴号由"D1"的值决定。
  • 伺服位型参数：支持伺服参数的位型数据，写法为PA08.2[3]，中括号内可以是一个数字，也可以是一个变量或者表达式。例如PA08.2[D1]，则轴号由"D1"决定。

参数

  • 描述的位型数据，此参数类型为字符串，写作 " P1105.0[1] "
  • 控件所在位置及所占空间大小，此参数类型为元组，写作 (a, b, c, d) 其中a/b/c/d都应该是正整形值分别表示控件的 起始行/起始列/所占行数/所占列数，其中c/d可以省略，省略时值均为1。
  • 绘制类型：可取值为 圆形/矩形，此参数可以省略，默认为矩形，此参数非字符串类型，写作 圆形 。
  • 颜色：此处应该设置两个颜色参数，第一个为位型数据为1时显示的颜色，第二个为位型数据为0时显示的颜色，两个参数均可省略，默认为绿色和灰色。此参数类型非字符串，写作 黄色。
  • text_id：和switch控件一起使用的text控件的id，此时该text控件可以捕获光标，text控件捕获光标时可以改变switch控件的数据值。当text_id未写入时要求上一个控件必须为text，以便光标定位使用，此时上一个控件可以捕获光标。
  • enable表达式：当该表达式值不为0时该控件才可以修改位型数据，等于0时不可以修改，若不设置该参数，则可以修改。此参数为字符串类型，写作enable="#100"，则只有当#100不等于0时才可以修改。
  • id：控件名称，用于标识控件，控件名称不可重复，如果不需要可以不设置，可以为数字或中英文字符串，写作 id="page1" 或 id=1。
  • left 左边控件，right右边控件，prev上一控件，next下一控件(对应数控系统面板上的"左"/“右”/“上”/“下"按键)，当需要设置控件的光标顺序时将对应控件的id赋值给相应参数即可，4个参数可以设置0个或多个。此参数为字符串类型或数字类型，取决于跳转到的控件的id，写作 left="LA"或 left=1，则按系统面板上的"左"按键时，id为"LA”/1 的控件捕获光标。
  • action：改变位型数据时的响应动作，action取值可以为 运行脚本/运行脚本文件/程序段模板。当操作者手动改变位型数据的值时，将执行相应的动作。
    • 运行脚本：语法为：action=运行脚本("xxx")，括号中的字符串为符合 KUI脚本语法的若干语句。当操作者手动改变位型数据值时，将执行这些语句。
    • 运行脚本文件：语法为：action=运行脚本文件("xxx.prg")，括号中的字符串为KUI脚本文件名称，文件需放到当前目录下或写入绝对路径。当操作者手动改变位型数据值时，将执行此文件中的语句。
    • 程序段模板：语法为：action=程序段模板('''xxx''')，括号中的字符串为一个程序模板段，当操作者手动改变控件值时，将以其为模板生成程序段，插入当前光标之后。程序模板段可以包含任意符合KUI脚本语法的语句和一些会生成程序的模板语句，模板语句中的字符在生成程序时不变，变量则用其值来替代。例如 ''' G01 X#500'‘‘在生成程序时(假设#500值为100)，会生成程序"G01 X100;"。(V2.2开始支持)
  • 是否显示：不显示visible=0(v3.3新增)

示例

此控件用于显示、编辑位型数据，适用于PLC参数、新增加的F区（V5版本的数控系统软件F区写入范围为F5200~F5231，V6版本的数控系统软件F区写入范围为F19000~F19031）和可编辑的系统位型数据。可以在界面上手动改变位型数据来实现功能的打开/关闭或功能实现方式的选择。

例如，在界面中用switch控件关联系统的位型参数P1105.5-1，则可在自定义界面中查看/改变该位型数据的值实现相应功能。

界面显示效果 对应系统参数
switch1 switch2 
with page(16, 12, id="对刀仪", text=(绿色, f20x10, 左对齐), data=(黄色, f20x10)):
	text("驱动器电平选择", (3, 1, 1, 3))         #text控件对switch控件进行说明
	switch("P1105.5-1", (3, 4, 1, 2), 左对齐, 绿色, 灰色)    #switch控件，关联参数为P1105.5-1，在3行4列，占1行2列，左对齐，位型数据为1时显示绿色，为0时显示灰色