Visionpro二次开发学习笔记7-使用CogToolDisplay控件

CogToolDisplay控件可显示与视觉工具记录相关的图像，图形和其他状态信息。它使用CogRecord和ICogTool接口将图像和图形连接到CogDisplay。

图片清单

控件的CogComboBox列出当前记录及其子记录中的图像和图形。您可以单击列表并选择要显示的图像或图形。如果记录层次结构仅包含一个图像，则CogComboBox被禁用，但显示图像名称。如果没有可用的图像，则CogComboBox为空并被禁用。只要设置了新的“主题”记录或工具的检查记录发生更改，图像和图形的列表就会刷新。

展示区

控件的CogDisplay区域显示当前选择的图像及其关联的图形。您可以像CogDisplay控件一样操作此显示。

属性和方法

CogToolDisplay控件具有以下属性，方法和事件：

1. CogToolDisplay属性

属性	描述
SelectedRecordKey	返回当前所选检查记录的关键字，或使用给定的关键字字符串选择其他记录。当您更改SelectedRecordKey属性时，它将触发一个RecordChange事件。
Subject	返回或设置对要显示的检查记录集的顶级CogRecord对象的引用。如果将“Tool”属性设置为特定的视觉工具，则会自动设置“Subject”。否则，必须将Subject设置为特定的CogRecord对象。您还可以将“Subject”设置为NULL，以将“CogToolDisplay”控件与检查记录断开连接。无论何时设置此属性，控件的检查记录和可显示图像的列表都会更新。
Tool	返回或设置对此CogToolDisplay控件关联的VisionPro工具的引用。如果设置了Tool属性，则控件将使用其CreateCurrentRecord和CreateLastRunRecord方法从该工具自动获取其主题检查记录。如果未设置Tool属性，则必须将控件的Subject属性设置为特定的CogRecord对象。

2. CogToolDisplay方法

方法	描述
Refresh	更新当前检查记录中包含的控件的图像和图形列表。

3. CogToolDisplay事件

事件	描述
RecordChange	当所选检查记录更改时触发。

使用CogToolDisplay控件

将控件的“工具”属性设置为要显示其记录信息的视觉工具。控件从工具的CreateCurrentRecord和CreateLastRunRecord方法获取CogRecord对象。每当工具触发Changed事件（表明其检查记录已更改）时，控件都会获取新记录，并自动显示记录信息。例如，如果调用工具的“运行”或“训练”方法，则控件将显示新的记录信息。下面的代码显示如何在自动模式下使用“CogToolDisplay”控件。

CogToolDisplay mToolDisplay = new CogToolDisplay();
mToolDisplay.Tool = myVisionTool;

示例

使用CogToolDisplay控件显示CogImageFile记录信息

1. 添加引用

• using Cognex.VisionPro.ImageFile;

2. 添加控件

• 新建Windows窗体,增加TabControl选项卡,Tab1用于选择图片文件,Tab2用于显示图片文件记录信息

• Tab1 工具箱拖动添加CogImageFileEditV2控件

• Tab2 增加CogToolDisplay控件

3. 后台逻辑

using Cognex.VisionPro.ImageFile;
using System.Windows.Forms;

namespace UsingQB
{
    public partial class Form8 : Form
    {
        
        public Form8()
        {
            InitializeComponent();
            InitializeDisplay();
        }
        private CogImageFileTool CogImageFileTool;
        private void InitializeDisplay() {

            cogDisplayToolStrip1.Display = cogToolDisplay1.Display;
            cogDisplayStatusBarV21.Display = cogToolDisplay1.Display;

            CogImageFileTool = new CogImageFileTool();
            cogImageFileEditV21.Subject = CogImageFileTool;
            cogToolDisplay1.Tool = CogImageFileTool;
           
        }
        
    }
}

4. Tab1 选择图片文件后,你需要点击三角图标运行工具,可以看到Tab2 CogToolDisplay的LastRun.OutputImage已经同步发生变化了.

还在学习中,有问题和不足欢迎指正.