最后我们来讲解下绑定值的转换。
我们先举个例子,还是以上面举例:我们将MainWindowViewModel的PageDesc属性与TextBlock的Text属性绑定,此时我们给PageDesc赋值:avalonia,但我们想让TextBlock的Text属性做一个转化,在前面加上hello :hello avalonia,可以怎么做呢?avalonia内置了一个方法:StringFormat,代码如下:
xml
<TextBlock Text="{Binding PageDesc, StringFormat='hello {0}'}"></TextBlock>
需要注意的是,如果想输出avalonia hello(即绑定的变量在格式化字符串的最前面),需要在{0}前面加一个{},表示转义字符,或者在{0}的大括号前面加反斜线
xml
<TextBlock Text="{Binding PageDesc, StringFormat='{}{0} hello'}"></TextBlock>
<TextBlock Text="{Binding PageDesc, StringFormat='\{0\} hello'}"></TextBlock>
如果MainWindowViewModel的PageDesc,是一个数据类型,我们想格式化成指定类型的小数,比如4想转化成4.0,可以像下面这么写
c#
public class MainWindowViewModel
{
// 数据类型改为int类型
public int? PageDesc { get; set; }
}
c#
desktop.MainWindow = new MainWindow()
{
DataContext = new MainWindowViewModel()
{
// 传参改为int
PageDesc = 4
}
};
c#
<TextBlock Text="{Binding PageDesc, StringFormat={}{0:0.0}}"></TextBlock>
上面的StringFormat中,第一个{}表示转义字符,亦可以向上例中用反斜线替代。第二个{}中,冒号前面的0,表示站位符,表示这里就代指PageDesc;冒号后面的0.0,表示保留一位小数。
上面介绍了简单的字符串转字符串,数字转字符串的用法,接下来我们介绍转换器。顾名思义,转化器的功能非常强大,可以把任意类型转换成任意类型。
其实上文中字符串转字符串和数字转字符串,都是其本质上也是用了转化器,avalonia提供的内部转化器,StringFormatValueConverter
,我们来看下avalonia中,提供了哪些内置的转化器,以及他们的用法。
首先看下取反运算符,官方的解释如下:可以在数据绑定路径前面放置 ! 运算符以返回布尔值的反值。
为了讲解这个取反运算符,我们先来额外讲一个Button控件的属性:IsEnabled,为True的时候表示可点击可操作,为False的时候表示不可点击不可操作,且按钮会置灰,代码如下,相信大家自行尝试下即可明白用法,这里不做赘述
xml
<Button IsEnabled="False">test</Button>
好,接下来我在MainWindowViewModel中,设置一个Bool类型的属性CanOperate,并将Button的IsEnabled属性与其绑定,完整代码如下:
c#
public partial class MainWindowViewModel
{
public Boolean CanOperate => false;
}
xml
<Button IsEnabled="{Binding CanOperate}">test</Button>
运行后可以发现按钮是不可操作
这时我们在CanOperate前面加个!,表示取反操作,这时我们再运行代码,会发现按钮可以操作了。这个!就表示取反运算符
代码如下:
xml
<Button IsEnabled="{Binding !CanOperate}">test</Button>
这里需要强调的事,如果你绑定的CanOperate属性,不是布尔类型,但是你传的字符串,可以通过Convert.ToBoolean
方法被正常转化,这样也是可以的。
演示代码如下:
c#
public partial class MainWindowViewModel
{
// 替换为字符串类型
public string CanOperate => "false";
}
c#
<Button IsEnabled="{Binding CanOperate}">test</Button>
可以看到,运行起来这个属性也是生效的。说个题外话,你会发现avalonia里面的基础类型,如string、int、double等,很多地方avalonia内部都是预设了自动转化机制的,非常方便,如果你还记得之前我们讲Thickness相关内容,应该有映像,也是有自动转化机制的。
接下来再讲解一个转化器StringConverters
,里面有IsNullOrEmpty
和IsNotNullOrEmpty
两种用法。我们以IsNullOrEmpty举例。
这个转化器是用来判断如果输入字符串为空或为 null,则转化 true。
我们还是在MainWindowViewModel里面设置一个属性Test,然后将Button的IsEnabled属性绑定这个Test属性。代码如下:
c#
public partial class MainWindowViewModel : ViewModelBase
{
public string Test => "1";
}
xml
<Button IsEnabled="{Binding Test, Converter={x:Static StringConverters.IsNullOrEmpty}}">test</Button>
运行后可以看到,按钮不可用。这里面是这么一套逻辑:Test属性传入是1,然后经过StringConverter.IsNullOrEmpty的转化,转化为false(因为Test属性非空),然后将这个false赋值给Button的IsEnabled属性。
接下来罗列一下官方已经提供的其他转化器,上面三个与我们上述的类似,大家下来仿照着自行操作下就可以了。
转化器 | 功能描述 |
---|---|
StringConverters.IsNotNullOrEmpty |
如果输入字符串为空或为 null,则返回 false |
ObjectConverters.IsNull |
如果输入为 null,则返回 true |
ObjectConverters.IsNotNull |
如果输入为 null,则返回 false |
BoolConverters.And |
一个多值转换器,如果所有输入都为 true,则返回 true |
BoolConverters.Or |
一个多值转换器,如果任何输入为 true,则返回 true |
这里我们再拓展讲解下x:Static,这里是Markup Extensions(官网上也没有翻译成中文)的一种语法,表示后面跟的是一个静态成员值。x:Static外面的大括号用于区分普通文本的使用。
比如我想将一个TextBlock控件的Text属性,绑定成一个类的静态成员值,可以这么写:
类代码:
c#
namespace AvaloniaApplication2.Constants;
public class TestConstant
{
public static string DemoText = "1";
}
axaml代码:
xml
<Window xmlns="https://github.com/avaloniaui"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d" d:DesignWidth="300" d:DesignHeight="110"
Width="1024" Height="600"
x:Class="AvaloniaApplication2.MainWindow"
xmlns:vm="using:AvaloniaApplication2.ViewModels"
xmlns:constants="using:AvaloniaApplication2.Constants"
x:DataType="vm:MainWindowViewModel"
Title="AvaloniaApplication2">
<!--注意定义constants命名空间-->
<TextBlock Text="{x:Static constants:TestConstant.DemoText}"></TextBlock>
</Window>