Freigeben über


Visual Klasse

Definition

Das visuelle Basisobjekt in der visuellen Hierarchie.

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
Vererbung
Object Platform::Object IInspectable CompositionObject Visual
Abgeleitet
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Visuelle Objekte erstellen und rendern serialisierte Zeichnungsinhalte und bilden die Grundlage eines visuellen Systems im beibehaltenen Modus. Die Visual-Klasse unterstützt die einfache Position und Das Ausschneiden und kann 2D- und 3D-Transformationen auf sie anwenden. Zusätzliche Funktionen wie Volltonfarben, Bilder und Inhalte mit Effekten werden durch Unterklassen wie SpriteVisual oder ContainerVisual bereitgestellt, und durch Festlegen der Brush-Eigenschaft des Visuals auf CompositionBrush-Unterklassen wie CompositionColorBrush, CompositionEffectBrush oder CompositionSurfaceBrush.

Visuelle Objekte sind thread agile und nicht an den UI-Thread gebunden.

Abstellbare Eigenschaften

Die folgenden Eigenschaften können animiert werden. Rufen Sie CompositionObject.StartAnimation auf, um die Eigenschaft einer CompositionAnimation zuzuordnen.

Drehung

Visual unterstützt zwei Formen der Drehung:

  • Achsenwinkel

    Die Achsenwinkelrotation verwendet die Eigenschaften RotationAngle, RotationAxis und CenterPoint , um die Drehung in Grad, die zu drehende Achse und den Mittelpunkt des Visuals anzugeben, um das sich drehen soll.

  • orientation

    Drehung nach Ausrichtung verwendet die Orientation-Eigenschaft , um eine Quaternion anzugeben, die eine Ausrichtung und Drehung im 3D-Raum beschreibt.

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1703 15063 ParentForTransform
1703 15063 RelativeOffsetAdjustment
1703 15063 RelativeSizeAdjustment

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.

BackfaceVisibility

Gibt an, ob die Rückseite des Visuals während einer 3D-Transformation sichtbar sein soll.

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.

CenterPoint

Der Punkt, über den die Drehung oder Skalierung erfolgt. Animatable

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).

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.

Compositor

Der Compositor , der zum Erstellen dieses CompositionObject verwendet wird.

(Geerbt von CompositionObject)
Dispatcher

Der Dispatcher für das CompositionObject.

(Geerbt von CompositionObject)
DispatcherQueue

Ruft den DispatcherQueue für das CompostionObject 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.

IsPixelSnappingEnabled

Ruft einen Wert ab, der angibt, ob die Kompositions-Engine das gerenderte Visual an einer Pixelgrenze ausrichtet, oder legt diesen fest.

IsVisible

Gibt an, ob das Visual und seine gesamte Unterstruktur untergeordneter Visuals sichtbar sind.

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.

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.

Orientation

Eine Quaternion, die eine Ausrichtung und Drehung im 3D-Raum beschreibt, die auf das Visual angewendet werden. Animatable.

Parent

Das übergeordnete Element des visuellen Objekts.

ParentForTransform

Visual, das das Koordinatensystem angibt, in dem dieses Visual zusammengesetzt ist.

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.

RelativeSizeAdjustment

Ruft die Größe des Visuals in Bezug auf die Größe des übergeordneten Visuals ab oder legt diese fest.

RotationAngle

Der Drehwinkel im Bogenmaß des Visuellen. Animatable.

RotationAngleInDegrees

Der Drehwinkel des Visuellen in Grad. Animatable.

RotationAxis

Die Achse, um die das Visual gedreht werden soll. Animatable.

Scale

Die Skalierung, die auf das Visual angewendet werden soll.

Size

Die Breite und Höhe des Visuals. Animatable.

TransformMatrix

Die Transformationsmatrix, die auf das Visual angewendet werden soll. Animatable.

Methoden

Close()

Schließt das CompositionObject und gibt Systemressourcen frei.

(Geerbt von CompositionObject)
ConnectAnimation(String, CompositionAnimation)

Verbindet und Animation.

(Geerbt von CompositionObject)
DisconnectAnimation(String)

Trennt eine Animation.

(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)

Gilt für:

Weitere Informationen