Viewport2DVisual3D Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Media.Media3D

Assembly:: PresentationCore.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Esegue il rendering degli elementi figlio 2D nei limiti del riquadro di visualizzazione 3D specificati.

public ref class Viewport2DVisual3D sealed : System::Windows::Media::Media3D::Visual3D

[System.Windows.Markup.ContentProperty("Visual")]
public sealed class Viewport2DVisual3D : System.Windows.Media.Media3D.Visual3D

[<System.Windows.Markup.ContentProperty("Visual")>]
type Viewport2DVisual3D = class
    inherit Visual3D

Public NotInheritable Class Viewport2DVisual3D
Inherits Visual3D

Ereditarietà: Object

DispatcherObject

DependencyObject

Visual3D
Viewport2DVisual3D

Attributi: ContentPropertyAttribute

Esempio

Nell'esempio seguente viene illustrato come posizionare un pulsante, un oggetto 2D, in un oggetto 3D. Si noti che è necessario impostare la IsVisualHostMaterial proprietà associata sul materiale in cui si desidera inserire l'oggetto visivo 2D.

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

Commenti

Viewport2DVisual3D consente di inserire contenuto interattivo 2D in un oggetto 3D. La controparte è la Viewport3DVisual classe, che è un oggetto visivo 2D con figli 3D.

Viewport2DVisual3Dviene introdotto nella .NET Framework versione 3.5.

Costruttori

Viewport2DVisual3D()

Inizializza una nuova istanza della classe Viewport2DVisual3D.

Campi

CacheModeProperty	Identifica la proprietà di dipendenza CacheMode.
GeometryProperty	Identifica la proprietà di dipendenza Geometry.
IsVisualHostMaterialProperty	Identifica la proprietà associata IsVisualHostMaterial.
MaterialProperty	Identifica la proprietà di dipendenza Material.
VisualProperty	Identifica la proprietà di dipendenza Visual.

Proprietà

CacheMode	Ottiene o imposta una rappresentazione nascosta dell'oggetto Viewport2DVisual3D.
DependencyObjectType	Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject)
Dispatcher	Ottiene l'oggetto Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject)
Geometry	Ottiene o imposta la geometria 3D per l'oggetto Viewport2DVisual3D corrente.
HasAnimatedProperties	Ottiene un valore che indica se Visual3D dispone di proprietà a cui è stata aggiunta un'animazione. (Ereditato da Visual3D)
IsSealed	Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura). (Ereditato da DependencyObject)
Material	Ottiene o imposta il materiale che descrive l'aspetto dell'oggetto tridimensionale.
Transform	Ottiene o imposta la trasformazione applicata all'oggetto 3D. (Ereditato da Visual3D)
Visual	Ottiene o imposta l'elemento 2D visuale da posizionare sull'oggetto 3D.
Visual3DChildrenCount	Ottiene il numero di elementi figlio per l'oggetto Visual3D. (Ereditato da Visual3D)
Visual3DModel	Ottiene o imposta l'oggetto Model3D di cui eseguire il rendering. (Ereditato da Visual3D)

Proprietà associate

IsVisualHostMaterial

Ottiene o imposta un valore che specifica se è necessario che un materiale sia interattivo.

Metodi

AddVisual3DChild(Visual3D)	Definisce la relazione padre-figlio tra due oggetti visivi 3D. (Ereditato da Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Applica l'effetto di un oggetto AnimationClock specificato a una proprietà di dipendenza precisata. (Ereditato da Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Applica l'effetto di un oggetto AnimationClock specificato a una proprietà di dipendenza precisata. L'effetto della nuova classe AnimationClock sulle animazioni correnti è determinato dal valore del parametro `handoffBehavior`. (Ereditato da Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline)	Avvia una sequenza di animazione per l'oggetto DependencyProperty, in base all'oggetto AnimationTimeline specificato. (Ereditato da Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Avvia una sequenza di animazione per l'oggetto DependencyProperty, in base agli oggetti AnimationTimeline e HandoffBehavior specificati. (Ereditato da Visual3D)
CheckAccess()	Determina se il thread chiamante ha accesso a DispatcherObject. (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare è specificata da un identificatore DependencyProperty. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject)
CoerceValue(DependencyProperty)	Assegna forzatamente il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante. (Ereditato da DependencyObject)
Equals(Object)	Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente. (Ereditato da DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Restituisce il predecessore comune dell'oggetto visivo e di un altro oggetto visivo specificato. (Ereditato da Visual3D)
GetAnimationBaseValue(DependencyProperty)	Recupera il valore di base dell'oggetto DependencyProperty specificato. (Ereditato da Visual3D)
GetHashCode()	Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject)
GetIsVisualHostMaterial(Material)	Ottiene il valore della proprietà associata IsVisualHostMaterial per l'oggetto UIElementspecificato.
GetLocalValueEnumerator()	Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject. (Ereditato da DependencyObject)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject. (Ereditato da DependencyObject)
GetVisual3DChild(Int32)	Restituisce l’oggetto Visual3D specificato nell’oggetto Visual3DCollection padre. (Ereditato da Visual3D)
InvalidateProperty(DependencyProperty)	Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
IsAncestorOf(DependencyObject)	Determina se l'oggetto visivo è un predecessore dell'oggetto visivo discendente. (Ereditato da Visual3D)
IsDescendantOf(DependencyObject)	Determina se l'oggetto visivo è un discendente dell'oggetto visivo predecessore. (Ereditato da Visual3D)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject. La proprietà di dipendenza specifica modificata viene indicata nei dati dell'evento. (Ereditato da DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Viene chiamato quando l'oggetto Visual3DCollection dell’oggetto visivo viene modificato. (Ereditato da Visual3D)
OnVisualParentChanged(DependencyObject)	Chiamato quando l'elemento padre dell’oggetto visivo 3D viene modificato. (Ereditato da Visual3D)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject)
RemoveVisual3DChild(Visual3D)	Rimuove la relazione padre-figlio tra due oggetti visivi 3D. (Ereditato da Visual3D)
SetCurrentValue(DependencyProperty, Object)	Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore. (Ereditato da DependencyObject)
SetIsVisualHostMaterial(Material, Boolean)	Imposta il valore della proprietà associata IsVisualHostMaterial su un elemento specificato.
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza. (Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)	Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TransformToAncestor(Visual)	Restituisce una trasformazione che può essere utilizzata per trasformare le coordinate da questo oggetto Visual3D al predecessore Visual specificato dell'oggetto. (Ereditato da Visual3D)
TransformToAncestor(Visual3D)	Restituisce una trasformazione che può essere utilizzata per trasformare le coordinate da questo oggetto Visual3D al predecessore Visual3D specificato dell'oggetto. (Ereditato da Visual3D)
TransformToDescendant(Visual3D)	Restituisce una trasformazione che può essere usata per trasformare le coordinate da questo oggetto Visual3D nell'oggetto discendente Visual3D specificato. (Ereditato da Visual3D)
VerifyAccess()	Impone che il thread chiamante abbia accesso a DispatcherObject. (Ereditato da DispatcherObject)

Si applica a