Visual3D Visual3D Visual3D Visual3D Class

定义

提供可视三维对象通用的服务和属性,其中包括命中测试、坐标转换和边界框计算。Provides services and properties that are common to visual 3-D objects, including hit-testing, coordinate transformation, and bounding box calculations.

public ref class Visual3D abstract : System::Windows::DependencyObject, System::Windows::Media::Animation::IAnimatable
public abstract class Visual3D : System.Windows.DependencyObject, System.Windows.Media.Animation.IAnimatable
type Visual3D = class
    inherit DependencyObject
    interface DUCE.IResource
    interface IAnimatable
Public MustInherit Class Visual3D
Inherits DependencyObject
Implements IAnimatable
继承
派生
实现

注解

与类Model3D不同的Visual3D是, 无法共享或重复使用对象。Unlike the Model3D class, Visual3D objects cannot be shared or reused.

Visual3D 通过VisualTreeHelper在类上使用静态方法来访问服务。Access Visual3D services by using static methods on the VisualTreeHelper class.

Visual3D对象被优化为场景节点。Visual3D objects are optimized to be scene nodes. 例如, 它们缓存界限。For example, they cache bounds. 无论何时, 都可以Visual3D使用对象来查找场景中对象的唯一实例。Whenever you can, use Visual3D objects for unique instances of objects within your scene. 这种Model3D用法与对象 (即经过优化可共享和重复使用的轻型对象) 的使用情况相比较。This usage contrasts with that of Model3D objects, which are lightweight objects that are optimized to be shared and reused. 例如, 使用Model3D对象构建汽车的模型, 并使用十个ModelVisual3D对象在场景中放置十辆车。For example, use a Model3D object to build a model of a car; and use ten ModelVisual3D objects to place ten cars in your scene.

字段

TransformProperty TransformProperty TransformProperty TransformProperty

标识 Transform 依赖项属性。Identifies the Transform dependency property.

属性

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

获取对此实例的 CLRCLR 类型进行包装的 DependencyObjectTypeGets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

获取与此 Dispatcher 关联的 DispatcherObjectGets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
HasAnimatedProperties HasAnimatedProperties HasAnimatedProperties HasAnimatedProperties

获取一个值,该值指示此 Visual3D 是否具有任何进行动画处理的属性。Gets a value that indicates whether this Visual3D has any animated properties.

IsSealed IsSealed IsSealed IsSealed

获取一个值,该值指示此实例当前是否为密封的(只读)。Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
Transform Transform Transform Transform

获取或设置应用于三维对象的变换。Gets or sets the transformation that is applied to the 3-D object.

Visual3DChildrenCount Visual3DChildrenCount Visual3DChildrenCount Visual3DChildrenCount

获取 Visual3D 对象的子元素数量。Gets the number of child elements for the Visual3D object.

Visual3DModel Visual3DModel Visual3DModel Visual3DModel

获取或设置要呈现的 Model3D 对象。Gets or sets the Model3D object to render.

方法

AddVisual3DChild(Visual3D) AddVisual3DChild(Visual3D) AddVisual3DChild(Visual3D) AddVisual3DChild(Visual3D)

定义两个三维可视对象之间的父子关系。Defines the parent-child relationship between two 3-D visuals.

ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock)

将给定 AnimationClock 的效果应用于给定的依赖属性。Applies the effect of a given AnimationClock to a given dependency property.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

将给定 AnimationClock 的效果应用于给定的依赖属性。Applies the effect of a given AnimationClock to a given dependency property. AnimationClock 对任何当前的动画所产生的效果均由 handoffBehavior 参数值确定。The effect of the new AnimationClock on any current animations is determined by the value of the handoffBehavior parameter.

BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline)

基于指定的 AnimationTimelineDependencyProperty 对象初始化动画序列。Initiates an animation sequence for the DependencyProperty object, based on the specified AnimationTimeline.

BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

根据指定的 DependencyPropertyAnimationTimeline 启动 HandoffBehavior 对象的动画序列。Initiates an animation sequence for the DependencyProperty object, based on both the specified AnimationTimeline and HandoffBehavior.

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

确定调用线程是否可以访问此 DispatcherObjectDetermines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

清除属性的本地值。Clears the local value of a property. 要清除的属性由 DependencyProperty 标识符指定。The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

清除只读属性的本地值。Clears the local value of a read-only property. 要清除的属性由 DependencyPropertyKey 指定。The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

对指定依赖属性的值进行强制。Coerces the value of the specified dependency property. 通过对调用方 DependencyObject 上存在的依赖属性的属性元数据中所指定的任何 CoerceValueCallback 函数进行调用来完成此操作。This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

确定提供的 DependencyObject 是否等效于当前 DependencyObjectDetermines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject)

返回可视对象和其他指定可视对象的公共上级。Returns the common ancestor of the visual object and another specified visual object.

GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty)

检索指定 DependencyProperty 对象的基值。Retrieves the base value of the specified DependencyProperty object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

获取此 DependencyObject 的哈希代码。Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

创建一个专用的枚举数,用于确定哪些依赖项属性在此 DependencyObject 上具有以本地方式设置的值。Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

获取当前实例的 TypeGets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

DependencyObject 的此实例返回依赖属性的当前有效值。Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
GetVisual3DChild(Int32) GetVisual3DChild(Int32) GetVisual3DChild(Int32) GetVisual3DChild(Int32)

返回父级 Visual3D 中的指定 Visual3DCollectionReturns the specified Visual3D in the parent Visual3DCollection.

InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

重新计算指定依赖项属性的有效值Re-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject)

确定可视对象是否为后代可视对象的上级。Determines whether the visual object is an ancestor of the descendant visual object.

IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject)

确定可视对象是否为上级可视对象的后代。Determines whether the visual object is a descendant of the ancestor visual object.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

每当更新此 DependencyObject 的任何依赖属性的有效值时调用。Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. 更改的特定依赖项属性将在事件数据中报告。The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject)

修改可视对象的 Visual3DCollection 时调用。Called when the Visual3DCollection of the visual object is modified.

OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject)

在三维可视对象的父级更改时调用。Called when the parent of the 3-D visual object is changed.

ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

如果存在,则返回依赖属性的本地值。Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
RemoveVisual3DChild(Visual3D) RemoveVisual3DChild(Visual3D) RemoveVisual3DChild(Visual3D) RemoveVisual3DChild(Visual3D)

移除两个三维可视对象之间的父子关系。Removes the parent-child relationship between two 3-D visuals.

SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

设置依赖属性的值而不更改其值源。Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

设置依赖属性的本地值,该值由其依赖属性标识符指定。Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

设置一个只读依赖属性的本地值,该值由依赖属性的 DependencyPropertyKey 标识符指定。Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

返回一个值,该值指示序列化进程是否应序列化所提供的依赖属性的值。Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

返回表示当前对象的字符串。Returns a string that represents the current object.

(Inherited from Object)
TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual)

返回一个转换,该转换可用于将此 Visual3D 对象中的坐标转换为该对象的指定 Visual 上级。Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual ancestor of the object.

TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D)

返回一个转换,该转换可用于将此 Visual3D 对象中的坐标转换为该对象的指定 Visual3D 上级。Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual3D ancestor of the object.

TransformToDescendant(Visual3D) TransformToDescendant(Visual3D) TransformToDescendant(Visual3D) TransformToDescendant(Visual3D)

返回一个转换,此转换可用于将坐标从此 Visual3D 对象转换为指定的 Visual3D 派生对象。Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual3D descent object.

VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

强制调用线程具有此 DispatcherObject 的访问权限。Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

适用于