以图片对象中的位图形式返回当前显示内容（图像和图形）。
命名空间: Cognex.VisionPro.Display
Assembly: Cognex.VisionPro.Display.Controls (in Cognex.VisionPro.Display.Controls.dll) Version: 55.0.0.0
方法原型
public virtual Image CreateContentBitmap( CogDisplayContentBitmapConstants content, [OptionalAttribute] CogRectangle contentRect, [OptionalAttribute] int bitmapSize )
参数
- content
类型：Cognex.VisionPro.Display.CogDisplayContentBitmapConstants
要创建的内容位图的类型。 - contentRect (Optional)
类型：Cognex.VisionPro.CogRectangle
显示中要返回为位图的矩形。 - bitmapSize (Optional)
类型：System.Int32
请求的位图的最大尺寸。
返回值
类型：图像
返回图像
异常
| Exception | Condition |
|---|---|
| AxHost.InvalidActiveXStateException | 当显示控件无效时引发。 |
| CogException | 发生以下情况之一时引发：BitmapSize小于0，如果无法分配返回位图，或者如果传递的内容rect无法映射到像素（#）空间，则出现CogSpaceTree错误。 |
content参数指定如何创建位图。
如果使用“自定义”作为内容参数，则contentRect和bitmapSize参数将指定显示图像的哪个部分用于创建位图。如果bitmapSize为零，则返回的位图是contentRect描述的图像的未缩放部分。如果bitmapSize不为零，则将其用作生成位图的最大维度，并且位图的纵横比与contentRect相同。
如果contentRect为空且bitmapSize为零，则返回的位图为显示的未缩放内容。
CogDisplayContentBitmapConstants
用于指定显示内容位图格式的枚举。
| Member name | Value | Description |
|---|---|---|
| Custom | 2 | 返回位图的内容由传递的内容矩形和位图大小决定。 |
| Display | 1 | 返回的位图正好包含显示中可见的内容。图像将按当前在显示中的显示方式进行缩放和平移，并在显示边界处剪裁图形注释。 |
| Image | 0 | 返回的位图包含完整的未缩放图像，其中图形注释在图像边界处被剪裁。 |
注意：使用Display方法保存图像时，请不要修改cogdisplayrecord控件大小，否则保存的图像大小会异常。特别是大家在做了UI自适应处理后，最小化操作会改变控件大小！
扩展阅读
原创文章，作者：奋斗，如若转载，请注明出处：https://blog.ytso.com/241958.html