CompositeTransform Klasse

Definition

Namespace:

Windows.UI.Xaml.Media

Wendet mehrere Transformationsvorgänge auf ein Objekt an.

public ref class CompositeTransform sealed : Transform

/// [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)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class CompositeTransform final : Transform

[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)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class CompositeTransform : Transform

Public NotInheritable Class CompositeTransform
Inherits Transform

<CompositeTransform .../>

Vererbung

Object Platform::Object IInspectable DependencyObject GeneralTransform Transform CompositeTransform

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

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

Beispiele

In diesem Beispiel wird gezeigt, wie Sie dieselben Transformationen auf ein Objekt anwenden, indem Sie entweder eine CompositeTransform oder eine TransformGroup verwenden.

<StackPanel Margin="50">
    <Canvas Background="Black" Width="200" Height="200">
        <Rectangle Height="100" Width="100" Fill="Red">
            <Rectangle.RenderTransform>

                <!-- This one line of markup is the equivalent of the entire
             TransformGroup block in the other Canvas below. -->
                <CompositeTransform SkewX="30" Rotation="45" ScaleX="0.8" ScaleY="0.8" />
            </Rectangle.RenderTransform>
        </Rectangle>
    </Canvas>

    <Canvas Margin="10" Background="Black" Width="200" Height="200">
        <Rectangle Height="100" Width="100" Fill="Red">
            <Rectangle.RenderTransform>
                <TransformGroup>

                    <!-- Note that you have to apply these transforms in 
                     a specific order to get the same effect as the
                     CompositeTransform. -->
                    <ScaleTransform ScaleX="0.8" ScaleY="0.8" />
                    <SkewTransform AngleX="30" />
                    <RotateTransform Angle="45" />
                </TransformGroup>
            </Rectangle.RenderTransform>
        </Rectangle>
    </Canvas>
</StackPanel>

Hinweise

CompositeTransform wendet mehrere Transformationen in der folgenden Reihenfolge an:

1. Skalieren (ScaleX, ScaleY )
2. Skew (SkewX, SkewY)
3. Rotieren (Drehung)
4. Übersetzen (TranslateX, TranslateY)

Wenn Sie mehrere Transformationen in einer anderen Reihenfolge auf ein Objekt anwenden möchten, können Sie eine TransformGroup erstellen und die Transformationen in der gewünschten Reihenfolge einfügen.

CompositeTransform verwendet denselben Mittelpunkt (CenterX, CenterY) für alle Transformationen. Wenn Sie unterschiedliche Mittelpunkte pro Transformation angeben möchten, verwenden Sie TransformGroup.

Konstruktoren

CompositeTransform()

Initialisiert eine neue instance der CompositeTransform-Klasse.

Eigenschaften

CenterX	Ruft die x-Koordinate des Mittelpunkts für alle Transformationen ab, die von compositeTransform in geräteunabhängigem Pixel (DEVICE-Independent Pixel, DIP) relativ zur oberen linken Ecke des Elements angegeben werden, oder legt diese fest.
CenterXProperty	Gibt die CenterX-Abhängigkeitseigenschaft an.
CenterY	Ruft die y-Koordinate des Mittelpunkts für alle Transformationen ab, die von CompositeTransform in device-independent pixel (DIP) relativ zur oberen linken Ecke des Elements angegeben werden, oder legt diese fest.
CenterYProperty	Gibt die CenterY-Abhängigkeitseigenschaft an.
Dispatcher	Ruft den CoreDispatcher ab, dem dieses Objekt zugeordnet ist. CoreDispatcher stellt eine Funktion dar, die auf das DependencyObject im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
Inverse	Ruft nach Möglichkeit die inverse Transformation dieser GeneralTransform ab. (Geerbt von GeneralTransform)
InverseCore	Implementiert das Verhalten für den Rückgabewert von Inverse in einem abgeleiteten oder benutzerdefinierten GeneralTransform. (Geerbt von GeneralTransform)
Rotation	Ruft in Grad den Winkel einer Drehung im Uhrzeigersinn ab oder legt den Winkel fest.
RotationProperty	Gibt die Abhängigkeitseigenschaft Rotation an.
ScaleX	Ruft den Skalierungsfaktor für die x-Achse ab oder legt ihn fest. Sie können diese Eigenschaft verwenden, um ein Objekt horizontal zu strecken oder zu verkleinern.
ScaleXProperty	Identifiziert die ScaleX-Abhängigkeitseigenschaft .
ScaleY	Ruft den Skalierungsfaktor für die y-Achse ab oder legt ihn fest. Sie können diese Eigenschaft verwenden, um ein Objekt vertikal zu strecken oder zu verkleinern.
ScaleYProperty	Gibt die Abhängigkeitseigenschaft ScaleY an.
SkewX	Ruft den Neigungswinkel der x-Achse ab oder legt diesen fest, der in Grad gegen den Uhrzeigersinn von der y-Achse aus gemessen wird. Eine schiefe Transformation kann nützlich sein, um die Illusion einer dreidimensionalen Tiefe in einem zweidimensionalen Objekt zu erzeugen.
SkewXProperty	Gibt die SkewX-Abhängigkeitseigenschaft an.
SkewY	Ruft den Neigungswinkel der y-Achse ab oder legt diesen fest, der in Grad gegen den Uhrzeigersinn von der x-Achse aus gemessen wird. Eine schiefe Transformation kann nützlich sein, um die Illusion einer dreidimensionalen Tiefe in einem zweidimensionalen Objekt zu erzeugen.
SkewYProperty	Identifiziert die SkewY-Abhängigkeitseigenschaft .
TranslateX	Ruft die Strecke der Verschiebung auf der x-Achse ab oder legt diese fest.
TranslateXProperty	Gibt die TranslateX-Abhängigkeitseigenschaft an.
TranslateY	Ruft die Strecke ab, um die ein Objekt auf der y-Achse verschoben werden soll, oder legt diese fest.
TranslateYProperty	Gibt die Abhängigkeitseigenschaft TranslateY an.

Methoden

ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft festgelegt wurde, was in Fällen gilt, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject)
TransformBounds(Rect)	Transformiert das angegebene umgebende Feld und gibt ein an einer Achse ausgerichtetes umgebendes Feld zurück, dessen Größe genau für das Rechteck ausreicht. (Geerbt von GeneralTransform)
TransformBoundsCore(Rect)	Stellt die Möglichkeit bereit, das TransformBounds-Verhalten in einer abgeleiteten Transformationsklasse zu überschreiben. (Geerbt von GeneralTransform)
TransformPoint(Point)	Verwendet die Logik dieses Transformationsobjekts, um den angegebenen Punkt zu transformieren, und gibt das Ergebnis zurück. (Geerbt von GeneralTransform)
TryTransform(Point, Point)	Versucht, den angegebenen Punkt zu transformieren, und gibt einen Wert zurück, der angibt, ob die Transformation erfolgreich durchgeführt wurde. (Geerbt von GeneralTransform)
TryTransformCore(Point, Point)	Stellt die Möglichkeit bereit, das TryTransform-Verhalten in einer abgeleiteten Transformationsklasse zu überschreiben. (Geerbt von GeneralTransform)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor registriert wurde, indem RegisterPropertyChangedCallback aufgerufen wurde. (Geerbt von DependencyObject)

Weitere Informationen

• Transform
• TransformGroup
• Beispiel für zweidimensionale XAML-Transformationen