RotateTransform Klasse

Definition

public ref class RotateTransform sealed : Transform

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

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

Public NotInheritable Class RotateTransform
Inherits Transform

<RotateTransform .../>

Vererbung

Object Platform::Object IInspectable DependencyObject GeneralTransform Transform RotateTransform

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Beispiele

Transformationen können die Anzeige von Text in Ihrer Anwendung ändern, um einen dekorativen Effekt zu erzeugen. In diesem Beispiel wird Text mithilfe einer RotateTransform um 90 Grad gedreht.

In diesem Beispiel wird eine RotateTransform verwendet, um Text zu rotieren. Ein Winkelwert von 90 rotiert das Element um 90 Grad im Uhrzeigersinn.

<!-- Rotate the text 90 degrees using a RotateTransform. -->
<TextBlock Text="Rotated Text" FontSize="32" Foreground="Teal">
  <TextBlock.RenderTransform>
    <RotateTransform Angle="90" />
  </TextBlock.RenderTransform>
</TextBlock>

Hinweise

Eine RotateTransform wird durch einen Winkel definiert, der ein Objekt durch einen Bogen um den Punkt CenterX( CenterY) dreht.

Wenn der angewendete Winkelwert positiv ist, erfolgt die angewendete Drehung im Uhrzeigersinn. Es ist zulässig, einen negativen Winkelwert zu verwenden, wodurch die Drehung gegen den Uhrzeigersinn erfolgt. Bei Werten kleiner als –360 oder größer als 360 werden die Werte umschließen und so behandelt, als ob der mathematische Vorgang mod(360) angewendet wurde.

Um sich zu drehen, behalten Sie CenterX, CenterY als Standard (0,0) bei. Sie können ein nicht standardmäßiges CenterX, CenterY , verwenden, wenn Sie sich nicht an Ort und Stelle drehen möchten und stattdessen um einen Punkt im Referenzrahmen der Transformation rotieren möchten. Sie können beispielsweise eine Umlaufbahn simulieren.

Eine Transformation wird in der Regel verwendet, um die UIElement.RenderTransform-Eigenschaft zu füllen, um zu ändern, wie ein Element gerendert wird. UIElement verfügt außerdem über die UIElement.RenderTransformOrigin-Eigenschaft , die standardmäßig auf (0,0) festgelegt ist. RenderTransformOrigin legt den Koordinatenrahmen für die Anwendung aller Transformationen einschließlich RotateTransform fest. Ein gängiges Szenario für RotateTransform besteht darin, ein Objekt an ortsbezogener Stelle um sein Zentrum zu drehen (entweder als Animation oder als einmalige Transformation). Bei der Standardeinstellung UIElement.RenderTransformOrigin von (0,0) dreht sich ein Objekt nicht um seine Mitte, es dreht sich um die obere linke Ecke des umgebenden Felds. Daher besteht die gängige Methode zum Rotieren eines Objekts um seine Mitte darin, CenterY als (0,0) zu belassen, aber UIElement.RenderTransformOrigin auf einen logischen Punkt festzulegen, an dem sich die Werte befinden (0.5,0.5). Mithilfe der Logikpunktkonvention wird uiElement.RenderTransformOrigin am Mittelpunkt des Objekts platziert, d. h. an einem Ursprung, bei dem (x,y) genau die Hälfte der ActualHeight- und ActualWidth-Werte sind.

UIElement.RenderTransformOrigin verwendet die Logikpunktkonvention; CenterX und CenterY verwenden diese Konvention nicht, sie verwenden tatsächliche Pixelwerte.

Die Renderingposition für ein Objekt kann mit Canvas.Left und Canvas.Top auf einem Canvas-Objekt offsett werden, dies gilt jedoch nicht als Transformation. das Objekt behält seinen eigenen lokalen Ursprung (0,0), wenn es in einem Canvas-Objekt positioniert ist.

Es gibt andere Eigenschaften und Beziehungen, die sich auf die Darstellung der Drehung auswirken können. Wenn mehrere Transformationen mithilfe einer TransformGroup angewendet werden, ist die Reihenfolge wichtig. Die Transformationen werden in der Reihenfolge angewendet, in der sie in der TransformCollection angezeigt werden. Insbesondere wenn eine der Transformationen eine TranslateTransform ist, müssen Sie möglicherweise die Reihenfolge ändern, um den gewünschten Rotationseffekt zu erhalten.

Es gibt drei Möglichkeiten, mehrere Transformationen auf dasselbe Objekt anzuwenden:

• Verwenden sie eine TransformGroup, in der Sie die Reihenfolge angeben können, in der jede Transformation angewendet wird.
• Verwenden eines CompositeTransform-Objekts, bei dem jede der Transformationen durch Eigenschaften eines freigegebenen Transformationsobjekts aktiviert wird und die Transformationen in einer festen, bekannten Reihenfolge angewendet werden.
• Mit matrixTransform legen Sie die verschiedenen Eigenschaften fest, die die 3×3-Matrix so steuern, dass Sie die typischen Klassifizierungen von Transformationen zu einer Transformation kombinieren. Es sei denn, Sie verwenden ein Designtool, um die Werte festzulegen, ist dies wahrscheinlich die fortschrittlichste Technik.

Animieren einer RotateTransform

Sie können eine Animation auf eine RotateTransform anwenden, um ein Element im Laufe der Zeit zu rotieren. In der Regel wenden Sie die Animation nur auf die Angle-Eigenschaft an und animieren CenterX, CenterY nicht. Für eine Animation, die sich kontinuierlich dreht, verwenden Sie in der Regel nur den Wert An für eine From/To/By-Formatanimation . Winkel ist ein Double , sodass dies eine DoubleAnimation beinhaltet. Für eine fortlaufende Animation würden Sie repeatBehavior der DoubleAnimation auf Forever festlegen.

<Page.Resources>
  <Storyboard x:Name="spinrect">
     <DoubleAnimation To="360" RepeatBehavior="Forever" 
         Storyboard.TargetName="spinme"
         Storyboard.TargetProperty="(UIElement.RenderTransform).(RotateTransform.Angle)" />
  </Storyboard>
</Page.Resources>
<StackPanel>
  <Rectangle Name="spinme" Width="50" Height="50" Fill="Red" RenderTransformOrigin=".5,.5"
      PointerPressed="spinme_PointerPressed">
    <Rectangle.RenderTransform>
      <RotateTransform/>
    </Rectangle.RenderTransform>
  </Rectangle>
</StackPanel>

private void spinme_PointerPressed(object sender, PointerRoutedEventArgs e)
{
    spinrect.Begin();
}

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• Transform
• Beispiel für zweidimensionale XAML-Transformationen