CogToolDisplay控件可显示与视觉工具记录相关的图像,图形和其他状态信息。它使用CogRecord和ICogTool接口将图像和图形连接到CogDisplay。
图片清单
控件的CogComboBox列出当前记录及其子记录中的图像和图形。您可以单击列表并选择要显示的图像或图形。如果记录层次结构仅包含一个图像,则CogComboBox被禁用,但显示图像名称。如果没有可用的图像,则CogComboBox为空并被禁用。只要设置了新的“主题”记录或工具的检查记录发生更改,图像和图形的列表就会刷新。
展示区
控件的CogDisplay区域显示当前选择的图像及其关联的图形。您可以像CogDisplay控件一样操作此显示。
属性和方法
CogToolDisplay控件具有以下属性,方法和事件:
- CogToolDisplay属性
属性 | 描述 |
---|---|
SelectedRecordKey | 返回当前所选检查记录的关键字,或使用给定的关键字字符串选择其他记录。当您更改SelectedRecordKey属性时,它将触发一个RecordChange事件。 |
Subject | 返回或设置对要显示的检查记录集的顶级CogRecord对象的引用。如果将“Tool”属性设置为特定的视觉工具,则会自动设置“Subject”。否则,必须将Subject设置为特定的CogRecord对象。您还可以将“Subject”设置为NULL,以将“CogToolDisplay”控件与检查记录断开连接。无论何时设置此属性,控件的检查记录和可显示图像的列表都会更新。 |
Tool | 返回或设置对此CogToolDisplay控件关联的VisionPro工具的引用。如果设置了Tool属性,则控件将使用其CreateCurrentRecord和CreateLastRunRecord方法从该工具自动获取其主题检查记录。如果未设置Tool属性,则必须将控件的Subject属性设置为特定的CogRecord对象。 |
- CogToolDisplay方法
方法 | 描述 |
---|---|
Refresh | 更新当前检查记录中包含的控件的图像和图形列表。 |
- CogToolDisplay事件
事件 | 描述 |
---|---|
RecordChange | 当所选检查记录更改时触发。 |
使用CogToolDisplay控件
将控件的“工具”属性设置为要显示其记录信息的视觉工具。控件从工具的CreateCurrentRecord和CreateLastRunRecord方法获取CogRecord对象。每当工具触发Changed事件(表明其检查记录已更改)时,控件都会获取新记录,并自动显示记录信息。例如,如果调用工具的“运行”或“训练”方法,则控件将显示新的记录信息。下面的代码显示如何在自动模式下使用“CogToolDisplay”控件。
CogToolDisplay mToolDisplay = new CogToolDisplay();
mToolDisplay.Tool = myVisionTool;
示例
使用CogToolDisplay控件显示CogImageFile记录信息
- 添加引用
- using Cognex.VisionPro.ImageFile;
- 添加控件
-
新建Windows窗体,增加TabControl选项卡,Tab1用于选择图片文件,Tab2用于显示图片文件记录信息
-
Tab1 工具箱拖动添加CogImageFileEditV2控件
- Tab2 增加CogToolDisplay控件
- 后台逻辑
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;
}
}
}
- Tab1 选择图片文件后,你需要点击三角图标运行工具,可以看到Tab2 CogToolDisplay的LastRun.OutputImage已经同步发生变化了.
还在学习中,有问题和不足欢迎指正.