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)	Определяет связь родительского-дочернего элемента между двумя трехмерных визуальными элементами. (Унаследовано от Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Применяет эффект заданного AnimationClock свойства зависимостей. Влияние нового AnimationClock на любые текущие анимации определяется значением `handoffBehavior` параметра. (Унаследовано от Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Применяет эффект заданного AnimationClock свойства зависимостей. (Унаследовано от Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Инициирует последовательность анимации для DependencyProperty объекта в зависимости от указанного иHandoffBehavior.AnimationTimeline (Унаследовано от Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline)	Инициирует последовательность анимации для DependencyProperty объекта на основе указанного AnimationTimeline. (Унаследовано от 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)	Добавляет текстовое содержимое узла в объект.

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

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через