ModelVisual3D Clase

Definición

Proporciona una clase Visual3D que presenta objetos 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
[<System.Windows.Markup.ContentProperty("Children")>]
type ModelVisual3D = class
    inherit Visual3D
    interface IAddChild
Public Class ModelVisual3D
Inherits Visual3D
Implements IAddChild
Herencia
Atributos
Implementaciones

Ejemplos

En el ejemplo siguiente se muestra una instancia de ModelVisual3D en el marcado.The following example shows an instance of ModelVisual3D in markup. myTeapot hace referencia a un MeshGeometry3D definido externamente.myTeapot refers to a MeshGeometry3D defined externally. Puede sustituir cualquier geometría de su propiedad.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>

Comentarios

Proporciona servicios y propiedades que son comunes a todos los objetos visuales, incluidas las pruebas de posicionamiento, la transformación de coordenadas y los cálculos de cuadro de límite.Provides services and properties that are common to all visual objects, including hit-testing, coordinate transformation, and bounding-box calculations.

La ModelVisual3D clase tiene una Children propiedad que permite compilar una estructura de árbol de ModelVisual3D objetos.The ModelVisual3D class has a Children property that enables you to build a tree structure of ModelVisual3D objects.

ModelVisual3D los objetos se optimizan como nodos de la escena.ModelVisual3D objects are optimized as scene nodes. Por ejemplo, almacenan en caché los límites.For example, they cache bounds. Siempre que pueda, use ModelVisual3D objetos para instancias únicas de objetos dentro de la escena.Whenever you can, use ModelVisual3D objects for unique instances of objects within your scene. Este uso contrasta con el de Model3D los objetos, que son objetos ligeros que se optimizan para que se compartan y se reutilicen.This usage contrasts with that of Model3D objects, which are lightweight objects that are optimized to be shared and reused. Por ejemplo, use un Model3D objeto para crear un modelo de un automóvil y use diez ModelVisual3D objetos para colocar diez automóviles en la escena.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.

Constructores

ModelVisual3D()

Inicializa una nueva instancia de la clase ModelVisual3D.Initializes a new instance of the ModelVisual3D class.

Campos

ContentProperty

Identifica la propiedad de dependencia Content.Identifies the Content dependency property.

TransformProperty

Identifica la propiedad de dependencia Transform.Identifies the Transform dependency property.

Propiedades

Children

Obtiene una colección de objetos Visual3D secundarios.Gets a collection of child Visual3D objects.

Content

Obtiene o establece el modelo que incluye el contenido de ModelVisual3D.Gets or sets the model that comprises the content of the ModelVisual3D.

DependencyObjectType

Obtiene el objeto DependencyObjectType que ajusta el tipo CLRCLR de esta instancia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Heredado de DependencyObject)
Dispatcher

Obtiene el objeto Dispatcher al que está asociado DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Heredado de DispatcherObject)
HasAnimatedProperties

Obtiene un valor que indica si este Visual3D tiene propiedades animadas.Gets a value that indicates whether this Visual3D has any animated properties.

(Heredado de Visual3D)
IsSealed

Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Heredado de DependencyObject)
Transform

Obtiene o establece la transformación establecida en ModelVisual3D.Gets or sets the transform set on the ModelVisual3D.

Visual3DChildrenCount

Devuelve el número de objetos secundarios.Returns the number of child objects.

Visual3DModel

Obtiene o establece el objeto Model3D que va a representarse.Gets or sets the Model3D object to render.

(Heredado de Visual3D)

Métodos

AddVisual3DChild(Visual3D)

Define la relación primario-secundario entre dos objetos visuales 3D.Defines the parent-child relationship between two 3-D visuals.

(Heredado de Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock)

Aplica el efecto de un AnimationClock determinado a una propiedad de dependencia determinada.Applies the effect of a given AnimationClock to a given dependency property.

(Heredado de Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Aplica el efecto de un AnimationClock determinado a una propiedad de dependencia determinada.Applies the effect of a given AnimationClock to a given dependency property. El efecto del nuevo objeto AnimationClock de cualquier animación actual se determina mediante el valor del parámetro handoffBehavior.The effect of the new AnimationClock on any current animations is determined by the value of the handoffBehavior parameter.

(Heredado de Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline)

Inicia una secuencia de animación para el objeto DependencyProperty, en función de la clase AnimationTimeline especificada.Initiates an animation sequence for the DependencyProperty object, based on the specified AnimationTimeline.

(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.Initiates an animation sequence for the DependencyProperty object, based on both the specified AnimationTimeline and HandoffBehavior.

(Heredado de Visual3D)
CheckAccess()

Determina si el subproceso de la llamada tiene acceso a DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Heredado de DispatcherObject)
ClearValue(DependencyProperty)

Borra el valor local de una propiedad.Clears the local value of a property. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)

Borra el valor local de una propiedad de solo lectura.Clears the local value of a read-only property. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Heredado de DependencyObject)
CoerceValue(DependencyProperty)

Convierte el valor de la propiedad de dependencia especificada.Coerces the value of the specified dependency property. 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.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Heredado de DependencyObject)
Equals(Object)

Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Heredado de DependencyObject)
FindCommonVisualAncestor(DependencyObject)

Devuelve el antecesor común del objeto visual y otro objeto visual especificado.Returns the common ancestor of the visual object and another specified visual object.

(Heredado de Visual3D)
GetAnimationBaseValue(DependencyProperty)

Recupera el valor base del objeto DependencyProperty especificado.Retrieves the base value of the specified DependencyProperty object.

(Heredado de Visual3D)
GetHashCode()

Obtiene un código hash de este objeto DependencyObject.Gets a hash code for this DependencyObject.

(Heredado de DependencyObject)
GetLocalValueEnumerator()

Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Heredado de DependencyObject)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
GetValue(DependencyProperty)

Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Heredado de DependencyObject)
GetVisual3DChild(Int32)

Devuelve el objeto Visual3D especificado de la colección primaria.Returns the specified Visual3D in the parent collection.

InvalidateProperty(DependencyProperty)

Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada.Re-evaluates the effective value for the specified dependency property.

(Heredado de DependencyObject)
IsAncestorOf(DependencyObject)

Determina si el objeto visual es un antecesor del objeto visual descendiente.Determines whether the visual object is an ancestor of the descendant visual object.

(Heredado de Visual3D)
IsDescendantOf(DependencyObject)

Determina si el objeto visual es un descendiente del objeto visual antecesor.Determines whether the visual object is a descendant of the ancestor visual object.

(Heredado de Visual3D)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La propiedad de dependencia específica que cambió se notifica en los datos de evento.The specific dependency property that changed is reported in the event data.

(Heredado de DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Se le llama cuando se modifica la colección Visual3DCollection del objeto visual.Called when the Visual3DCollection of the visual object is modified.

(Heredado de Visual3D)
OnVisualParentChanged(DependencyObject)

Se llama a este método cuando se cambia el objeto primario del objeto visual 3D.Called when the parent of the 3-D visual object is changed.

(Heredado de Visual3D)
ReadLocalValue(DependencyProperty)

Devuelve el valor local de una propiedad de dependencia, si existe.Returns the local value of a dependency property, if it exists.

(Heredado de DependencyObject)
RemoveVisual3DChild(Visual3D)

Quita la relación primario-secundario entre dos objetos visuales 3D.Removes the parent-child relationship between two 3-D visuals.

(Heredado de Visual3D)
SetCurrentValue(DependencyProperty, Object)

Establece el valor de una propiedad de dependencia sin cambiar el origen del valor.Sets the value of a dependency property without changing its value source.

(Heredado de DependencyObject)
SetValue(DependencyProperty, Object)

Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia.Sets the local value of a dependency property, specified by its dependency property identifier.

(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.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(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.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Heredado de DependencyObject)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(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.Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual ancestor of the object.

(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.Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual3D ancestor of the object.

(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.Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual3D descent object.

(Heredado de Visual3D)
VerifyAccess()

Exige que el subproceso de la llamada tenga acceso a DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Heredado de DispatcherObject)

Implementaciones de interfaz explícitas

IAddChild.AddChild(Object)

Agrega un objeto secundario.Adds a child object.

IAddChild.AddText(String)

Agrega el contenido de texto de un nodo al objeto.Adds the text content of a node to the object.

Se aplica a