Classe Visual3D (System.Windows.Media.Media3D)

Cambia visualizzazione:
ScriptFree
Riferimento a .NET Framework
Classe Visual3D
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Fornisce servizi e proprietà che sono comuni agli oggetti visivi 3D, inclusi l'hit testing, la trasformazione delle coordinate e i calcoli del riquadro delimitatore.

Gerarchia di ereditarietà

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Media.Media3D.Visual3D
        System.Windows.Media.Media3D.ModelVisual3D
        System.Windows.Media.Media3D.Viewport2DVisual3D
        System.Windows.UIElement3D

Spazio dei nomi:  System.Windows.Media.Media3D
Assembly:  PresentationCore (in PresentationCore.dll)
Sintassi

Visual Basic
Public MustInherit Class Visual3D _
	Inherits DependencyObject _
	Implements IAnimatable
C#
public abstract class Visual3D : DependencyObject, 
	IAnimatable
Visual C++
public ref class Visual3D abstract : public DependencyObject, 
	IAnimatable
F#
[<AbstractClass>]
type Visual3D =  
    class
        inherit DependencyObject
        interface IAnimatable
    end

Il tipo Visual3D espone i seguenti membri.

Proprietà

  Nome Descrizione
Proprietà pubblica DependencyObjectType Ottiene la classe DependencyObjectType che include il tipo CLR di questa istanza.  (Ereditato da DependencyObject)
Proprietà pubblica Dispatcher Ottiene l'oggetto Dispatcher associato a DispatcherObject. (Ereditato da DispatcherObject)
Proprietà pubblica HasAnimatedProperties Ottiene un valore che indica se Visual3D dispone di proprietà a cui è stata aggiunta un'animazione.
Proprietà pubblica IsSealed Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura). (Ereditato da DependencyObject)
Proprietà pubblica Transform Ottiene o imposta la trasformazione applicata all'oggetto 3D.
Proprietà protetta. Visual3DChildrenCount Ottiene il numero di elementi figlio per l'oggetto Visual3D.
Proprietà protetta. Visual3DModel Ottiene o imposta l'oggetto Model3D di cui eseguire il rendering.
In alto
Metodi

  Nome Descrizione
Metodo protetto AddVisual3DChild Definisce la relazione padre-figlio tra due oggetti visivi 3D.
Metodo pubblico ApplyAnimationClock(DependencyProperty, AnimationClock) Applica l'effetto di un oggetto AnimationClock specificato a una proprietà di dipendenza precisata.
Metodo pubblico ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) Applica l'effetto di una classe AnimationClock specificata a una proprietà di dipendenza precisata. L'effetto della nuova classe AnimationClock sulle animazioni correnti è determinato dal valore del parametro handoffBehavior.
Metodo pubblico BeginAnimation(DependencyProperty, AnimationTimeline) Avvia una sequenza di animazione per l'oggetto DependencyProperty, in base all'oggetto AnimationTimeline specificato.
Metodo pubblico BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) Avvia una sequenza di animazione per l'oggetto DependencyProperty, in base agli oggetti AnimationTimeline e HandoffBehavior specificati.
Metodo pubblico CheckAccess Determina se il thread chiamante ha accesso a DispatcherObject. (Ereditato da DispatcherObject)
Metodo pubblico ClearValue(DependencyProperty) Cancella il valore locale di una proprietà. La proprietà da cancellare è indicata da un identificatore DependencyProperty. (Ereditato da DependencyObject)
Metodo pubblico ClearValue(DependencyPropertyKey) Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare è indicata da un identificatore DependencyPropertyKey. (Ereditato da DependencyObject)
Metodo pubblico CoerceValue Assegna 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)
Metodo pubblico Equals Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente. (Ereditato da DependencyObject)
Metodo protetto Finalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblico FindCommonVisualAncestor Restituisce il predecessore comune dell'oggetto visivo e di un altro oggetto visivo specificato.
Metodo pubblico GetAnimationBaseValue Recupera il valore di base dell'oggetto DependencyProperty specificato.
Metodo pubblico GetHashCode Ottiene un codice hash per questo oggetto DependencyObject. (Ereditato da DependencyObject)
Metodo pubblico GetLocalValueEnumerator Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject. (Ereditato da DependencyObject)
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblico GetValue Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject. (Ereditato da DependencyObject)
Metodo protetto GetVisual3DChild Restituisce l’oggetto Visual3D specificato nell’oggetto Visual3DCollection padre.
Metodo pubblico InvalidateProperty Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata. (Ereditato da DependencyObject)
Metodo pubblico IsAncestorOf Determina se l'oggetto visivo è un predecessore dell'oggetto visivo discendente.
Metodo pubblico IsDescendantOf Determina se l'oggetto visivo è un discendente dell'oggetto visivo predecessore.
Metodo protetto MemberwiseClone Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo protetto OnPropertyChanged Richiamato ogni volta che il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject è stato aggiornato. La specifica proprietà di dipendenza modificata viene indicata nei dati dell'evento. (Ereditato da DependencyObject)
Metodo protetto OnVisualChildrenChanged Viene chiamato quando l'oggetto Visual3DCollection dell’oggetto visivo viene modificato.
Metodo protetto OnVisualParentChanged Chiamato quando l'elemento padre dell’oggetto visivo 3D viene modificato.
Metodo pubblico ReadLocalValue Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject)
Metodo protetto RemoveVisual3DChild Rimuove la relazione padre-figlio tra due oggetti visivi 3D.
Metodo pubblico SetCurrentValue Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore. (Ereditato da DependencyObject)
Metodo pubblico SetValue(DependencyProperty, Object) Imposta il valore locale di una proprietà di dipendenza, specificata dal relativo identificatore. (Ereditato da DependencyObject)
Metodo pubblico SetValue(DependencyPropertyKey, Object) Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificata dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject)
Metodo protetto ShouldSerializeProperty Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza fornita. (Ereditato da DependencyObject)
Metodo pubblico ToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Metodo pubblico TransformToAncestor(Visual) Restituisce una trasformazione che può essere utilizzata per trasformare le coordinate da questo oggetto Visual3D al predecessore Visual specificato dell'oggetto.
Metodo pubblico TransformToAncestor(Visual3D) Restituisce una trasformazione che può essere utilizzata per trasformare le coordinate da questo oggetto Visual3D al predecessore Visual3D specificato dell'oggetto.
Metodo pubblico TransformToDescendant Restituisce una trasformazione che può essere utilizzata per trasformare le coordinate da questo oggetto Visual3D all'oggetto discendente Visual3D specificato.
Metodo pubblico VerifyAccess Impone che il thread chiamante abbia accesso a DispatcherObject. (Ereditato da DispatcherObject)
In alto
Campi

  Nome Descrizione
Campo pubblico Membro statico TransformProperty Identifica la proprietà di dipendenza Transform.
In alto
Note

A differenza della classe Model3D, gli oggetti Visual3D non possono essere condivisi o riutilizzati.

Accedere ai servizi Visual3D utilizzando metodi statici sulla classe VisualTreeHelper.

Gli oggetti Visual3D vengono ottimizzati per essere nodi della scena. Ad esempio, essi memorizzano i limiti. Ogni qualvolta è possibile, utilizzare gli oggetti Visual3D per istanze univoche di oggetti all'interno della scena. Questo utilizzo contrasta con quello di oggetti Model3D, che sono oggetti leggeri ottimizzati per essere condivisi e riutilizzati. Ad esempio, utilizzare un oggetto Model3D per compilare un modello di una macchina; e utilizzare dieci oggetti ModelVisual3D per posizionare dieci macchine nella scena.

Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1
Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Vedere anche

Riferimenti