DrawingVisual 类

定义

命名空间:: System.Windows.Media

程序集:: PresentationCore.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

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	获取或设置 <a0/a0> 的剪辑区域。 (继承自 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	获取或设置基于 0=transparent、1=opaque 的 ContainerVisual不透明度。 (继承自 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 确定 ClearType 在 Visual中的呈现方式。 (继承自 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	获取或设置 TextHintingMode 的 Visual。 (继承自 Visual)
VisualTextRenderingMode	获取或设置 TextRenderingMode 的 Visual。 (继承自 Visual)
VisualTransform	获取或设置 Transform Visual.. (继承自 Visual)
VisualXSnappingGuidelines	获取或设置 x 坐标（垂直）准则集合。 (继承自 Visual)
VisualYSnappingGuidelines	获取或设置 y 坐标（水平）准则集合。 (继承自 Visual)
XSnappingGuidelines	获取或设置的 X （水平）准则 ContainerVisual。 (继承自 ContainerVisual)
YSnappingGuidelines	获取或设置 Y （垂直）准则 ContainerVisual。 (继承自 ContainerVisual)

方法

名称	说明
AddVisualChild(Visual)	定义两个视觉对象之间的父子关系。 (继承自 Visual)
CheckAccess()	确定调用线程是否有权访问此 DispatcherObject权限。 (继承自 DispatcherObject)
ClearValue(DependencyProperty)	清除属性的本地值。要清除的属性由 DependencyProperty 标识符指定。 (继承自 DependencyObject)
ClearValue(DependencyPropertyKey)	清除只读属性的本地值。要清除的属性由一个 DependencyPropertyKey. (继承自 DependencyObject)
CoerceValue(DependencyProperty)	强制指定依赖属性的值。这是通过调用中调用依赖属性CoerceValueCallback的属性元数据中指定的任何DependencyObject函数来实现的。 (继承自 DependencyObject)
Equals(Object)	确定提供的 DependencyObject 是否等效于当前 DependencyObject。 (继承自 DependencyObject)
FindCommonVisualAncestor(DependencyObject)	返回两个视觉对象的常见上级。 (继承自 Visual)
GetHashCode()	获取此 DependencyObject代码的哈希代码。 (继承自 DependencyObject)
GetLocalValueEnumerator()	创建一个专用枚举器，用于确定哪些依赖项属性具有本地 DependencyObject设置的值。 (继承自 DependencyObject)
GetType()	获取当前实例的 Type。 (继承自 Object)
GetValue(DependencyProperty)	返回此实例 DependencyObject上的依赖属性的当前有效值。 (继承自 DependencyObject)
GetVisualChild(Int32)	返回父Visual级的指定子级 ContainerVisual 。 (继承自 ContainerVisual)
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	通过使用ContainerVisual和HitTestFilterCallback对象启动命中测试HitTestResultCallback。 (继承自 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)

适用于

反馈

此页面是否有帮助？

通过

DrawingVisual 类

定义

注解

构造函数

属性

方法

适用于

反馈