WPF 引用第三方库的控件在设计器加上设计时数据和属性

  • A+
所属分类:.NET技术
摘要

本文告诉大家如何在 VisualStudio 2022 的 XAML 设计器中,在设计时给第三方控件加上设计用的属性和数据的方法

本文告诉大家如何在 VisualStudio 2022 的 XAML 设计器中,在设计时给第三方控件加上设计用的属性和数据的方法

此功能要求使用不低于 VisualStudio 2019 的 16.8 版本以上,要求第三方控件设计上不要太过诡异(稍微偏离规范问题不大)即可在 XAML 设计上使用此功能

在 2020 重新组建(谜)的 XAML 设计器团队给 WPF 的设计时带来了更强的功能,可以让 d: 设置任意的设计时属性,例如给 TextBlock 加上设计用到的内容。这些设计用到的内容,在运行时是被完全忽略的,如下面代码

<TextBlock Text="{Binding Name}" d:Text="Name!" /> 

对于第三方的库引用,也是受支持的。本文使用 HandyControl 作为例子,告诉大家如何使用设计时的属性设置

将使用 TagContainer 控件作为例子,在此控件中,可以设置 TagContainer.Items 的内容,期望在设计时有如下效果

WPF 引用第三方库的控件在设计器加上设计时数据和属性

HandyControl 加上设计时之前,需要加上此控件的设计时引用,如下面代码

  xmlns:hcDesignTimeControls="https://handyorg.github.io/handycontrol/design" 

对于绝大部分控件库来说,都是简单在后缀上加上 /design 即可。对于控件库开发者来说,也不需要额外做什么,这是自然的支持

需要将上面定义的 hcDesignTimeControls 也加入到 mc:Ignorable 里面,用来告诉 XAML 构建,这是一个设计时的内容,还请忽略。否则对于一些控件库来说,将会提示找不到对应的属性

        xmlns:hc="https://handyorg.github.io/handycontrol"         xmlns:hcDesignTimeControls="https://handyorg.github.io/handycontrol/design"         mc:Ignorable="d hcDesignTimeControls" 

编写的 TagContainer 控件内容如下

    <hc:TagContainer>       <hcDesignTimeControls:TagContainer.Items>         <hc:Tag>           <hc:Tag.Content>             <TextBlock>123</TextBlock>           </hc:Tag.Content>         </hc:Tag>         <hc:Tag Content="2" />         <hc:Tag Content="3" />       </hcDesignTimeControls:TagContainer.Items>     </hc:TagContainer> 

效果如下

WPF 引用第三方库的控件在设计器加上设计时数据和属性

更多请看

Use Design Time Data with the XAML Designer in Visual Studio - Visual Studio (Windows)

What's the correct syntax for third-party control design-time property assign? · Issue #5766 · dotnet/wpf