语言

RotateTransform 类

定义

在二维 x-y 坐标系中的指定点周围旋转对象。

public ref class RotateTransform sealed : Transform
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class RotateTransform : Transform
Public NotInheritable Class RotateTransform
Inherits Transform
<RotateTransform .../>
继承
Object Platform::Object IInspectable DependencyObject GeneralTransform Transform RotateTransform
属性

示例

转换可以更改应用程序中文本的显示,以创建装饰效果。 此示例显示使用 RotateTransform 旋转 90 度的文本。

此示例使用 RotateTransform 旋转文本。 角度值 90 顺时针旋转元素 90 度。

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

注解

RotateTransform 由一个 Angle 定义,该角度通过点 CenterX、CenterY 周围的弧线旋转对象。

如果应用的 Angle 值为正值,则应用的旋转方向为顺时针方向。 使用 为负的 Angle 值是合法的,这会导致旋转逆时针。 对于小于 –360 或大于 360 的值,这些值环绕并被视为应用数学运算 mod(360) 。

若要就地旋转,请将 CenterX、 CenterY 保留为默认值(0,0)。 如果不想就地旋转,而希望围绕转换的引用帧中的某个点旋转,则可以使用非默认 CenterX CenterXCenterY 。 例如,可以模拟轨道。

转换通常用于填充 UIElement.RenderTransform 属性,以更改元素的呈现方式。 UIElement 还具有 UIElement.RenderTransformOrigin 属性,该属性默认为 (0,0)。 RenderTransformOrigin 为包括 RotateTransform 在内的所有转换如何应用建立参考坐标框架。 RotateTransform 的常见方案是围绕其中心旋转对象(作为动画或一次性转换)。 使用默认 UIElement.RenderTransformOrigin (0,0) 对象不会在其中心周围旋转,它会在其边界框的左上角旋转。 因此,导致对象围绕中心旋转的常见方法是将 CenterX、 CenterY 设置为 (0,0),但将 UIElement.RenderTransformOrigin 设置为逻辑 点 (0.5,0.5)。 使用逻辑点约定,将 UIElement.RenderTransformOrigin 置于对象中心点,换句话说,在原点(x,y)正好是ActualHeight 和 ActualWidth 值的一半。

UIElement.RenderTransformOrigin 使用逻辑点约定; CenterX 和 CenterY 不使用该约定,它们使用实际像素值。

可以使用 Canvas.Left 和 Canvas.Top 在画布上偏移对象呈现位置,但这不算作转换;当对象定位在 Canvas 中时,该对象将保留其自己的本地 (0,0) 原点。

还有其他属性和关系可能会影响旋转的显示方式。 如果使用 TransformGroup 应用了多个转换,则顺序很重要。 转换按 转换在 TransformCollection 中显示的顺序应用。 尤其是当其中一个转换是 TranslateTransform 时,可能需要更改顺序以获取所需的旋转效果。

可通过三种方法将多个转换应用于同一对象:

  • 使用 TransformGroup,可在其中指定每个转换应用的顺序。
  • 使用 CompositeTransform,其中每个转换都由共享 转换 对象的属性启用,并且转换按固定的已知顺序应用。
  • 使用 MatrixTransform 设置控制 3×3 矩阵的各种属性,以便将转换的典型分类合并为一个 转换。 除非使用设计工具来帮助设置值,否则这可能是最先进的技术。

对 RotateTransform 进行动画处理

可以将动画应用于 RotateTransform,使元素随时间推移而旋转。 通常,仅将动画应用于 Angle 属性,并且不对 CenterX、 CenterY 进行动画处理。 对于连续旋转动画,通常只需使用 From/To/By 样式动画的 To 值。 角度 为 Double ,因此涉及到 DoubleAnimation。 对于连续动画,请将 DoubleAnimation 的 RepeatBehavior 设置为“永远”。

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

构造函数

名称 说明
RotateTransform()

初始化 RotateTransform 类的新实例。

属性

名称 说明
Angle

获取或设置顺时针旋转的角度(以度为单位)。

AngleProperty

标识 Angle 依赖属性。

CenterX

获取或设置此转换的旋转中心点的 x 坐标。

CenterXProperty

标识 CenterX 依赖项属性。

CenterY

获取或设置此转换的旋转中心点的 y 坐标。

CenterYProperty

标识 CenterY 依赖项属性。

Dispatcher

始终在 Windows 应用 SDK 应用中返回 null 。 请改用 DispatcherQueue 。

(继承自 DependencyObject)
DispatcherQueue

获取 DispatcherQueue 与此对象关联的对象。 表示 DispatcherQueue 即使代码是由非 UI 线程启动,也可以访问 DependencyObject UI 线程上的设施。

(继承自 DependencyObject)
Inverse

获取此 GeneralTransform 的反转换(如果可能)。

(继承自 GeneralTransform)
InverseCore

在派生或自定义 GeneralTransform 中实现 Inverse 的返回值的行为。

(继承自 GeneralTransform)

方法

名称 说明
ClearValue(DependencyProperty)

清除依赖属性的本地值。

(继承自 DependencyObject)
GetAnimationBaseValue(DependencyProperty)

返回为依赖属性建立的任何基值,在动画未处于活动状态的情况下,该属性将适用。

(继承自 DependencyObject)
GetValue(DependencyProperty)

从 DependencyObject 返回依赖属性的当前有效值。

(继承自 DependencyObject)
ReadLocalValue(DependencyProperty)

如果设置了本地值,则返回依赖属性的本地值。

(继承自 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

注册一个通知函数,用于侦听此 DependencyObject 实例上对特定 DependencyProperty 所做的更改。

(继承自 DependencyObject)
SetValue(DependencyProperty, Object)

设置 DependencyObject 上的依赖属性的本地值。

(继承自 DependencyObject)
TransformBounds(Rect)

转换指定的边界框,并返回一个轴对齐的边界框,该框的大小正好足以包含它。

(继承自 GeneralTransform)
TransformBoundsCore(Rect)

提供替代派生转换类中的 TransformBounds 行为的方法。

(继承自 GeneralTransform)
TransformPoint(Point)

使用此转换对象的逻辑转换指定点,并返回结果。

(继承自 GeneralTransform)
TryTransform(Point, Point)

尝试转换指定的点并返回一个值,该值指示转换是否成功。

(继承自 GeneralTransform)
TryTransformCore(Point, Point)

提供替代派生转换类中的 TryTransform 行为的方法。

(继承自 GeneralTransform)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。

(继承自 DependencyObject)

适用于

另请参阅