Visual 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.
Das visuelle Basisobjekt in der visuellen Hierarchie.
[WebHostHidden]
public ref class Visual : CompositionObject/// [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)]
[WebHostHidden]
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(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
[WebHostHidden]
class Visual : CompositionObject[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 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(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public class Visual : CompositionObjectPublic Class Visual
Inherits CompositionObject- Vererbung
- Abgeleitet
- Attribute
Hinweise
Visuelle Objekte verfassen und rendern serialisierte Zeichnungsinhalte und bilden die Grundlage eines visuellen Systems für den beibehaltenen Modus. Die Visual-Klasse unterstützt grundlegende Position und Clipping und kann 2D- und 3D-Transformationen auf sie angewendet haben. Zusätzliche Funktionen wie Volltonfarben, Bilder und Inhalte mit Effekten werden über Unterklassen wie SpriteVisual oder ContainerVisual bereitgestellt, und durch Festlegen der Brush-Eigenschaft des visuellen Elements auf CompositionBrush-Unterklassen wie CompositionColorBrush, CompositionEffectBrush oder CompositionSurfaceBrush.
Visuelle Objekte sind threadagil und nicht an den UI-Thread gebunden.
Animierbare Eigenschaften
Die folgenden Eigenschaften können animiert werden. Rufen Sie CompositionObject.StartAnimation auf, um die Eigenschaft einer CompositionAnimation zuzuordnen.
- Größe
- Offset
- Undurchsichtigkeit
- Ausrichtung
- CenterPoint
- RotationAngle
- RotationAngleInDegrees
- RotationAxis
- TransformMatrix
Drehung
Visual unterstützt zwei Formen der Drehung:
Achsenwinkel
Achsenwinkeldrehung verwendet die RotationAngle-, RotationAxis- und CenterPoint-Eigenschaften , um die Drehung in Grad anzugeben, welche Achse um sich drehen soll, und den Mittelpunkt des visuellen Elements, um sich zu drehen.
Ausrichtung
Drehung nach Ausrichtung verwendet die Orientation-Eigenschaft , um eine Quaternion anzugeben, die eine Ausrichtung und Drehung im 3D-Raum beschreibt.
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. |
| BackfaceVisibility |
Gibt an, ob die Rückseite des visuellen Elements während einer 3D-Transformation sichtbar sein soll. |
| 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. |
| CenterPoint |
Der Punkt, an dem Drehung oder Skalierung auftritt. Animatable |
| 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. |
| 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. |
| 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. |
| IsPixelSnappingEnabled |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Kompositionsmodul das gerenderte visuelle Element an einer Pixelgrenze ausgerichtet. |
| IsVisible |
Gibt an, ob die visuelle und die gesamte Unterstruktur untergeordneter visueller Elemente sichtbar ist. |
| 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. |
| 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. |
| Orientation |
Eine Quaternion, die eine Ausrichtung und Drehung im 3D-Raum beschreibt, die auf das visuelle Element angewendet wird. Animierbar. |
| Parent |
Das übergeordnete Element des visuellen Elements. |
| ParentForTransform |
Visuelles Angeben des Koordinatensystems, in dem dieses visuelle Element zusammengesetzt ist. |
| 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. |
| RelativeSizeAdjustment |
Ruft die Größe des visuellen Elements in Bezug auf die Größe des übergeordneten visuellen Elements ab oder legt diese fest. |
| RotationAngle |
Der Drehwinkel im Bogenmaß des visuellen Elements. Animierbar. |
| RotationAngleInDegrees |
Der Drehwinkel des visuellen Elements in Grad. Animierbar. |
| RotationAxis |
Die Achse zum Drehen des visuellen Elements. Animierbar. |
| Scale |
Die Skalierung, die auf das visuelle Element angewendet werden soll. |
| Size |
Die Breite und Höhe des visuellen Elements. Animierbar. |
| TransformMatrix |
Die Transformationsmatrix, die auf das visuelle Element angewendet werden soll. Animierbar. |
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) |