拓扑展示
本节主要介绍 AppStudio 控件库里的拓扑展示控件。
属性
CloudPSS 提供了一套统一的控件属性参数
通用样式
| 参数名 | 键值 (key) | 单位 | 备注 | 类型 | 描述 |
|---|---|---|---|---|---|
| 缩放比例 | $scale | 输入控件缩放比例 | 常量 | 输入缩放比例数值，控件按照比例放大或者缩小，默认为 1 倍大小 | |
| 是否隐藏 | hidden | 选择是否隐藏控件 | 选择 | 选择隐藏或者显示，隐藏当前控件，或者显示当前控件，默认为显示状态 |
样式
| 参数名 | 键值 (key) | 单位 | 备注 | 类型 | 描述 |
|---|---|---|---|---|---|
| 背景 | style/background | 显示背景 | 颜色选择器 | 点击背景颜色，弹出颜色选择器自定义背景颜色，同时允许用户上传图片自定义背景 | |
| 高亮颜色 | style/--highlight | 显示高亮颜色 | 颜色选择器 | 点击高亮颜色，弹出颜色选择器自定义高亮颜色，默认为 yellow | |
| 高亮宽度 | style/--highlight-width | px | 显示高亮宽度 | 常量 | 显示高亮宽度，默认为 3px |
| 高亮虚线长度 | style/--highlight-dasharray | px | 显示高亮虚线长度 | 常量 | 高亮虚线长度，默认为 5px |
| 高亮闪烁速度 | style/--highlight-animation-duration | s | 高亮闪烁速度 | 常量 | 高亮闪烁速度，默认为 0.5s |
内容
| 参数名 | 键值 (key) | 单位 | 备注 | 类型 | 描述 |
|---|---|---|---|---|---|
| 模型 RID | rid | 模型 RID | 字符串 | 模型 RID，格式为 model/<owner>/<key> | |
| 图纸 | canvas | 图纸 key | 字符串 | 图纸 key，默认为 canvas_0 | |
| 缩放系数 | zoom | 控件内容缩放系数 | 常量 | 输入缩放系数数值，控件内容按照比例放大或者缩小，默认为 1 倍大小 | |
| 只读 | readonly | 选择是否只读 | 开关 | 是否开启控件只读，默认为关，允许编辑 | |
| 显示元件标签 | showLabel | 选择显示元件标签 | 开关 | 是否显示元件标签，默认为关，不显示 | |
| 显示引脚标签 | showPin | 选择显示引脚标签 | 开关 | 是否显示引脚标签，默认为开，显示引脚标签 | |
| 高亮 | hightlight | 高亮数据 | 表格 | 点击 编辑数据，弹出表格自定义高亮数据 | |
| 覆盖样式 | overridenStyles | 覆盖样式 | 表格 | 点击 编辑数据，弹出表格自定义所需的覆盖样式 |
案例介绍
接入 SimStudio 仿真的典型应用
-
创建一个拓扑展示控件，在右侧的属性配置区内给拓扑展示命名为 A，调整下拓扑展示控件的大小
-
鼠标选中拓扑展示 A 的内容/模型 RID 属性栏，输入
model/Maxwell/IEEE绑定 3机9节点标准测试系统仿真算例；调整控件大小位置 -
点击工具栏的预览快捷按钮(或者 Ctrl + P )，进入预览模式，显示出绑定的算例模型
常见问题
- 什么是事件触发机制？
-
AppStudio 场景标签页 内控件的属性有两种输入模式，一种是 (x) 值输入模式，另一种是 f(x) 表达式输入模式。 值输入模式是通过在属性框内直接输入值来配置控件属性，表达式输入模式则是在属性框内输入由变量/函数资源键名、控件属性键名构成的 math.js 表达式，通过表达式解析器计算出表达式的值来配置控件属性值。详情参见 控件属性的表达式输入
- (x) 与 f(x) 的区别
-
事件是指对控件操作后产生的效果，事件触发使用 HTML 元素事件触发的回调函数结合 math.js 的表达式解析器进行控件属性或者资源的调用。详情参考 事件触发机制