Visual Classe
Definizione
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.
Oggetto visivo di base nella gerarchia visiva.
public ref class Visual : CompositionObject
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Visual : CompositionObject
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
class Visual : CompositionObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Visual : CompositionObject
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
public class Visual : CompositionObject
Public Class Visual
Inherits CompositionObject
- Ereditarietà
- Derivato
- Attributi
Requisiti Windows
Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
|
Commenti
Gli oggetti visivi compongono ed eseguono il rendering del contenuto di disegno serializzato e costituiscono la base di un sistema visivo in modalità mantenuta. La classe Visual supporta la posizione e il ritaglio di base e può avere trasformazioni 2D e 3D applicate. Funzionalità aggiuntive come colori a tinta unita, immagini e contenuto con effetti vengono fornite tramite sottoclassi come SpriteVisual o ContainerVisual e impostando la proprietà Brush dell'oggetto visivo su sottoclassi CompositionBrush, ad esempio CompositionColorBrush, CompositionEffectBrush o CompositionSurfaceBrush.
Gli oggetti visivi sono thread-agile e non associati al thread dell'interfaccia utente.
Proprietà animabili
È possibile animare le proprietà seguenti. Chiamare CompositionObject.StartAnimation per associare la proprietà a compositionAnimation.
- Dimensione
- Offset
- Opacità
- Orientamento
- CenterPoint
- RotationAngle
- RotationAngleInDegrees
- RotationAxis
- TransformMatrix
Rotazione
L'oggetto visivo supporta due forme di rotazione:
angolo dell'asse
La rotazione dell'angolo dell'asse usa le proprietà RotationAngle, RotationAxis e CenterPoint per specificare la rotazione in gradi, quale asse ruotare intorno e il punto centrale dell'oggetto visivo da ruotare intorno.
orientation
La rotazione per orientamento usa la proprietà Orientation per specificare un quaternione che descrive un orientamento e una rotazione nello spazio 3D.
Cronologia delle versioni
Versione di Windows | Versione dell'SDK | Valore aggiunto |
---|---|---|
1703 | 15063 | ParentForTransform |
1703 | 15063 | RelativeOffsetAdjustment |
1703 | 15063 | RelativeSizeAdjustment |
Proprietà
AnchorPoint |
Punto dell'oggetto visivo da posizionare in corrispondenza dell'offset dell'oggetto visivo. Il valore viene normalizzato rispetto alle dimensioni dell'oggetto visivo. Animatable. |
BackfaceVisibility |
Specifica se la faccia posteriore dell'oggetto visivo deve essere visibile durante una trasformazione 3D. |
BorderMode |
Specifica come comporre i bordi di bitmap e clip associati a un oggetto visivo o a tutti gli oggetti visivi nel sottoalbero rooted in questo oggetto visivo. L'impostazione di BorderMode in un oggetto visivo padre influirà su tutti gli oggetti visivi figlio nel sottoalbero e può essere disattivata in modo selettivo in ogni oggetto visivo figlio. |
CenterPoint |
Punto su quale rotazione o ridimensionamento si verifica. Animatable |
Clip |
Specifica l'area di ritaglio per l'oggetto visivo. Quando viene eseguito il rendering di un oggetto visivo, viene visualizzata solo la parte dell'oggetto visivo che rientra nell'area di ritaglio, mentre qualsiasi contenuto che si estende all'esterno dell'area di ritaglio viene ritagliato (ovvero non visualizzato). |
Comment |
Stringa da associare a CompositionObject. (Ereditato da CompositionObject) |
CompositeMode |
Specifica la modalità di fusione della bitmap di un oggetto visivo con lo schermo. |
Compositor |
Compositor utilizzato per creare questo CompositionObject. (Ereditato da CompositionObject) |
Dispatcher |
Dispatcher per CompositionObject. (Ereditato da CompositionObject) |
DispatcherQueue |
Ottiene dispatcherQueue per CompostionObject. (Ereditato da CompositionObject) |
ImplicitAnimations |
Raccolta di animazioni implicite associate a questo oggetto. (Ereditato da CompositionObject) |
IsHitTestVisible |
Ottiene o imposta un valore che indica se la radice dell'albero secondario visivo in questo oggetto visivo partecipa al hit testing. |
IsPixelSnappingEnabled |
Ottiene o imposta un valore che indica se il motore di composizione allinea l'oggetto visivo sottoposto a rendering con un limite di pixel. |
IsVisible |
Indica se l'oggetto visivo e l'intero sottoalbero degli oggetti visivi figlio sono visibili. |
Offset |
Offset dell'oggetto visivo rispetto al relativo oggetto padre o per un oggetto visivo radice l'offset rispetto all'angolo superiore sinistro delle finestre che ospita l'oggetto visivo. Animatable. |
Opacity |
Opacità dell'oggetto visivo. Animatable. La proprietà di opacità determina la trasparenza, se presente, dell'oggetto Visivo ed è un valore compreso tra 0 e 1. 0 è completamente trasparente e 1 è opaco. Un oggetto Visual con una proprietà Opacity pari a 0 è ancora presente nell'albero. Analogamente ad altre proprietà nell'oggetto visivo, l'Opacità può essere animata tramite Windows, interfaccia utente. Sistema di animazione di composizione. |
Orientation |
Quaternione che descrive un orientamento e una rotazione nello spazio 3D che verrà applicato all'oggetto visivo. Animatable. |
Parent |
Padre dell'oggetto visivo. |
ParentForTransform |
Oggetto visivo che specifica il sistema di coordinate in cui è composto questo oggetto visivo. |
Properties |
Raccolta di proprietà associate a CompositionObject. (Ereditato da CompositionObject) |
RelativeOffsetAdjustment |
Specifica l'offset dell'oggetto visivo rispetto alle dimensioni dell'oggetto visivo padre. |
RelativeSizeAdjustment |
Ottiene o imposta le dimensioni dell'oggetto visivo rispetto alle dimensioni dell'oggetto visivo padre. |
RotationAngle |
Angolo di rotazione in radianti dell'oggetto visivo. Animatable. |
RotationAngleInDegrees |
Angolo di rotazione dell'oggetto visivo in gradi. Animatable. |
RotationAxis |
Asse in cui ruotare l'oggetto visivo. Animatable. |
Scale |
Scala da applicare all'oggetto visivo. |
Size |
Larghezza e altezza dell'oggetto visivo. Animatable. |
TransformMatrix |
Matrice di trasformazione da applicare all'oggetto visivo. Animatable. |
Metodi
Close() |
Chiude CompositionObject e rilascia le risorse di sistema. (Ereditato da CompositionObject) |
ConnectAnimation(String, CompositionAnimation) |
Connette e animazione. (Ereditato da CompositionObject) |
DisconnectAnimation(String) |
Disconnette un'animazione. (Ereditato da CompositionObject) |
Dispose() |
Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. (Ereditato da CompositionObject) |
PopulatePropertyInfo(String, AnimationPropertyInfo) |
Definisce una proprietà che può essere animata. (Ereditato da CompositionObject) |
StartAnimation(String, CompositionAnimation, AnimationController) |
Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject) |
StartAnimation(String, CompositionAnimation) |
Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione. (Ereditato da CompositionObject) |
StartAnimationGroup(ICompositionAnimationBase) |
Avvia un gruppo di animazioni. Il metodo StartAnimationGroup in CompositionObject consente di avviare CompositionAnimationGroup. Tutte le animazioni nel gruppo verranno avviate contemporaneamente sull'oggetto . (Ereditato da CompositionObject) |
StopAnimation(String) |
Disconnette un'animazione dalla proprietà specificata e arresta l'animazione. (Ereditato da CompositionObject) |
StopAnimationGroup(ICompositionAnimationBase) |
Arresta un gruppo di animazioni. (Ereditato da CompositionObject) |
TryGetAnimationController(String) |
Restituisce un oggetto AnimationController per l'animazione in esecuzione sulla proprietà specificata. (Ereditato da CompositionObject) |