全局基础设置支持KUI的一些基础功能,例如:
APP的唯一标识、设置NC软件版本、页面尺寸和标题栏、 APP的快捷入口、APP显示的名称、APP所在目录名称、 APP的默认进入页面、设置页面内默认选项
UUID(Universally Unique Identifier,通用唯一识别码)是一种128位(16字节)的数字标识符,作为APP在系统内部的唯一标识。
两个不同的APP需设置不同的uuid。在程序开头设置set_uuid("")并执行程序后,终端自动生成一个可用的uuid,需手动添加到程序开头。一般一个APP设置一个固定的uuid,无需重复设置。
set_uuid('j6Hr5QQXmxs3yLELrKL7Qq_076d') # uuid作为app在系统的唯一标识符
注意:系统通过识别uuid去判断该APP是否是同一个APP。若两个APP使用同一个uuid,则导入系统中会覆盖之前存在的相同uuid的APP。
KUI和CNC软件在同步开发和更新,所以每一个版本的KUI都要配合相应版本的系统软件才能实现所有的功能。
KUI开发人员总是使用最新的KUI开发包,为了避免生成旧版CNC无法加载的APP,应使用sys_version("")函数指定目标CNC系统版本。
开发APP前,先找到使用APP的数控系统的版本(系列号_BUILD号)作为sys_version("")
函数的参数,此函数能自动识别此版本的系统软件不支持的功能,在运行Python文件时报错。如果开发者需要使用报错的功能,则必须将系统软件升级到支持的版本或者最新版本。
sys_version("V7.0.00c_58728") # 可以识别V5.1.00c_18728版本的系统软件不支持的功能进行报错
应将此函数写在所有页面定义之前,有关KUI和CNC的兼容性问题,参见 兼容性
应将此函数写在所有页面定义之前
–10.4寸屏分辨率为800x600
–15寸屏分辨率为1024x768 (v3.4新增)
set_size(width, height, title=False)
True或False(默认为False)
False时APP显示标题栏;True时不显示标题栏,界面最大化。set_size(800, 600, title=False) # 显示屏尺寸为800×600,显示标题栏
set_size(title=True) # 显示屏尺寸为默认值800×600,不显示标题栏
set_size(1024, 768, title=True) # 15寸屏使用,不显示标题栏
不同尺寸屏幕标题栏和菜单栏高度以及有、无标题栏对应自定义页面布局尺寸推荐如下:
| 分 辨 率 | 题 栏 高 度 | 中 间 高 度 | 菜单栏和状态栏高度 | 有标题栏布局尺寸 | 无标题栏布局尺寸 |
|---|---|---|---|---|---|
| 640×480 | 44 | 372 | 64 | 640×372 | 640×416 |
| 800×480 | 36 | 376 | 68 | 800×376 | 800×412 |
| 800×600 | 56 | 456 | 88 | 800×456 | 800×512 |
| 1024×768 | 64 | 590 | 114 | 1024×590 | 1024×654 |
以800x600分辨率为例:下图左侧为显示标题栏的界面,右侧为不显示标题栏的界面。
| 有标题栏 | 无标题栏 |
|---|---|
![]() |
![]() |
使用函数shortcut_id(位置)指定此APP在数控系统中的快捷入口的位置,可取值如下(中英文都支持):
例如:指定此APP在数控系统中快捷入口在位置页面下的软按键。
shortcut_id(位置) # 此APP显示在数控系统的位置页面下
KHC系统需要添加快捷入口为“位置”,否则将开机无法自动进入该页面。
使用函数set_name("")指定此APP在系统应用中的名称,若使用快捷入口,该名称也是对应软按键的名称。
例如:APP在应用中显示的名称为"简单示例",权重为20。其中权重值越大,该显示的位置越靠前。
使用函数set_category("")指定此APP在系统应用中目录的名称。
例如:APP在应用中分类显示的目录名称为"示例目录",权重为10。其中权重值越大,该显示的位置越靠前。
set_category("示例目录", weight=10) # 此APP在数控系统中所在应用目录中显示的名称
set_name("简单示例", weight=20) # 此APP在数控系统中显示的名称
每个APP都有一个默认页面,也就是首页,为防止进入页面混乱需定义一个APP的默认页面。使用函数set_default_page("")指定该应用默认进入的页面,类似之前版本的根目录,需在("")中填写默认页面的id。
例如:默认进入的页面为id=“main"的页面。
set_default_page("main")
应将此函数需写在所有页面page定义之前。
这一部分函数为APP中若干个页面的控件设定一些默认值,包括控件颜色、字体大小和对齐方式,如果控件和页面中没有设定参数的值将采用默认值。下面函数的作用范围从函数调用处开始到再一次调用或文件结尾为止。可用来为n个相邻的页面定义同一默认值。
合理的默认值可以简化代码的书写