ModelVisual3D ModelVisual3D ModelVisual3D ModelVisual3D Class

Определение

Предоставляет объект Visual3D, отображающий объекты Model3D.Provides a Visual3D that renders Model3D objects.

public ref class ModelVisual3D : System::Windows::Media::Media3D::Visual3D, System::Windows::Markup::IAddChild
[System.Windows.Markup.ContentProperty("Children")]
public class ModelVisual3D : System.Windows.Media.Media3D.Visual3D, System.Windows.Markup.IAddChild
type ModelVisual3D = class
    inherit Visual3D
    interface IAddChild
Public Class ModelVisual3D
Inherits Visual3D
Implements IAddChild
Наследование
Атрибуты
Реализации

Примеры

В следующем примере показан экземпляр ModelVisual3D в разметке.The following example shows an instance of ModelVisual3D in markup. myTeapotссылается на определенный внешний. MeshGeometry3DmyTeapot refers to a MeshGeometry3D defined externally. Вы можете заменить любую геометрию своей собственной.You can substitute any geometry of your own.

<DockPanel>
  <Viewport3D Name="myViewport">

    <Viewport3D.Camera>
      <PerspectiveCamera FarPlaneDistance="20" LookDirection="5,-2,-3" UpDirection="0,1,0" NearPlaneDistance="0" Position="-5,2,3" FieldOfView="45" />
    </Viewport3D.Camera>

    <ModelVisual3D x:Name="topModelVisual3D">
      <ModelVisual3D.Children>
        <ModelVisual3D>
          <ModelVisual3D.Content>
            <DirectionalLight Color="#FFFFFFFF" Direction="-3,-4,-5" />
          </ModelVisual3D.Content>
        </ModelVisual3D>

        <ModelVisual3D>
          <ModelVisual3D.Content>
            <GeometryModel3D Geometry="{StaticResource myTeapot}">
              <GeometryModel3D.Material>
                <DiffuseMaterial>
                  <DiffuseMaterial.Brush>
                    <SolidColorBrush Color="Blue" Opacity="1.0" />
                  </DiffuseMaterial.Brush>
                </DiffuseMaterial>
              </GeometryModel3D.Material>
              <GeometryModel3D.Transform>
                <RotateTransform3D>
                  <RotateTransform3D.Rotation>
                    <AxisAngleRotation3D x:Name="myAngleRotation" Axis="0,3,0" Angle="1" />
                  </RotateTransform3D.Rotation>
                </RotateTransform3D>
              </GeometryModel3D.Transform>
            </GeometryModel3D>
          </ModelVisual3D.Content>
        </ModelVisual3D>


      </ModelVisual3D.Children>
    </ModelVisual3D>


    <Viewport3D.Triggers>

      <EventTrigger RoutedEvent="Viewport3D.Loaded">
        <BeginStoryboard>
          <Storyboard>
            <DoubleAnimation 
              Storyboard.TargetName="myAngleRotation"
              Storyboard.TargetProperty="Angle"
              From="0" To="360" Duration="0:0:10"
              RepeatBehavior="Forever" />
          </Storyboard>
        </BeginStoryboard>
      </EventTrigger>
    </Viewport3D.Triggers>


  </Viewport3D>
</DockPanel>

Комментарии

Предоставляет службы и свойства, общие для всех визуальных объектов, включая проверку попадания, преобразование координат и вычисления ограничивающих прямоугольников.Provides services and properties that are common to all visual objects, including hit-testing, coordinate transformation, and bounding-box calculations.

Класс имеет свойство, которое позволяет ModelVisual3D построить древовидную структуру объектов. Children ModelVisual3DThe ModelVisual3D class has a Children property that enables you to build a tree structure of ModelVisual3D objects.

ModelVisual3Dобъекты оптимизируются как узлы сцены.ModelVisual3D objects are optimized as scene nodes. Например, они кэшируют границы.For example, they cache bounds. Каждый раз, когда это ModelVisual3D возможно, используйте объекты для уникальных экземпляров объектов в сцене.Whenever you can, use ModelVisual3D 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.

Конструкторы

ModelVisual3D() ModelVisual3D() ModelVisual3D() ModelVisual3D()

Инициализирует новый экземпляр класса ModelVisual3D.Initializes a new instance of the ModelVisual3D class.

Поля

ContentProperty ContentProperty ContentProperty ContentProperty

Идентифицирует свойство зависимостей Content.Identifies the Content dependency property.

TransformProperty TransformProperty TransformProperty TransformProperty

Идентифицирует свойство зависимостей Transform.Identifies the Transform dependency property.

Свойства

Children Children Children Children

Получает коллекцию дочерних объектов Visual3D.Gets a collection of child Visual3D objects.

Content Content Content Content

Получает или задает модель, которая включает содержимое объекта ModelVisual3D.Gets or sets the model that comprises the content of the ModelVisual3D.

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Возвращает DependencyObjectType, который создает обертку для типа CLRCLR данного экземпляра.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets 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.

(Inherited from Visual3D)
IsSealed IsSealed IsSealed IsSealed

Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
Transform Transform Transform Transform

Получает или задает набор преобразований на объекте ModelVisual3D.Gets or sets the transform set on the ModelVisual3D.

Visual3DChildrenCount Visual3DChildrenCount Visual3DChildrenCount Visual3DChildrenCount

Возвращает число дочерних объектов.Returns the number of child objects.

Visual3DModel Visual3DModel Visual3DModel Visual3DModel

Получает или задает объект Model3D для отображения.Gets or sets the Model3D object to render.

(Inherited from Visual3D)

Методы

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

Определяет связь "родитель-потомок" между двумя визуальными объектами 3-D.Defines the parent-child relationship between two 3-D visuals.

(Inherited from Visual3D)
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.

(Inherited from Visual3D)
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.

(Inherited from Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline)

Инициирует последовательность анимации для объекта DependencyProperty на базе заданного объекта AnimationTimeline.Initiates an animation sequence for the DependencyProperty object, based on the specified AnimationTimeline.

(Inherited from Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Инициирует последовательность анимации для объекта DependencyProperty на основе заданных объектов AnimationTimeline и HandoffBehavior.Initiates an animation sequence for the DependencyProperty object, based on both the specified AnimationTimeline and HandoffBehavior.

(Inherited from Visual3D)
CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines 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. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject.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 эквивалентом текущего DependencyObject.Determines 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.

(Inherited from Visual3D)
GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty)

Возвращает базовое значение указанного объекта DependencyProperty.Retrieves the base value of the specified DependencyProperty object.

(Inherited from Visual3D)
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()

Возвращает объект Type для текущего экземпляра.Gets 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 в родительскую коллекцию.Returns the specified Visual3D in the parent collection.

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.

(Inherited from Visual3D)
IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject)

Определяет, является ли визуальный объект потомком для предка визуального объекта.Determines whether the visual object is a descendant of the ancestor visual object.

(Inherited from Visual3D)
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.

(Inherited from Visual3D)
OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject)

Вызывается, если изменяется родительский объект визуального объекта 3-D.Called when the parent of the 3-D visual object is changed.

(Inherited from Visual3D)
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)

Удаляет связь "родитель-потомок" между двумя визуальными объектами 3-D.Removes the parent-child relationship between two 3-D visuals.

(Inherited from Visual3D)
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.

(Inherited from Visual3D)
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.

(Inherited from Visual3D)
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.

(Inherited from Visual3D)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Явные реализации интерфейса

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

Добавляет дочерний объект.Adds a child object.

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

Добавляет текстовое содержимое узла в объект.Adds the text content of a node to the object.

Применяется к