示教(teach)

功能

将轴的坐标(绝对/机床)或表达式的值赋给宏变量或KUI自定义变量

参数

  • 被赋值的宏变量KUI自定义变量(自定义变量名称可以为小写字母或小写字母+数字,不支持大写字母,为了区别于系统数据,将自定义变量包含在大括号{}内,形如{v1})。此参数类型为字符串,写作 "#500"
  • 描述的坐标地址(如X)或表达式(如F1000[u32]/1000),此参数类型为字符串,写作 " X "
  • 控件所在位置及所占空间大小,此参数类型为元组,写作 (a, b, c, d) 其中a/b/c/d都应该是正整形值分别表示控件的 起始行/起始列/所占行数/所占列数,其中c/d可以省略,省略时值均为1。
  • 颜色(不设为默认值)
  • 字体大小(不设为默认值)
  • 线框格式:取值可为 隐藏/不隐藏,此参数可以省略,默认为不隐藏,此参数类型非字符串,写作 隐藏,会隐藏控件四周的线框。
  • 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 的控件捕获光标。。
  • group:控件所属示教组,属于同一示教组的控件可以同时示教。
  • format 对数值的显示进行格式化,格式为 format="%xxx",是C语言库函数printf的子集,目前仅支持几种简单的格式化,在下面列出。使用此参数时, 必须使用data_type参数,且此时参数的格式化需要与data_type类型相对应。格式化时不会改变变量的值,但会改变其显示形式。一些情况可能会导致显示的值与 变量真实值不符。(使用此参数时你需要明确知道你在做什么,并且不会给自己和用户带来困扰)(v3.4新增)

此控件的示教功能需要与相应的菜单一起使用。 详细说明见menu中的示教绝对示教机床示教表达式测量加输入部分表达式

示例

此控件用于将坐标值或表达式值一键读取到指定宏变量或KUI脚本的自定义变量中,也可用于将指定变量加上或减去控件的编辑值,类似于"测量"和"加输入"等功能。可以将同类型的示教控件置于一个示教组中实现同时示教。 例如,在对伺服台尾进行编程时,依次手动将台尾移动到合适的回退位置、快速位置、顶紧位置,在三个位置分别示教对应的teach控件,将对应的坐标值赋值给相应的变量,用于生成程序,完成伺服台尾的编程。

teach

with page(18, 6, id="伺服台尾", text=(绿色, f20x10, 右对齐), data=(黄色, f20x10)):
    text("伺服台尾", (1, 1), f20x10, 黄色, 左对齐)
    picture("伺服台尾.jpg", (2, 1, 16, 3))        #图片显示伺服台尾形式和其中参数意义

    text("台尾回退位置坐标", (2, 4, 1, 2))
    teach("#800", "Y", (2, 6))                  #示教控件,用于赋值台尾回退位置坐标给#800
    text("台尾快速位置坐标", (3, 4, 1, 2))
    teach("#801", "Y", (3, 6))                  #示教控件,用于赋值台尾快速位置坐标给#801
    text("台尾顶紧位置坐标",(4, 4, 1, 2))
    teach("#802", "Y", (4, 6))                  #示教控件,用于赋值台尾顶进位置坐标给#802
    
    menu("示教坐标", 示教机床)                     #示教机床坐标的菜单,按此菜单将执行目前光标所在的teach控件的示教动作