DrawingVisual 类

定义

命名空间:

System.Windows.Media

程序集:

PresentationCore.dll

DrawingVisual 是可用于在屏幕上呈现矢量图形的视觉对象。 内容由系统保留。

public ref class DrawingVisual : System::Windows::Media::ContainerVisual

public class DrawingVisual : System.Windows.Media.ContainerVisual

type DrawingVisual = class
    inherit ContainerVisual

Public Class DrawingVisual
Inherits ContainerVisual

继承

Object

DispatcherObject

DependencyObject

Visual

ContainerVisual

DrawingVisual

注解

DrawingVisual 是一个轻型绘图类，用于呈现形状、图像或文本。 此类被视为轻量级，因为它不提供布局、输入、焦点或事件处理，从而提高其性能。 因此，绘图非常适用于背景和剪贴画。

若要使用 DrawingVisual 对象，需要为对象创建主机容器。 主机容器对象必须派生自 FrameworkElement 该类，该类提供该类不支持的布局和事件处理支持 DrawingVisual 。 主机容器对象不显示任何视觉属性，因为它的主要用途是包含子对象。 有关详细信息，请参阅使用 DrawingVisual 对象。

有关如何使用主机容器创建 DrawingVisual 对象的完整示例，请参阅 使用 DrawingVisuals 示例进行命中测试 。

构造函数

DrawingVisual()

初始化 DrawingVisual 类的新实例。

属性

BitmapEffect	已过时。 已过时。 获取或设置 BitmapEffect 的 ContainerVisual 值。 (继承自 ContainerVisual)
BitmapEffectInput	已过时。 已过时。 获取或设置 BitmapEffectInput 的 ContainerVisual 值。 (继承自 ContainerVisual)
CacheMode	获取或设置 ContainerVisual 的缓存表示形式。 (继承自 ContainerVisual)
Children	获取 ContainerVisual 的子集合。 (继承自 ContainerVisual)
Clip	获取或设置 ContainerVisual 的剪辑区域。 (继承自 ContainerVisual)
ContentBounds	获取 ContainerVisual 内容的边界框。 (继承自 ContainerVisual)
DependencyObjectType	获取包装 DependencyObjectType 此实例的 CLR 类型。 (继承自 DependencyObject)
DescendantBounds	获取 ContainerVisual 所有子代的所有内容边界框的联合，但不包括 ContainerVisual 的内容。 (继承自 ContainerVisual)
Dispatcher	获取与此 Dispatcher 关联的 DispatcherObject。 (继承自 DispatcherObject)
Drawing	获取 DrawingVisual 对象的绘图内容。
Effect	获取或设置要应用于 ContainerVisual 的位图效果。 (继承自 ContainerVisual)
IsSealed	获取一个值，该值指示此实例当前是否为密封的（只读）。 (继承自 DependencyObject)
Offset	获取或设置 ContainerVisual 相对于其参考点的偏移值。 (继承自 ContainerVisual)
Opacity	获取或设置 ContainerVisual 的不透明度（基于 0=透明，1=不透明）。 (继承自 ContainerVisual)
OpacityMask	获取或设置指定 ContainerVisual 可能的不透明蒙板的画笔。 (继承自 ContainerVisual)
Parent	获取 Visual 的父 ContainerVisual。 (继承自 ContainerVisual)
Transform	获取或设置应用于 ContainerVisual 的转换。 (继承自 ContainerVisual)
VisualBitmapEffect	已过时。 已过时。 获取或设置 BitmapEffect 的 Visual 值。 (继承自 Visual)
VisualBitmapEffectInput	已过时。 已过时。 获取或设置 BitmapEffectInput 的 Visual 值。 (继承自 Visual)
VisualBitmapScalingMode	获取或设置 BitmapScalingMode 的 Visual。 (继承自 Visual)
VisualCacheMode	获取或设置 Visual 的缓存表示形式。 (继承自 Visual)
VisualChildrenCount	获取 ContainerVisual 的子对象的数量。 (继承自 ContainerVisual)
VisualClearTypeHint	获取或设置 ClearTypeHint，它确定在 Visual 中呈现 ClearType 的方式。 (继承自 Visual)
VisualClip	获取或设置 Visual 的剪辑区域作为 Geometry 值。 (继承自 Visual)
VisualEdgeMode	获取或设置 Visual 的边缘模式作为 EdgeMode 值。 (继承自 Visual)
VisualEffect	获取或设置要应用于 Visual 的位图效果。 (继承自 Visual)
VisualOffset	获取或设置可视对象的偏移量值。 (继承自 Visual)
VisualOpacity	获取或设置 Visual 的不透明度。 (继承自 Visual)
VisualOpacityMask	获取或设置 Brush 值，该值表示 Visual 的不透明蒙板。 (继承自 Visual)
VisualParent	获取可视对象的可视化树父级。 (继承自 Visual)
VisualScrollableAreaClip	获取或设置 Visual 的剪辑的可滚动区域。 (继承自 Visual)
VisualTextHintingMode	获取或设置 Visual 的 TextHintingMode。 (继承自 Visual)
VisualTextRenderingMode	获取或设置 Visual 的 TextRenderingMode。 (继承自 Visual)
VisualTransform	获取或设置 Transform 的 Visual 值。 (继承自 Visual)
VisualXSnappingGuidelines	获取或设置 x 坐标（垂直）准线集合。 (继承自 Visual)
VisualYSnappingGuidelines	获取或设置 Y 坐标（水平）准线集合。 (继承自 Visual)
XSnappingGuidelines	为 ContainerVisual 获取或设置 X（水平）准线。 (继承自 ContainerVisual)
YSnappingGuidelines	为 ContainerVisual 获取或设置 Y（垂直）准线。 (继承自 ContainerVisual)

方法

AddVisualChild(Visual)	定义两个可视对象之间的父子关系。 (继承自 Visual)
CheckAccess()	确定调用线程是否可以访问此 DispatcherObject。 (继承自 DispatcherObject)
ClearValue(DependencyProperty)	清除属性的本地值。 要清除的属性由 DependencyProperty 标识符指定。 (继承自 DependencyObject)
ClearValue(DependencyPropertyKey)	清除只读属性的本地值。 要清除的属性由 DependencyPropertyKey 指定。 (继承自 DependencyObject)
CoerceValue(DependencyProperty)	对指定依赖属性的值进行强制。 通过对调用方 DependencyObject 上存在的依赖属性的属性元数据中所指定的任何 CoerceValueCallback 函数进行调用来完成此操作。 (继承自 DependencyObject)
Equals(Object)	确定提供的 DependencyObject 是否等效于当前 DependencyObject。 (继承自 DependencyObject)
FindCommonVisualAncestor(DependencyObject)	返回两个可视对象的公共上级。 (继承自 Visual)
GetHashCode()	获取此 DependencyObject 的哈希代码。 (继承自 DependencyObject)
GetLocalValueEnumerator()	创建一个专用的枚举数，用于确定哪些依赖项属性在此 DependencyObject 上具有以本地方式设置的值。 (继承自 DependencyObject)
GetType()	获取当前实例的 Type。 (继承自 Object)
GetValue(DependencyProperty)	对 DependencyObject 的此实例返回依赖属性的当前有效值。 (继承自 DependencyObject)
GetVisualChild(Int32)	返回父级 ContainerVisual 指定的子级 Visual。 (继承自 ContainerVisual)
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	使用 HitTestFilterCallback 和 HitTestResultCallback 对象启动 ContainerVisual 上的命中测试。 (继承自 ContainerVisual)
HitTest(Point)	通过指定 Point 返回命中测试最顶端的可视对象。 (继承自 ContainerVisual)
HitTestCore(GeometryHitTestParameters)	确定可视对象的边界中是否存在几何图形值。
HitTestCore(PointHitTestParameters)	确定在 DrawingVisual 对象的边界中是否存在点坐标值。
InvalidateProperty(DependencyProperty)	重新评估指定依赖属性的有效值。 (继承自 DependencyObject)
IsAncestorOf(DependencyObject)	确定可视对象是否为后代可视对象的上级。 (继承自 Visual)
IsDescendantOf(DependencyObject)	确定可视对象是否为上级可视对象的后代。 (继承自 Visual)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnDpiChanged(DpiScale, DpiScale)	呈现此视图时所使用的 DPI 发生变化时进行调用。 (继承自 Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	每当更新此 DependencyObject 的任何依赖属性的有效值时调用。 更改的特定依赖属性将在事件数据中报告。 (继承自 DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	修改可视对象的 VisualCollection 时调用。 (继承自 Visual)
OnVisualParentChanged(DependencyObject)	当可视对象的父级更改时调用。 (继承自 Visual)
PointFromScreen(Point)	将屏幕坐标中的 Point 转换为表示 Point 的当前坐标系的 Visual。 (继承自 Visual)
PointToScreen(Point)	将表示 Point 的当前坐标系的 Visual 转换为屏幕坐标中的 Point。 (继承自 Visual)
ReadLocalValue(DependencyProperty)	如果存在，则返回依赖属性的本地值。 (继承自 DependencyObject)
RemoveVisualChild(Visual)	移除两个可视对象之间的父子关系。 (继承自 Visual)
RenderOpen()	打开用于呈现的 DrawingVisual 对象。 返回的 DrawingContext 值可用于呈现为 DrawingVisual。
SetCurrentValue(DependencyProperty, Object)	设置依赖属性的值而不更改其值源。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置依赖属性的本地值，该值由其依赖属性标识符指定。 (继承自 DependencyObject)
SetValue(DependencyPropertyKey, Object)	设置一个只读依赖属性的本地值，该值由依赖属性的 DependencyPropertyKey 标识符指定。 (继承自 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	返回一个值，该值指示序列化进程是否应序列化所提供的依赖属性的值。 (继承自 DependencyObject)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TransformToAncestor(Visual)	返回一个转换，该转换可用于将 Visual 中的坐标转换为可视对象的指定 Visual 上级。 (继承自 Visual)
TransformToAncestor(Visual3D)	返回一个转换，该转换可用于将 Visual 中的坐标转换为可视对象的指定 Visual3D 上级。 (继承自 Visual)
TransformToDescendant(Visual)	返回一个转换，该转换可用于将 Visual 中的坐标转换为指定的可视对象后代。 (继承自 Visual)
TransformToVisual(Visual)	返回一个转换，该转换可用于将 Visual 中的坐标转换为指定的可视对象。 (继承自 Visual)
VerifyAccess()	强制调用线程具有此 DispatcherObject 的访问权限。 (继承自 DispatcherObject)