SpriteVisual Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Hostet 2D-Boxinhalte vom Typ CompositionBrush. Alle Teile des Visuals, die nicht von Pixeln des Pinsels abgedeckt sind, werden als transparente Pixel gerendert. CompositionBrush kann entweder ein CompositionBackdropBrush, CompositionColorBrush, ein CompositionSurfaceBrush oder ein CompositionEffectBrush sein.
public ref class SpriteVisual sealed : ContainerVisual/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [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.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class SpriteVisual final : ContainerVisual[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SpriteVisual : ContainerVisual[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public sealed class SpriteVisual : ContainerVisualPublic NotInheritable Class SpriteVisual
Inherits ContainerVisual- Vererbung
- Attribute
Beispiele
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);
Hinzufügen eines Schattens
//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;
Eigenschaften
| AnchorPoint |
Der Punkt des Visuals, das am Offset des Visuals positioniert werden soll. Der Wert wird in Bezug auf die Größe des Visuals normalisiert. Animatable. (Geerbt von Visual) |
| BackfaceVisibility |
Gibt an, ob die Rückseite des Visuals während einer 3D-Transformation sichtbar sein soll. (Geerbt von Visual) |
| BorderMode |
Gibt an, wie die Kanten von Bitmaps und Clips erstellt werden, die einem Visual zugeordnet sind, oder mit allen Visuals in der Unterstruktur, die in diesem Visual verwurzelt sind. Das Festlegen von BorderMode auf einem übergeordneten Visual wirkt sich auf alle untergeordneten Visuals in der Unterstruktur aus und kann bei jedem untergeordneten Visual selektiv deaktiviert werden. (Geerbt von Visual) |
| Brush |
Ein CompositionBrush , der beschreibt, wie das SpriteVisual gezeichnet wird. |
| CenterPoint |
Der Punkt, über den die Drehung oder Skalierung erfolgt. Animatable (Geerbt von Visual) |
| Children |
Die untergeordneten Elemente von ContainerVisual. (Geerbt von ContainerVisual) |
| Clip |
Gibt den Abschneidebereich für das Visual an. Wenn ein Visual gerendert wird, wird nur der Teil des Visuals angezeigt, der innerhalb des Beschneidungsbereichs liegt, während alle Inhalte, die sich außerhalb des Abschneidebereichs erstrecken, abgeschnitten werden (d. a. nicht angezeigt). (Geerbt von Visual) |
| Comment |
Eine Zeichenfolge, die dem CompositionObject zugeordnet werden soll. (Geerbt von CompositionObject) |
| CompositeMode |
Gibt an, wie die Bitmap eines Visuals mit dem Bildschirm gemischt wird. (Geerbt von Visual) |
| Compositor |
Der Compositor , der zum Erstellen dieses CompositionObject verwendet wird. (Geerbt von CompositionObject) |
| DispatcherQueue |
Ruft den DispatcherQueue für das CompositionObject ab. (Geerbt von CompositionObject) |
| ImplicitAnimations |
Die Auflistung impliziter Animationen, die diesem Objekt angefügt sind. (Geerbt von CompositionObject) |
| IsHitTestVisible |
Ruft einen Wert ab, der angibt, ob die visuelle Unterstruktur, die in diesem Visual verwurzelt ist, an Treffertests teilnimmt, oder legt diesen fest. (Geerbt von Visual) |
| IsPixelSnappingEnabled |
Ruft einen Wert ab, der angibt, ob die Kompositions-Engine das gerenderte Visual an einer Pixelgrenze ausrichtet, oder legt diesen fest. (Geerbt von Visual) |
| IsVisible |
Gibt an, ob das Visual und seine gesamte Unterstruktur untergeordneter Visuals sichtbar sind. (Geerbt von Visual) |
| Offset |
Der Offset des Visuals relativ zu seinem übergeordneten Element oder für ein Stammvisual der Offset relativ zur oberen linken Ecke der Fenster, in denen das Visual gehostet wird. Animatable. (Geerbt von Visual) |
| Opacity |
Die Deckkraft des Visuals. Animatable. Die Deckkrafteigenschaft bestimmt die Transparenz des Visuals( falls vorhanden) und ist ein Wert von 0 bis 1. 0 ist vollständig transparent und 1 vollständig undurchsichtig. Ein Visual mit der Deckkrafteigenschaft 0 ist weiterhin in der Struktur vorhanden. Wie andere Eigenschaften auf dem Visual kann die Deckkraft mithilfe der Windows-Benutzeroberfläche animiert werden. Kompositionsanimationssystem. (Geerbt von Visual) |
| Orientation |
Eine Quaternion, die eine Ausrichtung und Drehung im 3D-Raum beschreibt, die auf das Visual angewendet werden. Animatable. (Geerbt von Visual) |
| Parent |
Das übergeordnete Element des visuellen Objekts. (Geerbt von Visual) |
| ParentForTransform |
Visual, das das Koordinatensystem angibt, in dem dieses Visual zusammengesetzt ist. (Geerbt von Visual) |
| Properties |
Die Auflistung von Eigenschaften, die dem CompositionObject zugeordnet sind. (Geerbt von CompositionObject) |
| RelativeOffsetAdjustment |
Gibt den Offset des Visuals in Bezug auf die Größe des übergeordneten Visuals an. (Geerbt von Visual) |
| RelativeSizeAdjustment |
Ruft die Größe des Visuals in Bezug auf die Größe des übergeordneten Visuals ab oder legt diese fest. (Geerbt von Visual) |
| RotationAngle |
Der Drehwinkel im Bogenmaß des Visuellen. Animatable. (Geerbt von Visual) |
| RotationAngleInDegrees |
Der Drehwinkel des Visuellen in Grad. Animatable. (Geerbt von Visual) |
| RotationAxis |
Die Achse, um die das Visual gedreht werden soll. Animatable. (Geerbt von Visual) |
| Scale |
Die Skalierung, die auf das Visual angewendet werden soll. (Geerbt von Visual) |
| Shadow |
Der Schatten für spriteVisual. |
| Size |
Die Breite und Höhe des Visuals. Animatable. (Geerbt von Visual) |
| TransformMatrix |
Die Transformationsmatrix, die auf das Visual angewendet werden soll. Animatable. (Geerbt von Visual) |
Methoden
| Close() |
Schließt das CompositionObject und gibt Systemressourcen frei. (Geerbt von CompositionObject) |
| Dispose() |
Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Geerbt von CompositionObject) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Definiert eine Eigenschaft, die animiert werden kann. (Geerbt von CompositionObject) |
| StartAnimation(String, CompositionAnimation, AnimationController) |
Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation. (Geerbt von CompositionObject) |
| StartAnimation(String, CompositionAnimation) |
Verbindet eine Animation mit der angegebenen Eigenschaft des Objekts und startet die Animation. (Geerbt von CompositionObject) |
| StartAnimationGroup(ICompositionAnimationBase) |
Startet eine Animationsgruppe. Mit der StartAnimationGroup-Methode für CompositionObject können Sie CompositionAnimationGroup starten. Alle Animationen in der Gruppe werden gleichzeitig für das Objekt gestartet. (Geerbt von CompositionObject) |
| StopAnimation(String) |
Trennt eine Animation von der angegebenen Eigenschaft und beendet die Animation. (Geerbt von CompositionObject) |
| StopAnimationGroup(ICompositionAnimationBase) |
Beendet eine Animationsgruppe. (Geerbt von CompositionObject) |
| TryGetAnimationController(String) |
Gibt einen AnimationController für die Animation zurück, die für die angegebene Eigenschaft ausgeführt wird. (Geerbt von CompositionObject) |