SpriteVisual 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.
Ospita contenuto boxed 2D di tipo CompositionBrush. Qualsiasi parte dell'oggetto visivo non coperta da pixel dal pennello viene eseguito il rendering come pixel trasparenti. CompositionBrush può essere un compositionBackdropBrush, CompositionColorBrush, un CompositionSurfaceBrush o un CompositionEffectBrush.
public ref class SpriteVisual sealed : ContainerVisual/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SpriteVisual final : ContainerVisual[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpriteVisual : ContainerVisualPublic NotInheritable Class SpriteVisual
Inherits ContainerVisual- Ereditarietà
- Attributi
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10586.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v2.0)
|
Esempio
SpriteVisual visual = compositor.CreateSpriteVisual();
visual.Brush = compositor.CreateColorBrush (Colors.White);
SpriteVisual visual = compositor.CreateSpriteVisual();
var surface = graphicsDevice.CreateDrawingSurface(new Size(300, 50),
Windows.Graphics.DirectX.DirectXPixelFormat.B8G8R8A8UIntNormalized,
CompositionAlphaMode.Ignore);
visual.Brush = compsositor.CreateSurfaceBrush (surface);
Aggiunta di un'ombreggiatura
//Create surface brush and load in an image
CompositionSurfaceBrush surfaceBrush = compositor.CreateSurfaceBrush();
surfaceBrush.Surface = await imageLoader.LoadImageFromUriAsync(new Uri("ms-appx:///Assets/cat.jpg"));
//Create sprite visual
SpriteVisual visual = compositor.CreateSpriteVisual();
visual.Brush = surfaceBrush;
visual.Size = new Vector2(270, 200);
//Create drop shadow
DropShadow shadow = compositor.CreateDropShadow();
shadow.BlurRadius = 5;
shadow.Offset = new Vector3(15, 15, -10);
shadow.Color = Colors.DarkGray;
//Associate shadow to visual
visual.Shadow = shadow;
Commenti
Cronologia delle versioni
| Versione di Windows | Versione dell'SDK | Valore aggiunto |
|---|---|---|
| 1607 | 14393 | Ombreggiatura |
Proprietà
| AnchorPoint |
Punto dell'oggetto visivo da posizionare all'offset dell'oggetto visivo. Il valore è normalizzato rispetto alle dimensioni dell'oggetto visivo. Animatable. (Ereditato da Visual) |
| BackfaceVisibility |
Specifica se la faccia posteriore dell'oggetto visivo deve essere visibile durante una trasformazione 3D. (Ereditato da Visual) |
| BorderMode |
Specifica come comporre i bordi di bitmap e clip associati a un oggetto visivo o a tutti gli oggetti visivi nel sottoalbero radicato in questo oggetto visivo. L'impostazione di BorderMode in un oggetto visivo padre influisce su tutti gli oggetti visivi figlio nell'albero secondario e può essere disattivata in modo selettivo in ogni oggetto visivo figlio. (Ereditato da Visual) |
| Brush |
Oggetto CompositionBrush che descrive come viene dipinto SpriteVisual . |
| CenterPoint |
Punto su cui si verifica la rotazione o il ridimensionamento. Animatable (Ereditato da Visual) |
| Children |
Elementi figlio di ContainerVisual. (Ereditato da ContainerVisual) |
| 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). (Ereditato da Visual) |
| Comment |
Stringa da associare a CompositionObject. (Ereditato da CompositionObject) |
| CompositeMode |
Specifica la modalità di fusione della bitmap di un oggetto visivo con lo schermo. (Ereditato da Visual) |
| Compositor |
Compositore usato per creare questo oggetto 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 l'albero secondario visivo è radicato in questo oggetto visivo partecipa ai test di hit test. (Ereditato da Visual) |
| 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. (Ereditato da Visual) |
| IsVisible |
Indica se l'oggetto visivo e l'intero sottoalbero degli oggetti visivi figlio sono visibili. (Ereditato da Visual) |
| Offset |
Offset dell'oggetto visivo relativo al relativo elemento padre o per un oggetto visivo radice relativo all'angolo superiore sinistro delle finestre che ospita l'oggetto visivo. Animatable. (Ereditato da Visual) |
| Opacity |
Opacità dell'oggetto visivo. Animatable. La proprietà opacità determina la trasparenza, se presente, dell'oggetto Visivo ed è un valore compreso tra 0 e 1. 0 è completamente trasparente e 1 è opaco completo. Un oggetto Visual con una proprietà Opacity di 0 è ancora presente nell'albero. Come altre proprietà nell'oggetto visivo, l'Opacity può essere animata usando Windows, interfaccia utente. Sistema di animazione composizione. (Ereditato da Visual) |
| Orientation |
Un quaternione che descrive un orientamento e una rotazione nello spazio 3D che verrà applicato all'oggetto visivo. Animatable. (Ereditato da Visual) |
| Parent |
Padre dell'oggetto visivo. (Ereditato da Visual) |
| ParentForTransform |
Oggetto visivo che specifica il sistema di coordinate in cui è composto questo oggetto visivo. (Ereditato da Visual) |
| Properties |
Raccolta di proprietà associate a CompositionObject. (Ereditato da CompositionObject) |
| RelativeOffsetAdjustment |
Specifica l'offset dell'oggetto visivo rispetto alle dimensioni dell'oggetto visivo padre. (Ereditato da Visual) |
| RelativeSizeAdjustment |
Ottiene o imposta le dimensioni dell'oggetto visivo rispetto alle dimensioni dell'oggetto visivo padre. (Ereditato da Visual) |
| RotationAngle |
Angolo di rotazione nei radianti dell'oggetto visivo. Animatable. (Ereditato da Visual) |
| RotationAngleInDegrees |
Angolo di rotazione dell'oggetto visivo in gradi. Animatable. (Ereditato da Visual) |
| RotationAxis |
Asse per ruotare l'oggetto visivo intorno. Animatable. (Ereditato da Visual) |
| Scale |
Scala da applicare all'oggetto visivo. (Ereditato da Visual) |
| Shadow |
Ombreggiatura per SpriteVisual. |
| Size |
Larghezza e altezza dell'oggetto visivo. Animatable. (Ereditato da Visual) |
| TransformMatrix |
Matrice di trasformazione da applicare all'oggetto visivo. Animatable. (Ereditato da Visual) |
Metodi
| Close() |
Chiude l'oggetto 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 del 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 nella proprietà specificata. (Ereditato da CompositionObject) |