Viewport2DVisual3D Viewport2DVisual3D Viewport2DVisual3D Viewport2DVisual3D Class

Definición

Representa los elementos secundarios 2D dentro de los límites de la ventanilla 3D especificados.Renders the 2-D children within the specified 3-D viewport bounds.

public ref class Viewport2DVisual3D sealed : System::Windows::Media::Media3D::Visual3D
[System.Windows.Markup.ContentProperty("Visual")]
public sealed class Viewport2DVisual3D : System.Windows.Media.Media3D.Visual3D
type Viewport2DVisual3D = class
    inherit Visual3D
Public NotInheritable Class Viewport2DVisual3D
Inherits Visual3D
Herencia
Atributos

Ejemplos

El ejemplo siguiente muestra cómo colocar un botón, un objeto 2D, en un objeto 3D.The following example shows how to place a button, a 2-D object, on a 3-D object. Tenga en cuenta que debe establecer el IsVisualHostMaterial propiedad adjunta en el material en el que desea que los coloca elementos visuales 2D.Note that you must set the IsVisualHostMaterial attached property on the material on which you wish to have the 2-D visual placed.

<Viewport3D>
    <Viewport3D.Camera>
        <PerspectiveCamera Position="0, 0, 4"/>
    </Viewport3D.Camera>
    
    <!-- Button on 3D -->
    <Viewport2DVisual3D>
        <!-- Give the plane a slight rotation -->
        <Viewport2DVisual3D.Transform>
            <RotateTransform3D>
                <RotateTransform3D.Rotation>
                    <AxisAngleRotation3D Angle="40" Axis="0, 1, 0" />
                </RotateTransform3D.Rotation>
            </RotateTransform3D>
        </Viewport2DVisual3D.Transform>
        
        <!-- The Geometry, Material, and Visual for the Viewport2DVisual3D -->
        <Viewport2DVisual3D.Geometry>
            <MeshGeometry3D Positions="-1,1,0 -1,-1,0 1,-1,0 1,1,0"
                            TextureCoordinates="0,0 0,1 1,1 1,0" TriangleIndices="0 1 2 0 2 3"/>
        </Viewport2DVisual3D.Geometry>

        <Viewport2DVisual3D.Material>
            <DiffuseMaterial Viewport2DVisual3D.IsVisualHostMaterial="True" Brush="White"/>
        </Viewport2DVisual3D.Material>                               
        
        <Button>Hello, 3D</Button>
    </Viewport2DVisual3D>
    
    <!-- Lights -->
    <ModelVisual3D>
        <ModelVisual3D.Content>
            <DirectionalLight Color="#FFFFFFFF" Direction="0,0,-1"/>
        </ModelVisual3D.Content>
    </ModelVisual3D>
</Viewport3D>

Comentarios

Viewport2DVisual3D le permite colocar contenido 2D interactivo en un objeto 3D.Viewport2DVisual3D enables you to place interactive 2-D content on a 3-D object. Su equivalente es el Viewport3DVisual (clase), que es un objeto visual 2D con elementos secundarios 3D.Its counterpart is the Viewport3DVisual class, which is a 2-D visual with 3-D children.

Viewport2DVisual3D se introdujo en .NET Framework versión 3.5.Viewport2DVisual3D is introduced in the .NET Framework version 3.5.

Constructores

Viewport2DVisual3D() Viewport2DVisual3D() Viewport2DVisual3D() Viewport2DVisual3D()

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

Campos

CacheModeProperty CacheModeProperty CacheModeProperty CacheModeProperty

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

GeometryProperty GeometryProperty GeometryProperty GeometryProperty

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

IsVisualHostMaterialProperty IsVisualHostMaterialProperty IsVisualHostMaterialProperty IsVisualHostMaterialProperty

Identifica la propiedad adjunta IsVisualHostMaterial.Identifies the IsVisualHostMaterial attached property.

MaterialProperty MaterialProperty MaterialProperty MaterialProperty

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

VisualProperty VisualProperty VisualProperty VisualProperty

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

Propiedades

CacheMode CacheMode CacheMode CacheMode

Obtiene o establece una representación en caché del objeto Viewport2DVisual3D.Gets or sets a cached representation of the Viewport2DVisual3D.

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

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

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Obtiene el Dispatcher esto DispatcherObject está asociado.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
Geometry Geometry Geometry Geometry

Obtiene o establece la geometría 3D de este objeto Viewport2DVisual3D.Gets or sets the 3-D geometry for this Viewport2DVisual3D.

HasAnimatedProperties HasAnimatedProperties HasAnimatedProperties HasAnimatedProperties

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

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

(Inherited from DependencyObject)
Material Material Material Material

Obtiene o establece el material que describe el aspecto del objeto 3D.Gets or sets the material that describes the appearance of the 3-D object.

Transform Transform Transform Transform

Obtiene o establece la transformación aplicada al objeto 3D.Gets or sets the transformation that is applied to the 3-D object.

(Inherited from Visual3D)
Visual Visual Visual Visual

Obtiene o establece los elementos visuales 2D que se van a colocar en el objeto 3D.Gets or sets the 2-D visual to be placed on the 3-D object.

Visual3DChildrenCount Visual3DChildrenCount Visual3DChildrenCount Visual3DChildrenCount

Obtiene el número de elementos secundarios del objeto Visual3D.Gets the number of child elements for the Visual3D object.

(Inherited from Visual3D)
Visual3DModel Visual3DModel Visual3DModel Visual3DModel

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

(Inherited from Visual3D)

Propiedades adjuntas

IsVisualHostMaterial IsVisualHostMaterial IsVisualHostMaterial IsVisualHostMaterial

Obtiene o establece un valor que especifica si un material debe ser interactivo.Gets or sets a value that specifies whether a material should be interactive.

Métodos

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

Define la relación primario-secundario entre dos objetos visuales 3D.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)

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.

(Inherited from Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) 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.

(Inherited from Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) 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.

(Inherited from Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) 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.

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

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

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) 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.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) 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.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) 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.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) 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.

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

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

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

(Inherited from Visual3D)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Obtiene el código hash de DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetIsVisualHostMaterial(Material) GetIsVisualHostMaterial(Material) GetIsVisualHostMaterial(Material) GetIsVisualHostMaterial(Material)

Obtiene el valor de la propiedad adjunta IsVisualHostMaterial de un UIElement especificado.Gets the value of the IsVisualHostMaterial attached property for a specified UIElement.

GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() 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.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) 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.

(Inherited from DependencyObject)
GetVisual3DChild(Int32) GetVisual3DChild(Int32) GetVisual3DChild(Int32) GetVisual3DChild(Int32)

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

(Inherited from Visual3D)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

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

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

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

(Inherited from Visual3D)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) 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. Se informa de la propiedad de dependencia concreta que cambió en los datos de evento.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)

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

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

(Inherited from Visual3D)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

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

(Inherited from DependencyObject)
RemoveVisual3DChild(Visual3D) RemoveVisual3DChild(Visual3D) RemoveVisual3DChild(Visual3D) RemoveVisual3DChild(Visual3D)

Quita la relación primario-secundario entre dos objetos visuales 3D.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)

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.

(Inherited from DependencyObject)
SetIsVisualHostMaterial(Material, Boolean) SetIsVisualHostMaterial(Material, Boolean) SetIsVisualHostMaterial(Material, Boolean) SetIsVisualHostMaterial(Material, Boolean)

Establece el valor de la propiedad adjunta IsVisualHostMaterial en un elemento especificado.Sets the value of the IsVisualHostMaterial attached property to a specified element.

SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) 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.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) 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.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) 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.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual) 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.

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

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

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

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

(Inherited from DispatcherObject)

Se aplica a