3. 配方视图组态

配方视图，说白了就是操作员跟配方数据打交道的那个界面窗口。你配置得好，操作员点几下鼠标就能完成配方切换；配置得不好，人家可能得翻好几页才能找到想要的数据。

我个人习惯，在开始组态之前，先把配方视图要干的事想清楚：是只用来查看？还是要做选择、加载、保存？不同的用途，控件的属性配置和按钮布局差别很大。

3.1 配方视图控件属性配置

从工具箱里拖一个“配方视图”控件到画面上，双击打开属性对话框。这里我重点说几个关键项：

3.2 显示列配置

配方视图默认会把配方里的所有元素都列出来。但实际生产中，有些列操作员根本不需要看到。比如内部计算用的中间变量、设备参数等。

嗯，这里要注意：显示列配置不是在控件属性里直接勾选的，而是通过“列配置”对话框来管理。

3.2.1 列配置步骤

1. 右键配方视图控件 → “列配置”
2. 在左侧“可用列”中，把不需要的列移到右侧“隐藏列”
3. 调整列的显示顺序（拖拽即可）
4. 设置每列的宽度（建议用“百分比”模式，自适应画面大小）

3.2.2 我常用的列显示方案

3.3 操作按钮布局

配方视图本身不带操作按钮，你需要自己在画面上放按钮，然后关联配方函数。你想想看，如果按钮放得乱七八糟，操作员用起来得多难受。

3.3.1 标准按钮组

我一般会在配方视图下方或右侧放一排按钮，按使用频率从左到右排列：

• 加载配方 — 最常用，放最左边
• 保存配方 — 次常用
• 新建配方 — 较少用
• 删除配方 — 放最右边，防止误点

3.3.2 按钮关联函数

每个按钮需要关联一个 C 脚本或 VBS 脚本。举个例子，加载配方的按钮脚本：

// C 脚本示例：加载选中的配方
#include "apdefap.h"
void OnClick(char* lpszPictureName, char* lpszObjectName, char* lpszPropertyName)
{
    // 获取当前选中的配方名称
    char szRecipeName[256];
    GetPropChar(lpszPictureName, "RecipeView1", "SelectedRecipeName", szRecipeName);
    
    // 执行加载
    RecipeLoad("MyRecipe", szRecipeName);
    
    // 提示操作员
    SetPropChar(lpszPictureName, "StatusText", "RecipeLoaded", szRecipeName);
}

3.3.3 按钮布局原则

• 间距均匀：按钮之间留 5~10 像素间隙，触摸屏上至少 15 像素
• 大小一致：所有操作按钮用相同尺寸，视觉上整齐
• 颜色区分：加载用绿色、删除用红色、其他用灰色或蓝色
• 禁用状态：未选中配方时，“加载”和“删除”按钮置灰

3.4 配方视图组态知识结构

下面这张图把配方视图组态的核心逻辑串起来了，你可以对照着检查自己的配置有没有遗漏：

3.5 常见问题与避坑

还有一个容易忽略的点：配方视图的刷新机制。如果你在后台通过脚本修改了配方数据，视图不会自动刷新。需要调用 RecipeViewRefresh() 函数手动刷新。我习惯在“保存”和“删除”操作后面都加上刷新调用，确保操作员看到的是最新数据。