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 den 2D-Boxinhalt vom Typ CompositionBrush. Ein Teil des visuellen Elements, der nicht von Pixeln vom Pinsel abgedeckt wird, wird 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
| Name | Beschreibung |
|---|---|
| AnchorPoint |
Der Punkt auf dem visuellen Element, der am Offset des visuellen Elements positioniert werden soll. Der Wert wird in Bezug auf die Größe des visuellen Elements normalisiert. Animierbar. (Geerbt von Visual) |
| BackfaceVisibility |
Gibt an, ob die Rückseite des visuellen Elements 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 visuellen Element zugeordnet sind, oder mit allen visuellen Elementen in der unterstruktur, die an diesem visuellen Element verwurzelt sind. Das Festlegen von BorderMode bei einem übergeordneten Visuellen Element wirkt sich auf alle untergeordneten visuellen Elemente in der Unterstruktur aus und kann bei jedem untergeordneten visuellen Element selektiv deaktiviert werden. (Geerbt von Visual) |
| Brush |
Ein CompositionBrush , der beschreibt, wie das SpriteVisual-Element gezeichnet wird. |
| CenterPoint |
Der Punkt, an dem Drehung oder Skalierung auftritt. Animatable (Geerbt von Visual) |
| Children |
Die untergeordneten Elemente des ContainersVisual. (Geerbt von ContainerVisual) |
| Clip |
Gibt den Clippingbereich für das visuelle Element an. Wenn ein visuelles Element gerendert wird, wird nur der Teil des visuellen Elements angezeigt, der in den Clippingbereich fällt, während alle Inhalte, die sich außerhalb des Beschneidungsbereichs erstrecken (d. a. nicht angezeigt) abgeschnitten werden. (Geerbt von Visual) |
| Comment |
Eine Zeichenfolge, die dem CompositionObject zugeordnet werden soll. (Geerbt von CompositionObject) |
| CompositeMode |
Gibt an, wie die Bitmap einer visuellen Grafik mit dem Bildschirm kombiniert wird. (Geerbt von Visual) |
| Compositor |
Der Kompositor , der zum Erstellen dieses CompositionObjects verwendet wurde. (Geerbt von CompositionObject) |
| DispatcherQueue |
Ruft den DispatcherQueue für das CompositionObject ab. (Geerbt von CompositionObject) |
| ImplicitAnimations |
Die Auflistung impliziter Animationen, die diesem Objekt zugeordnet sind. (Geerbt von CompositionObject) |
| IsHitTestVisible |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die visuelle Unterstruktur, die an diesem visuellen Element verwurzelt ist, an Treffertests teilnimmt. (Geerbt von Visual) |
| IsPixelSnappingEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Kompositionsmodul das gerenderte visuelle Element an einer Pixelgrenze ausgerichtet. (Geerbt von Visual) |
| IsVisible |
Gibt an, ob die visuelle und die gesamte Unterstruktur untergeordneter visueller Elemente sichtbar ist. (Geerbt von Visual) |
| Offset |
Der Offset des visuellen Elements relativ zum übergeordneten Element oder für ein Stammelement, das den Offset relativ zur oberen linken Ecke der Fenster darstellt, die das visuelle Element hosten. Animierbar. (Geerbt von Visual) |
| Opacity |
Die Deckkraft des visuellen Elements. Animierbar. Die Deckkrafteigenschaft bestimmt die Transparenz (sofern vorhanden) des visuellen Elements und ist ein Wert von 0 bis 1. 0 ist vollständig transparent und 1 ist voll undurchsichtig. Ein Visuelles Element mit einer Deckkrafteigenschaft von 0 ist noch in der Struktur vorhanden. Wie andere Eigenschaften des visuellen Elements können Opacity mithilfe der Windows,UI animiert werden. Kompositionsanimationssystem. (Geerbt von Visual) |
| Orientation |
Eine Quaternion, die eine Ausrichtung und Drehung im 3D-Raum beschreibt, die auf das visuelle Element angewendet wird. Animierbar. (Geerbt von Visual) |
| Parent |
Das übergeordnete Element des visuellen Elements. (Geerbt von Visual) |
| ParentForTransform |
Visuelles Angeben des Koordinatensystems, in dem dieses visuelle Element zusammengesetzt ist. (Geerbt von Visual) |
| Properties |
Die Auflistung der Eigenschaften, die dem CompositionObject zugeordnet sind. (Geerbt von CompositionObject) |
| RelativeOffsetAdjustment |
Gibt den Offset des visuellen Elements in Bezug auf die Größe des übergeordneten visuellen Elements an. (Geerbt von Visual) |
| RelativeSizeAdjustment |
Ruft die Größe des visuellen Elements in Bezug auf die Größe des übergeordneten visuellen Elements ab oder legt diese fest. (Geerbt von Visual) |
| RotationAngle |
Der Drehwinkel im Bogenmaß des visuellen Elements. Animierbar. (Geerbt von Visual) |
| RotationAngleInDegrees |
Der Drehwinkel des visuellen Elements in Grad. Animierbar. (Geerbt von Visual) |
| RotationAxis |
Die Achse zum Drehen des visuellen Elements. Animierbar. (Geerbt von Visual) |
| Scale |
Die Skalierung, die auf das visuelle Element angewendet werden soll. (Geerbt von Visual) |
| Shadow |
Der Schatten für spriteVisual. |
| Size |
Die Breite und Höhe des visuellen Elements. Animierbar. (Geerbt von Visual) |
| TransformMatrix |
Die Transformationsmatrix, die auf das visuelle Element angewendet werden soll. Animierbar. (Geerbt von Visual) |
Methoden
| Name | Beschreibung |
|---|---|
| Close() |
Schließt das CompositionObject und gibt Systemressourcen frei. (Geerbt von CompositionObject) |
| Dispose() |
Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind. (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 auf 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 stoppt 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 auf der angegebenen Eigenschaft ausgeführt wird. (Geerbt von CompositionObject) |