ModelVisual3D Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Media.Media3D

Ensamblado:: PresentationCore.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona una clase Visual3D que presenta objetos 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

Herencia: Object

DispatcherObject

DependencyObject

Visual3D
ModelVisual3D

Atributos: ContentPropertyAttribute

Implementaciones: IAddChild

Ejemplos

En el ejemplo siguiente se muestra una instancia de ModelVisual3D en el marcado. myTeapot hace referencia a un MeshGeometry3D definido externamente. Puede sustituir cualquier geometría propia.

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

Comentarios

Proporciona servicios y propiedades comunes a todos los objetos visuales, incluidas las pruebas de posicionamiento, la transformación de coordenadas y los cálculos de rectángulo de selección.

La ModelVisual3D clase tiene una Children propiedad que permite crear una estructura de árbol de ModelVisual3D objetos.

ModelVisual3D los objetos se optimizan como nodos de escena. Por ejemplo, almacenan en caché los límites. Siempre que pueda, use ModelVisual3D objetos para instancias únicas de objetos dentro de la escena. Este uso contrasta con el de Model3D los objetos, que son objetos ligeros que están optimizados para compartirse y reutilizarse. Por ejemplo, use un Model3D objeto para crear un modelo de un automóvil y use diez ModelVisual3D objetos para colocar diez coches en la escena.

Constructores

ModelVisual3D()

Inicializa una nueva instancia de la clase ModelVisual3D.

Campos

ContentProperty	Identifica la propiedad de dependencia Content.
TransformProperty	Identifica la propiedad de dependencia Transform.

Propiedades

Children	Obtiene una colección de objetos Visual3D secundarios.
Content	Obtiene o establece el modelo que incluye el contenido de ModelVisual3D.
DependencyObjectType	Obtiene el DependencyObjectType objeto que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
Dispatcher	Obtiene el objeto Dispatcher al que está asociado DispatcherObject. (Heredado de DispatcherObject)
HasAnimatedProperties	Obtiene un valor que indica si este Visual3D tiene propiedades animadas. (Heredado de Visual3D)
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Heredado de DependencyObject)
Transform	Obtiene o establece la transformación establecida en ModelVisual3D.
Visual3DChildrenCount	Devuelve el número de objetos secundarios.
Visual3DModel	Obtiene o establece el objeto Model3D que va a representarse. (Heredado de Visual3D)

Métodos

AddVisual3DChild(Visual3D)	Define la relación primario-secundario entre dos objetos visuales 3D. (Heredado de Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Aplica el efecto de un AnimationClock determinado a una propiedad de dependencia determinada. (Heredado de Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Aplica el efecto de un AnimationClock determinado a una propiedad de dependencia determinada. El efecto del nuevo objeto AnimationClock de cualquier animación actual se determina mediante el valor del parámetro `handoffBehavior`. (Heredado de Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline)	Inicia una secuencia de animación para el objeto DependencyProperty, en función de la clase AnimationTimeline especificada. (Heredado de Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Inicia una secuencia de animación para el objeto DependencyProperty, basándose en los dos objetos AnimationTimeline y HandoffBehavior especificados. (Heredado de Visual3D)
CheckAccess()	Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty. (Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey. (Heredado de DependencyObject)
CoerceValue(DependencyProperty)	Convierte el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama. (Heredado de DependencyObject)
Equals(Object)	Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Heredado de DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Devuelve el antecesor común del objeto visual y otro objeto visual especificado. (Heredado de Visual3D)
GetAnimationBaseValue(DependencyProperty)	Recupera el valor base del objeto DependencyProperty especificado. (Heredado de Visual3D)
GetHashCode()	Obtiene un código hash de este objeto DependencyObject. (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Heredado de DependencyObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject. (Heredado de DependencyObject)
GetVisual3DChild(Int32)	Devuelve el objeto Visual3D especificado de la colección primaria.
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Heredado de DependencyObject)
IsAncestorOf(DependencyObject)	Determina si el objeto visual es un antecesor del objeto visual descendiente. (Heredado de Visual3D)
IsDescendantOf(DependencyObject)	Determina si el objeto visual es un descendiente del objeto visual antecesor. (Heredado de Visual3D)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject. La propiedad de dependencia específica que cambió se notifica en los datos de evento. (Heredado de DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Se le llama cuando se modifica la colección Visual3DCollection del objeto visual. (Heredado de Visual3D)
OnVisualParentChanged(DependencyObject)	Se llama a este método cuando se cambia el objeto primario del objeto visual 3D. (Heredado de Visual3D)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject)
RemoveVisual3DChild(Visual3D)	Quita la relación primario-secundario entre dos objetos visuales 3D. (Heredado de Visual3D)
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar el origen del valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia. (Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia especificada. (Heredado de DependencyObject)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TransformToAncestor(Visual)	Devuelve una transformación que se puede usar para transformar coordenadas de este objeto Visual3D al antecesor Visual especificado del objeto. (Heredado de Visual3D)
TransformToAncestor(Visual3D)	Devuelve una transformación que se puede usar para transformar coordenadas de este objeto Visual3D al antecesor Visual3D especificado del objeto. (Heredado de Visual3D)
TransformToDescendant(Visual3D)	Devuelve una transformación que puede usarse para transformar las coordenadas de este objeto Visual3D en el objeto descendiente Visual3D especificado. (Heredado de Visual3D)
VerifyAccess()	Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Heredado de DispatcherObject)

Implementaciones de interfaz explícitas

IAddChild.AddChild(Object)	Agrega un objeto secundario.
IAddChild.AddText(String)	Agrega el contenido de texto de un nodo al objeto.

Se aplica a