Avalonia 中的
RenderTransform用于对控件进行**视觉层面的二维变换**,比如旋转、缩放、平移、倾斜。它不改变布局尺寸或命中测试逻辑(除非显式启用),只影响最终渲染效果。用法和 WPF 类似但有关键差异,尤其要注意对象类型和动画调用方式。
旋转:用 RotateTransform 控制角度
最常用的是
RotateTransform,通过
Angle属性设置旋转度数(单位为度,正数顺时针)。 中心点很重要:默认绕左上角(0,0)旋转,通常要设
CenterX和
CenterY为控件中心,否则会“偏移飞走”。例如一个宽高均为 100 的按钮:
CenterX="50" CenterY="50"XAML 示例:
<Button Width="100" Height="100" Content="转">
<Button.RenderTransform>
<RotateTransform Angle="45" CenterX="50" CenterY="50"/>
</Button.RenderTransform>
</Button>
C# 动态设置:
button.RenderTransform = new RotateTransform { Angle = 30, CenterX = 50, CenterY = 50 };
缩放:用 ScaleTransform 调整大小
ScaleTransform通过
ScaleX和
ScaleY控制横向/纵向缩放比例(1.0 = 原尺寸,0.5 = 缩小一半,2.0 = 放大两倍)。 同样注意中心点:不设
CenterX/
CenterY会导致缩放后控件“向左上偏移”。推荐设为控件宽高的一半(如
CenterX="Width/2",需在代码中计算) 动画缩放必须传控件本身:这是 Avalonia 特有的易错点!动画
RunAsync()的参数是目标控件(如
button),不能传
ScaleTransform实例,否则报
InvalidCastException正确动画写法示例:
var anim = new Animation();
anim.Duration = TimeSpan.FromSeconds(0.3);
anim.Children.Add(new KeyFrame
{
Cue = new Cue(0),
Setters = { new Setter(ScaleTransform.ScaleXProperty, 1.0) }
});
anim.Children.Add(new KeyFrame
{
Cue = new Cue(1),
Setters = { new Setter(ScaleTransform.ScaleXProperty, 1.3) }
});
anim.RunAsync(button); // ← 这里传 button,不是 button.RenderTransform!
组合变换:用 TransformGroup 同时旋转+缩放
单个
RenderTransform只能设一个变换,如需叠加多个效果(比如先缩放再旋转),要用
TransformGroup。 XAML 组合写法:
<Button.RenderTransform>
<TransformGroup>
<ScaleTransform ScaleX="1.2" ScaleY="1.2" CenterX="50" CenterY="50"/>
<RotateTransform Angle="15" CenterX="50" CenterY="50"/>
</TransformGroup>
</Button.RenderTransform>
C# 构建组合变换:
button.RenderTransform = new TransformGroup
{
Children =
{
new ScaleTransform { ScaleX = 1.2, ScaleY = 1.2, CenterX = 50, CenterY = 50 },
new RotateTransform { Angle = 15, CenterX = 50, CenterY = 50 }
}
};
顺序影响结果:TransformGroup中子变换按添加顺序执行(先 Scale 再 Rotate),和矩阵乘法顺序一致,不可随意调换。
注意事项与避坑点
这些细节直接影响效果是否正常:
RenderTransform 不影响布局:缩放后的控件仍占据原始尺寸的空间,其他控件不会“让位”。如需真实重排,应改用LayoutTransform(Avalonia 当前未原生支持,需自定义或改用容器缩放) 触摸交互需留意:若控件设置了
IsHitTestVisible="False"(如用于手势缩放),则点击事件失效;保持
True才能响应点击/悬停等状态 Viewbox 内慎用:当控件嵌套在
Viewbox中时,
RenderTransform与 Viewbox 的缩放可能冲突,导致边框模糊、像素不对齐(尤其非整数缩放比下) SVG 渲染兼容性好:配合
SvgImage使用
RenderTransform(如旋转 SVG 图标)非常稳定,适合做动态图标反馈
