文档手册

行为浏览器 Behavior Browser：组件行为绑定

行为浏览器（功能区 HQ VISU 标签页 → Behavior Browser）是为 PPT 图形组件配置“运行时行为”的可视化面板，也是插件中使用频率最高的界面之一。界面固定分三块：左侧树 Pages / Components 按层级显示页面、页面组件以及每个组件下已经绑定的行为（当前激活的页面或组件会高亮）；右侧目录 Behaviors 列出所有可绑定行为，分为 Visual States（颜色/边框/显示隐藏/状态灯）、Geometry（位移/旋转/缩放）、Interactions（点击/悬停/跳转/写值）、Text（文本显示）；下方 Behavior Details 显示当前选中节点的详细信息。配置目标是把组件在现场运行时的显示变化、点击动作和数据联动明确绑定到对应组件上。

功能

功能: 行为浏览器 Behavior Browser：组件行为绑定

行为浏览器是日常用得最多的界面。它分三块：左侧树（Pages / Components）列出页面、组件和已绑定的行为；右侧目录（Behaviors）列出可绑定的行为；下方是 Behavior Details。绑行为的唯一方式是把右侧的行为拖到左侧某个组件节点上，双击右侧行为不会绑定。

功能说明

当前行为目录：22 个注册行为

下面清单直接对应当前程序注册表。手册中的独立章节按这些界面名称组织；括号里的旧名称或内部类型只用于兼容旧项目，不作为新配置入口。

Visual States：Blink Color、Range Color、Script Color、Discrete Color、State Color、Multi-State Color。
Geometry：Move、Rotate、Scale。
Interactions：Set Variable on Click、Open Diagnosis、Open Link、Open Page as Popup、Close Current Popup、Write Tag、Write Tag Bit、Click Script、Hover Script、Press/Release Script。
Text：Script Text、Tag Text、Localized Text。

使用方法：拖拽绑定 + 右键菜单 + 编辑字段

绑定只有一种正确做法：先在左侧树选中一个组件节点，再从右侧目录把要用的行为拖到这个组件节点上，松开鼠标即完成绑定。注意右侧行为双击不会绑定，双击时状态栏只会提示 Drag a behavior onto a component node to bind it.，必须拖过去才算数。绑好后，双击左侧组件下的那条行为节点即可打开它的编辑器填字段；不同行为字段不同，常见有：Definition（准备区，读标签、定义变量、做中间计算）、Condition / Value / Text（输出区，返回行为真正用的结果）、Fill（填充色）、Border（边框色）、Visibility（显隐）、Tag Expression（只读标签表达式）、Target Tag（写值目标）、Bit Index（位号）、Action（Set / Reset / Toggle）等。左侧树节点还支持右键菜单：Locate in PowerPoint（在 PPT 中定位该页/组件）、Rename Component（重命名组件）、Edit Behavior（编辑当前行为）、Remove Behavior（删除当前行为）。

绑定步骤：左侧选中组件 → 右侧拖行为到该组件节点 → 松开鼠标完成。
双击右侧行为不绑定，只提示拖拽；双击左侧已绑行为节点 = 打开其编辑器。
Definition：准备工作（读标签、定义变量、中间计算）。
Condition / Value / Text：只返回最终结果，复杂逻辑放 Definition。
颜色类常见字段：Fill（填充）、Border（边框）、Visibility（显隐）。
写值类常见字段：Target Tag（目标标签）、Value、Bit Index、Action（Set/Reset/Toggle）。
左侧右键：Locate in PowerPoint / Rename Component / Edit Behavior / Remove Behavior。

// 给某个泵图形绑 State Color 后，在编辑器里这样填：
// Definition（准备区）
var running = ReadTagBoolean("PLC1.PUMP.RUN", false);
// 输出区：Fill 绿=运行 / 红=停
running ? "#22C55E" : "#EF4444"

左侧组件树工具栏怎么用

Components 树顶部有五个工具按钮。Refresh 重新读取当前 PPT；Collapse all 折叠全部页面和组件；Expand all 展开全部节点；Zoom out 和 Zoom in 调整树中文字与行高，适合组件很多或需要看清长名称时使用。树中选择页面或组件后，PowerPoint 会同步选中对应对象。

树内容没有跟上 PowerPoint：点击 Refresh。
节点太多难以定位：先 Collapse all，再只展开目标页面。
需要检查同页全部行为：使用 Expand all。
名称被截断或列表太密：用 Zoom out / Zoom in 调整显示。
点击组件节点后，回到 PowerPoint 确认同一个对象已被选中。

颜色图例和当前状态怎么看

行为浏览器的图例用于区分节点状态。Bound 表示组件已经绑定该行为；Unbound 表示目录中存在但当前组件未绑定；Behavior 表示该节点是一条行为；Current 表示当前页面、组件或行为。颜色只用于快速识别，最终仍以左侧组件下是否出现行为节点为准。

拖拽后先看组件节点下是否新增行为。
双击新增的行为节点，确认能打开对应编辑器。
保存后刷新一次，确认行为仍显示为 Bound。

右键菜单、复制粘贴和快捷键

在左侧树中右键页面、组件或行为，会按当前节点类型显示可用命令。Locate in PowerPoint 用于定位对象；Edit Template 打开模板编辑；Ungroup 取消组合；Rename Component 修改组件名；Edit Behavior 打开行为编辑器；Copy Behavior 和 Paste Behavior 在兼容组件间复制行为；Remove Behavior 删除当前行为。

Ctrl+C：复制当前选中的行为。
Ctrl+V：把已复制行为粘贴到当前兼容组件。
Delete：删除当前选中的行为，按提示确认。
复制后必须检查 Target Tag、页面目标、组件名和模板变量，避免把源对象参数原样带入。
菜单项不可用时，先确认选中的是页面、组件、组合、模板实例还是行为节点。

新绑定取消、文本限制和定位问题

把行为拖到组件后，插件会立即打开该行为的编辑器。如果这是刚新增的行为，而你在编辑器中点击 Cancel，插件会回滚本次新增绑定；已有行为打开后取消，只是不保存本次修改。Text 分类的行为只能拖到支持文本的组件，普通线条或没有文本能力的对象会拒绝绑定。

新增行为后要保留：填写必要字段并点击 Save / OK。
新增行为后不需要：点击 Cancel，确认组件下没有残留行为。
已有行为修改后放弃：点击 Cancel，原配置保持不变。
Text 行为拖不上：改选文本框、带文本的图形或支持文本的模板对象。
树和 PowerPoint 选择不一致：先点 Refresh，再用 Locate in PowerPoint。

适用场景

只要某个图形需要随现场数据变化、或被点击/悬停时要有动作，就来这里给它绑行为。两个典型场景：

做运行状态灯：在左侧树找到泵/阀图形，从右侧拖 State Color 或 Blink Color，再在 Definition 读标签、输出里配颜色。
做点击操作：给按钮图形拖 Write Tag / Write Tag Bit / Open Link，配好标签或跳转，导出后在宿主机点按生效。

常见配置误区

最常见的错误是双击右侧行为以为能绑上，双击右侧目录只会弹提示 Drag a behavior onto a component node to bind it.，根本不绑定，必须拖到左侧组件节点。另外：要绑到组件本身，得拖到“组件节点”上，不是页面节点。如果改了页面、选中项、模板或行为后界面没立刻同步，点功能区 Tools 里的 Refresh（或行为浏览器的刷新）即可重新拉一遍，不必关掉重开。

HQ VISU Designer 行为浏览器 — **图示 1: 行为浏览器 Behavior Browser**
左侧树列出页面、组件和已绑行为，右侧目录把行为拖到组件节点上绑定，下方显示行为详情。