ModelVisual3D Класс

Ссылка

Определение

Пространство имен:: System.Windows.Media.Media3D

Сборка:: PresentationCore.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

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

[<System.Windows.Markup.ContentProperty("Children")>]
type ModelVisual3D = class
    inherit Visual3D
    interface IAddChild

Public Class ModelVisual3D
Inherits Visual3D
Implements IAddChild

Наследование: Object

DispatcherObject

DependencyObject

Visual3D
ModelVisual3D

Атрибуты: ContentPropertyAttribute

Реализации: IAddChild

Примеры

В следующем примере показан экземпляр ModelVisual3D в разметке. myTeapot относится к определенному внешнему объекту MeshGeometry3D . Вы можете заменить любую геометрию собственной.

<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>

Предоставляет службы и свойства, общие для всех визуальных объектов, включая тестирование попаданий, преобразование координат и вычисления ограничивающего прямоугольного поля.

Класс ModelVisual3D имеет Children свойство, позволяющее создать древовидную структуру ModelVisual3D объектов.

ModelVisual3D объекты оптимизированы как узлы сцены. Например, они кэшируют границы. Каждый раз, когда вы можете, используйте ModelVisual3D объекты для уникальных экземпляров объектов в сцене. Это использование отличается от объектов, которые являются упрощенными объектами Model3D , оптимизированными для совместного использования и повторного использования. Например, используйте Model3D объект для создания модели автомобиля и используйте десять ModelVisual3D объектов для размещения десяти автомобилей в сцене.

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

ModelVisual3D()

Инициализирует новый экземпляр класса ModelVisual3D.

Поля

ContentProperty	Идентифицирует свойство зависимостей Content.
TransformProperty	Идентифицирует свойство зависимостей Transform.

Свойства

Children	Получает коллекцию дочерних объектов Visual3D.
Content	Получает или задает модель, которая включает содержимое объекта ModelVisual3D.
DependencyObjectType	Возвращает объект DependencyObjectType , который заключает в оболочку тип среды CLR данного экземпляра. (Унаследовано от DependencyObject)
Dispatcher	Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject. (Унаследовано от DispatcherObject)
HasAnimatedProperties	Возвращает значение, указывающее, имеет ли объект Visual3D анимированные свойства. (Унаследовано от Visual3D)
IsSealed	Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения). (Унаследовано от DependencyObject)
Transform	Получает или задает набор преобразований на объекте ModelVisual3D.
Visual3DChildrenCount	Возвращает число дочерних объектов.
Visual3DModel	Получает или задает объект Model3D для отображения. (Унаследовано от Visual3D)

Методы

AddVisual3DChild(Visual3D)	Определяет связь "родитель-потомок" между двумя визуальными объектами 3-D. (Унаследовано от Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Применяет результат заданного объекта AnimationClock к указанному свойству зависимостей. (Унаследовано от Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Применяет результат заданного объекта AnimationClock к указанному свойству зависимостей. Эффект нового объекта AnimationClock на любых текущих анимациях определяется значением параметра `handoffBehavior`. (Унаследовано от Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline)	Инициирует последовательность анимации для объекта DependencyProperty на основе указанной временной шкалы AnimationTimeline. (Унаследовано от Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Инициирует последовательность анимации для объекта DependencyProperty на основе заданных объектов AnimationTimeline и HandoffBehavior. (Унаследовано от Visual3D)
CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Очищаемое свойство задается идентификатором DependencyProperty. (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение доступного только для чтения свойства. Очищаемое свойство задается ключом DependencyPropertyKey. (Унаследовано от DependencyObject)
CoerceValue(DependencyProperty)	Приводит значение указанного свойства зависимостей. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject. (Унаследовано от DependencyObject)
Equals(Object)	Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject. (Унаследовано от DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Возвращает общего предка визуального объекта и другой указанный виртуальный объект. (Унаследовано от Visual3D)
GetAnimationBaseValue(DependencyProperty)	Возвращает базовое значение указанного объекта DependencyProperty. (Унаследовано от Visual3D)
GetHashCode()	Возвращает хэш-код для данного объекта DependencyObject. (Унаследовано от DependencyObject)
GetLocalValueEnumerator()	Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject. (Унаследовано от DependencyObject)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetValue(DependencyProperty)	Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject. (Унаследовано от DependencyObject)
GetVisual3DChild(Int32)	Возвращает указанный объект Visual3D в родительскую коллекцию.
InvalidateProperty(DependencyProperty)	Повторно вычисляет действующее значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
IsAncestorOf(DependencyObject)	Определяет, является ли визуальный объект предком потомка визуального объекта. (Унаследовано от Visual3D)
IsDescendantOf(DependencyObject)	Определяет, является ли визуальный объект потомком для предка визуального объекта. (Унаследовано от Visual3D)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного DependencyObject. Конкретное измененное свойство зависимостей сообщается в данных события. (Унаследовано от DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Вызывается при изменении коллекции Visual3DCollection визуального объекта. (Унаследовано от Visual3D)
OnVisualParentChanged(DependencyObject)	Вызывается, если изменяется родительский объект визуального объекта 3-D. (Унаследовано от Visual3D)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если таковое существует. (Унаследовано от DependencyObject)
RemoveVisual3DChild(Visual3D)	Удаляет связь "родитель-потомок" между двумя визуальными объектами 3-D. (Унаследовано от Visual3D)
SetCurrentValue(DependencyProperty, Object)	Задает значение свойства зависимостей, не меняя источник значения. (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства. (Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)	Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей. (Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей. (Унаследовано от DependencyObject)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TransformToAncestor(Visual)	Возвращает преобразование, которое может использоваться для преобразования координат из этого объекта Visual3D к заданному предку Visual объекта. (Унаследовано от Visual3D)
TransformToAncestor(Visual3D)	Возвращает преобразование, которое может использоваться для преобразования координат из этого объекта Visual3D к заданному предку Visual3D объекта. (Унаследовано от Visual3D)
TransformToDescendant(Visual3D)	Возвращает преобразование, которое может использоваться для преобразования координат из этого объекта Visual3D в указанный Visual3D объект спуска. (Унаследовано от Visual3D)
VerifyAccess()	Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)

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

IAddChild.AddChild(Object)	Добавляет дочерний объект.
IAddChild.AddText(String)	Добавляет к объекту текстовое содержимое узла.

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