Viewport2DVisual3D Classe

Définition

Restitue les enfants 2D dans les limites de fenêtre d'affichage 3D spécifiées.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
Héritage
Attributs

Exemples

L’exemple suivant montre comment placer un bouton, un objet 2D, sur un objet 3D.The following example shows how to place a button, a 2-D object, on a 3-D object. Notez que vous devez définir la IsVisualHostMaterial propriété jointe sur le matériau sur lequel vous souhaitez placer le visuel 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>

Remarques

Viewport2DVisual3Dvous permet de placer du contenu 2D interactif sur un objet 3D.Viewport2DVisual3D enables you to place interactive 2-D content on a 3-D object. Son équivalent est la Viewport3DVisual classe, qui est un visuel 2D avec des enfants 3D.Its counterpart is the Viewport3DVisual class, which is a 2-D visual with 3-D children.

Viewport2DVisual3Dest introduit dans la version 3,5 de .NET Framework.Viewport2DVisual3D is introduced in the .NET Framework version 3.5.

Constructeurs

Viewport2DVisual3D()

Initialise une nouvelle instance de la classe Viewport2DVisual3D.Initializes a new instance of the Viewport2DVisual3D class.

Champs

CacheModeProperty

Identifie la propriété de dépendance CacheMode.Identifies the CacheMode dependency property.

GeometryProperty

Identifie la propriété de dépendance Geometry.Identifies the Geometry dependency property.

IsVisualHostMaterialProperty

Identifie la propriété jointe IsVisualHostMaterial.Identifies the IsVisualHostMaterial attached property.

MaterialProperty

Identifie la propriété de dépendance Material.Identifies the Material dependency property.

VisualProperty

Identifie la propriété de dépendance Visual.Identifies the Visual dependency property.

Propriétés

CacheMode

Obtient ou définit la représentation mise en cache de Viewport2DVisual3D.Gets or sets a cached representation of the Viewport2DVisual3D.

DependencyObjectType

Obtient le DependencyObjectType qui encapsule le type CLRCLR de cette instance.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Hérité de DependencyObject)
Dispatcher

Obtient le Dispatcher associé à DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Hérité de DispatcherObject)
Geometry

Obtient ou définit la géométrie 3D pour Viewport2DVisual3D.Gets or sets the 3-D geometry for this Viewport2DVisual3D.

HasAnimatedProperties

Obtient une valeur qui indique si ce Visual3D comporte des propriétés animées.Gets a value that indicates whether this Visual3D has any animated properties.

(Hérité de Visual3D)
IsSealed

Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule).Gets a value that indicates whether this instance is currently sealed (read-only).

(Hérité de DependencyObject)
Material

Obtient ou définit la matière qui décrit l'apparence de l'objet 3D.Gets or sets the material that describes the appearance of the 3-D object.

Transform

Obtient ou définit la transformation qui est appliquée à l'objet 3D.Gets or sets the transformation that is applied to the 3-D object.

(Hérité de Visual3D)
Visual

Obtient ou définit l'objet visuel 2D à placer sur l'objet 3D.Gets or sets the 2-D visual to be placed on the 3-D object.

Visual3DChildrenCount

Obtient le nombre d'éléments enfants de l'objet Visual3D.Gets the number of child elements for the Visual3D object.

(Hérité de Visual3D)
Visual3DModel

Obtient ou définit l'objet Model3D à restituer.Gets or sets the Model3D object to render.

(Hérité de Visual3D)

Propriétés attachées

IsVisualHostMaterial

Obtient ou définit une valeur qui spécifie si une matière doit être interactive.Gets or sets a value that specifies whether a material should be interactive.

Méthodes

AddVisual3DChild(Visual3D)

Définit la relation parent-enfant entre deux objets visuels 3D.Defines the parent-child relationship between two 3-D visuals.

(Hérité de Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock)

Applique l’effet d’un AnimationClock donné à une propriété de dépendance donnée.Applies the effect of a given AnimationClock to a given dependency property.

(Hérité de Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Applique l’effet d’un AnimationClock donné à une propriété de dépendance donnée.Applies the effect of a given AnimationClock to a given dependency property. L'impact d'une nouvelle horloge AnimationClock sur les animations en cours est déterminé par la valeur du paramètre handoffBehaviorThe effect of the new AnimationClock on any current animations is determined by the value of the handoffBehavior parameter.

(Hérité de Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline)

Initialise une séquence d’animation pour l’objet DependencyProperty, en fonction du AnimationTimeline spécifié.Initiates an animation sequence for the DependencyProperty object, based on the specified AnimationTimeline.

(Hérité de Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Démarre une séquence d'animation pour l'objet DependencyProperty, en fonction à la fois de la chronologie AnimationTimeline et du comportement HandoffBehavior spécifiés.Initiates an animation sequence for the DependencyProperty object, based on both the specified AnimationTimeline and HandoffBehavior.

(Hérité de Visual3D)
CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Hérité de DispatcherObject)
ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété.Clears the local value of a property. La propriété à effacer est spécifiée par un identificateur DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule.Clears the local value of a read-only property. La propriété à effacer est spécifiée par DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Hérité de DependencyObject)
CoerceValue(DependencyProperty)

Convertit la valeur de la propriété de dépendance spécifiée.Coerces the value of the specified dependency property. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Hérité de DependencyObject)
Equals(Object)

Détermine si un DependencyObject fourni est équivalent au DependencyObject réel.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Hérité de DependencyObject)
FindCommonVisualAncestor(DependencyObject)

Retourne l'ancêtre commun de l'objet visuel et d'un autre objet visuel spécifié.Returns the common ancestor of the visual object and another specified visual object.

(Hérité de Visual3D)
GetAnimationBaseValue(DependencyProperty)

Récupère la valeur de base de l'objet DependencyProperty spécifié.Retrieves the base value of the specified DependencyProperty object.

(Hérité de Visual3D)
GetHashCode()

Obtient un code de hachage pour ce DependencyObject.Gets a hash code for this DependencyObject.

(Hérité de DependencyObject)
GetIsVisualHostMaterial(Material)

Obtient la valeur de la propriété attachée IsVisualHostMaterial pour un UIElement spécifié.Gets the value of the IsVisualHostMaterial attached property for a specified UIElement.

GetLocalValueEnumerator()

Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Hérité de DependencyObject)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Hérité de DependencyObject)
GetVisual3DChild(Int32)

Retourne le Visual3D spécifié dans le Visual3DCollection parent.Returns the specified Visual3D in the parent Visual3DCollection.

(Hérité de Visual3D)
InvalidateProperty(DependencyProperty)

Réévalue la valeur effective de la propriété de dépendance spécifiée.Re-evaluates the effective value for the specified dependency property.

(Hérité de DependencyObject)
IsAncestorOf(DependencyObject)

Détermine si l'objet visuel est un ancêtre de l'objet visuel descendant.Determines whether the visual object is an ancestor of the descendant visual object.

(Hérité de Visual3D)
IsDescendantOf(DependencyObject)

Détermine si l'objet visuel est un descendant de l'objet visuel ancêtre.Determines whether the visual object is a descendant of the ancestor visual object.

(Hérité de Visual3D)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce DependencyObject a été mise à jour.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement.The specific dependency property that changed is reported in the event data.

(Hérité de DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Appelé lorsque le Visual3DCollection de l'objet visuel est modifié.Called when the Visual3DCollection of the visual object is modified.

(Hérité de Visual3D)
OnVisualParentChanged(DependencyObject)

Appelé lorsque le parent de l'objet visuel 3D est modifié.Called when the parent of the 3-D visual object is changed.

(Hérité de Visual3D)
ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si elle existe.Returns the local value of a dependency property, if it exists.

(Hérité de DependencyObject)
RemoveVisual3DChild(Visual3D)

Supprime la relation parent-enfant entre deux objets visuels 3D.Removes the parent-child relationship between two 3-D visuals.

(Hérité de Visual3D)
SetCurrentValue(DependencyProperty, Object)

Définit la valeur d’une propriété de dépendance sans modifier sa valeur source.Sets the value of a dependency property without changing its value source.

(Hérité de DependencyObject)
SetIsVisualHostMaterial(Material, Boolean)

Définit la valeur de la propriété attachée IsVisualHostMaterial sur un élément spécifié.Sets the value of the IsVisualHostMaterial attached property to a specified element.

SetValue(DependencyProperty, Object)

Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance.Sets the local value of a dependency property, specified by its dependency property identifier.

(Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Hérité de DependencyObject)
ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)
TransformToAncestor(Visual)

Retourne une transformation qui peut être utilisée pour transformer les coordonnées de cet objet Visual3D dans l'ancêtre Visual spécifié de l'objet.Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual ancestor of the object.

(Hérité de Visual3D)
TransformToAncestor(Visual3D)

Retourne une transformation qui peut être utilisée pour transformer les coordonnées de cet objet Visual3D dans l'ancêtre Visual3D spécifié de l'objet.Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual3D ancestor of the object.

(Hérité de Visual3D)
TransformToDescendant(Visual3D)

Retourne une transformation qui peut être utilisée pour transformer les coordonnées de cet objet Visual3D à l’objet descendant Visual3D spécifié.Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual3D descent object.

(Hérité de Visual3D)
VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Hérité de DispatcherObject)

S’applique à