在本主题▼

图像查看器渲染

的imageview渲染周期支持完全自定义。各种事件及其数据允许以下任意情况:

在视图或项上添加用户定义的呈现代码。例如，LEADTOOLS注释框架与呈现周期挂钩，将注释容器绘制在项的顶部。
执行视图或项目的任何部分的完整所有者绘制。例如，ImageViewerVirtualizer当图像数据还未呈现时，钩子到渲染事件以绘制占位符。
将渲染重定向到外部上下文。例如，ImageViewerPanControl使用重定向将查看器的当前外观复制到外部控件。

呈现周期

呈现周期发生在imageview。无效或imageview。RenderRedirect呼叫是由于正常控制绘画还是响应imageview。UpdateTransform．类派生的特定事件，也可以自定义呈现周期imageview并重写特定的虚方法。所有这些方法和事件都使用ImageViewerRenderEventArgs类来保存所需的信息。

ImageViewerRenderEventArgs包含以下内容:

成员	描述
上下文	在Windows窗体中，`System.Drawing.Graphics`绘制过程中查看器控件的对象或绘制过程中目标设备的对象RenderRedirect．在JavaScript中，HTML`CanvasContext2D`期间的前画布或目标设备的前画布RenderRedirect．
PaintEventArgs	原来的窗口。形式paint arguments if this render event is in response to`System.Windows.Forms.Control.Paint`．
项	在呈现周期的这一部分中，被呈现的项或null是特定于视图的。
部分	被呈现的项部分或视图(如果呈现循环的这一部分是特定于视图的)。
错误	在呈现周期期间捕获的错误。与the连用imageview。RenderError事件。
ImageViewerRenderEventArgs。ClipRectangle	当前剪切矩形应用。

图像查看器将调用虚拟方法并按照下面描述的顺序触发事件。会员须知:ImageViewerRenderEventArgs。康泰克斯将指向System.Drawing.Graphics(Windows.Forms)或(HTML . forms)CanvasContext2D对象(JavaScript中的前画布)，查看器控件或重定向目标。

方法-事件	ImageViewerRenderEventArgs。项，部分	默认的操作
`imageview。OnEraseBackground`-`imageview。EraseBackground`JavaScript只	零-ImageViewerItem。视图	擦除或清除背景
OnPreRender-PreRender	零-ImageViewerItem。视图	没什么。可用于设置上下文属性(例如，抗锯齿或插值质量)
OnRenderShadow-RenderShadow	零-ImageViewerItem。视图	渲染视图的投影
OnRenderBorder-RenderBorder	零-ImageViewerItem。视图	渲染视图的边界
每一项		循环遍历查看器中的项。只有当项目为时才会发生IsVisible，没有空的图象尺寸如果它与当前可见的查看器表面和剪切矩形相交。
OnPreRenderItem-PreRenderItem	项目-项目	没有什么
OnRenderItem-RenderItem	项目-项目	没有什么
OnRenderBackground-RenderBackground	项目-项目	根据项目状态用背景色填充项目的内容
OnRenderBorder-RenderBorder	项目-内容	使用基于项状态的边框颜色呈现内容边框
OnRenderShadow-RenderShadow	项目-图像	渲染项目图像周围的投影
OnRenderImage-RenderImage	项目-图像	渲染项目图像
OnRenderBorder-RenderBorder	项目-图像	渲染图像的边界
OnRenderText-RenderText	项目-文本	呈现该项的文本
OnPostRenderItem-PostRenderItem	项目-项目	没有什么
下一个项目
OnPostRender-PostRender	零-ImageViewerItem。视图	渲染飞蚊和区域
OnRedirectRender-RedirectRender	零-ImageViewerItem。视图	没有什么

最常见的自定义渲染是通过订阅这些事件来执行的:

PostRenderItem:在一个项目的顶部呈现额外的信息
PostRender:在整个查看器的顶部渲染额外的信息

有关示例，请参考这些事件。

若要手动触发一个新的呈现周期，请调用imageview。无效使整个查看器表面的一部分失效。此方法接受一个矩形，该矩形指定要更新的查看器部分以获得最佳速度。的InvalidateItem或InvalidateItemByIndex方法可用于快速重新呈现单个项。

渲染时的错误

渲染imageview控制通常自动发生，而不是通过用户调用的任何代码。如果发生错误，用户没有尝试/捕获异常和处理错误的能力。因此,imageview包含了RenderError事件。这将在内部呈现循环中发生错误时发生。事件使用相同ImageViewerRenderEventArgs数据类，因此导致错误的项目和部件的所有常用参数都传递给用户。此外，它将捕获错误并将其设置在ImageViewerRenderEventArgs。错误财产。

其他渲染操作

ImageViewer还支持以下与渲染相关的操作:

显示

成员	描述
反	用颠倒的颜色显示所有项目
ScreenDpi	更新屏幕分辨率的值，单位为每英寸点数
UseDpi	在计算显示尺寸时，要考虑项目中图像的分辨率
AspectRatioCorrection	手动更改用于补偿非正方形像素的纵横比
BeginRender	暂时禁用渲染
EndRender	重新启用呈现
imageview。无效	请求查看器重新渲染整个或部分视图
PaintProperties	控制渲染RasterImage对象时使用的质量
RedirectRender	将当前视图呈现给外部上下文
ClipImageToContent	如果项目转换导致更大的边界，则只显示图像内容内的部分
OwnerDraw	关闭或打开视图和项的所有自动渲染