在Avalonia中使用相对单位

Avalonia目前不具备相对单位功能，要使用相对单位需要安装RelativeControl.Avalonia包

RelativeControl.Avalonia

开始使用

添加NuGet包:

dotnet add package RelativeControl.Avalonia

设置值为 double 属性的相对值:

<CONTROL r:Relative.Width="20pw"/>

这会设定此Control的宽为20%逻辑父控件宽度。

你还可以对相对长度进行加减:

<CONTROL r:Relative.Width="20pw+10ph"/>

这会设定此Control的宽为20%逻辑父控件宽度+10%逻辑父控件高度。

在code behind中，除了加减，还可以对相对单位进行乘除运算。

• Multiply()和Divide()会改变其自身的倍率，同时影响所有对它的引用。
• * 和 / 运算会生成一个轻量级副本，不会影响原实例。

Relative.SetOneTimeWidth 和 Relative.SetOneTimeHeight 仅在控件附加到视觉树时更新一次。

其它使用RelativeLength/RelativeLengthMerge的属性：

• Relative.Height
• Relative.MinWidth
• Relative.MinHeight
• Relative.MaxWidth
• Relative.MaxHeight
• Relative.SetOneTimeWidth
• Relative.SetOneTimeHeight

设定值为 CornerRadius 属性的相对值:

<CONTROL r:Relative.CornerRadius="10sw 10sw+5sh 10sh-5sw 10sh"/>

这会设定此Control的圆角为

TopLeft = 10% 自身宽度,

TopRight = 10% 自身宽度 + 5% 自身高度,

BottomRight = 10% 自身高度 - 5% 自身宽度,

BottomLeft = 10% 自身高度

设定值为 Thickness 属性的相对值

<CONTROL r:Relative.BorderThickness="1em 2em-5px"/>

这会设定此Control的值为：

Horizontal(Left,Right) = 1倍字宽,

Vertical(Top,Bottom) = 2倍字宽 - 5像素

其它使用RelativeThickness的属性:

• Relative.Margin
• Relative.Padding

为任意属性绑定相对值

<CONTROL PROPERTY="{r:RelativeBinding {Binding SOURCE_PROPERTY},50%}"/>

这会设定此Property的值为SOURCE_PROPERTY值的50%.

一个合法的 SourceProperty的值必须为以下类型:

• double
• 任意可转换为double的类型（如数字字符串）
• 任意继承了IMulDiv<RelativeScale>或IMulDiv<double>的自定义结构或类.

RelativeBindOneTime只在控件附加到视觉树时更新一次。

在自定义属性中使用相对单位:

StyledProperty:

public static readonly StyledProperty<IRelative<T>> XXXProperty =
    AvaloniaProperty.Register<..., IRelative<T>>(nameof(XXX));

DirectProperty:

public static readonly DirectProperty<..., IRelative<T>> XXXProperty =
    AvaloniaProperty.RegisterDirect<..., IRelative<T>>(...);

AttachedProperty:

public static readonly AttachedProperty<IRelative<T>> XXXProperty =
    AvaloniaProperty.RegisterAttached<...,...,IRelative<T>>(...);

所有单位

绝对单位:

px: 设备无关像素（1/96英寸）
cm: 厘米
mm: 毫米
in: 英寸

相对单位:

      tpw: 模板父控件宽度
      tph: 模板父控件高度
lpw or pw: 逻辑父控件宽度
lph or ph: 逻辑父控件高度
      vpw: 视觉父控件宽度
      vph: 视觉父控件高度
       sw: 自身宽度
       sh: 自身高度
       em: 字宽
       vw: 窗口宽度
       vh: 窗口高度
        %: 百分比，仅用于RelativeBinding和RelativeBindOneTime

API最小可用版本

0.0.5

• Width
• Height
• MinWidth
• MinHeight
• MaxWidth
• MaxHeight
• BorderThickness
• CornerRadius

0.1.0

• Margin
• Padding

1.0.0-alpha

• RelativeBinding

支持相对属性绑定 如何绑定自定义属性？

1.0.0-beta

• SetOneTimeWidth
• SetOneTimeHeight
• RelativeBindOneTime

这些属性仅会在自身控件附加到视觉树时更新一次