返回目录

索引： Panuon.WPF.UI-1.1.1 Panuon.WPF.UI-1.0.3 Panuon.WPF.UI-1.0.0 2.2.20 2.2.19 2.2.18 2.2.17-alpha

2022/10/18

🌟 Carousel 轮播 的基类改为了 ItemsControl 。现在，它支持绑定到 Items 属性了。

新增了 MultiComboBox 多选下拉框 控件。你可以在 wiki文档 中找到示例。 Panuon.WPF 中新增了 CornerRadiusAnimation 圆角动画 。该类型可以用于为 CornerRadius 类型的属性执行动画。

经过一系列的调整，Panuon.WPF.UI 已经准备好接纳主题系统了。带有 蓝色-日间主题 和 蓝色-夜间主题 两种主题的主题库 Panuon.WPF.UI.Themes 将在此版本之后发布。要准备使用主题库，请先更新到此版本。 下一个版本将提供绝大多数控件的 HoverCornerRadius 、 HoverBorderThickness 属性。这允许鼠标悬浮时使用圆角和边框粗细动画。

2022/9/19

修复了 MessageBoxX 中按下取消按钮时返回值为 MessageBoxResult.No 的问题。 修复了 TabControlHelper 中 HeaderPanelMargin 属性类型错误的问题。 修复了 GroupBoxHelper 中 HeaderFontWeight 属性绑定错误的问题。

新增了 WindowXModalDialog 中的 DialogResult 附加属性。此属性可以用于获取模态对话框的返回值。

2022/9/8

修复了 DataGridHelper 中部分以 Row 和 Cell 开头的属性出现显示异常的问题。 修复了 SliderHelper 中 TextStringFormat 属性默认值错误的问题。

🌟新增了 TextBoxHelper 中的 InputLimit 属性。此属性可以用于限制用户的输入内容（包括粘贴），但不会对已有的内容执行验证或剔除。有关此属性的更多详细信息，请参考wiki文档。 新增了 ExpanderHelper 中的 HeaderFontWeight 属性。 新增了 FormGroup 中的 HeaderFontSize 和 HeaderFontWeight 属性。 新增了 GroupBoxHelper 中的 HeaderFontWeight 属性。 新增了 ListBoxHelper 中的 SelectedItems 属性。 新增了 ListViewHelper 中的 ColumnHeaderHoverBorderBrush 、 ColumnHeaderHoverBorderThickness 、 ColumnHeaderClickBorderBrush 、 ColumnHeaderClickBorderThickness 属性。 新增了 DataGridHelper 中的 ColumnHeaderHoverBorderBrush 、 ColumnHeaderHoverBorderThickness 、 ColumnHeaderClickBorderBrush 、 ColumnHeaderClickBorderThickness 、 ColumnHeaderFontSize 、 ColumnHeaderFontWeight 、 ClickToEdit 、 ClickToExtendedSelect 属性。RowShadowColor 、 RowSelectedShadowColor 属性暂不可用，请不要在代码中使用它们。

2022/8/28

⚠️ 删除了 DataGridHelper 中以 Unit 开头的属性，新增了一些以 Cell 和 Row 开头的属性。现在，DataGridHelper 不再根据 SelectionUnit 来区分高亮效果了。无论你的 SelectionUnit 是何种，你都可以通过 Cell 和 Row 开头的属性分别定义两者的效果。如果你的 SelectionUnit 为 Cell ，请记得额外将 RowHoverBackground 、 RowSelectedBackground 设置为 {x:Null} 。 ⚠️ 为了与其他控件保持一致， ProgressBar 、 RingProgressBar 、 的 PercentStringFormat 属性； SliderHelper 的 TextStringFormat 属性不再使用 {0: P2} 这种格式化方式，你可以直接使用 P2 来替代它 （其他格式化同理）。

修复了 ProgressBar 的 IsIndeterminate 属性不会生效的问题。 修复了 CarouselPanel 的动画移动方向错反的问题。 修复了 PopupX 和 DropDown 等控件在 StaysOpen 的值为 True 时，窗体最小化弹出框不会关闭的问题。 修复了 TextBox 、 PasswordBox 、 ComboBoxHelper 等控件中，当 HoverShadowColor 和 FocusedShadowColor 都不为 Null 时，阴影会在控件已获得焦点、但鼠标未悬浮时消失的问题。

新增了 ComboBoxHelper 中的 ItemsFontSize 属性。该属性的值默认与 FontSize 属性的值绑定。 新增了 ColorSelector 中的 EditorPanelMargin 属性。该属性可以用于调整下方编辑框和上方色彩选择区域的间距（之前，此间距的值为固定值 15 ）。 新增了 CelendarX 中的 Mode 属性，现在它支持选择 年月 或 仅年份 了。 新增了 TimeSelector 中的 Mode 属性，现在它支持选择 时分 或 仅小时 了。 新增了 DateTimePicker 中的 Mode 属性，现在它支持选择 年月 、 仅年份 、 时分 、 仅小时 了。 新增了 IconHelper 中的 HiddenOnNull 属性。当此属性的值为 True ，且 Icon 属性的值为 Null 时， Icon 的容器仍然会保留占位。

2022/8/12

修复了 RingProgressBar 的 PercentStringFormat 属性在初始化时不会生效的问题。 修复了 SearchBox 、 DropDown 中的子项无法使用 DataContext 的问题。 修复了 SearchBox 中 ItemClick 事件 ownerType 参数错误的问题。 修复了 DataGrid 中重新设置 ItemsSource 后 ColumnIndex 混乱的问题。要在使用 AutoGenerateColumns 属性的同时使用 Columns 集合，且需要自定义这些列的顺序，请使用 pu:DataGridHelper.ColumnIndex 属性替代 DisplayIndex 属性。 修复了 ScrollViewer 和其他带有滚动条的控件（如 ComboBox ）同时使用时，鼠标滚轮被 ScrollViewer 截获的问题。 修复了 TabControlHelper 中 HeaderPanelCornerRadius 属性类型错误且不生效的问题。

新增了 TabControlHelper 中的 CornerRadius 、 ShadowColor 属性。

2022/7/23 修复了部分事件出现 "XXX"必须是使用以关键字“Event”结束的名称注册的 RoutedEvent。 编译错误的问题。 修复了 MessageBoxX 在使用 countdown 参数时，在部分情况下可能会报错的问题。

2022/7/21

修复了 ScrollViewer 中部分情况下滚动会报错的问题。 修复了 Drawer 控件关闭打开可能存在异常的问题。 修复了 Expander 控件 ExpandDirection 为 Left 或 Right 时箭头位置显示异常的问题。 修复了 Carousel 和 CarouselPanel 控件动态删除时可能会报错的问题。

2022/7/8 提醒：为了保护版权信息， Panuon.WPF.UI 和 Panuon.WPF 库不再使用 MIT 开源许可协议，新的开源许可协议为 Apache-2.0 。 默认日间主题和默认夜间主题将在下个版本中提供。

从你的项目中依次删除 Panuon.UI.Silver 和 Panuon.UI.Core Nuget包。搜索并安装Panuon.WPF.UI 包（这将自动为你安装 Panuon.WPF Nuget包），无需手动安装其他名称的包。 在代码项目中全局重命名以下名称： Panuon.UI.Core -> Panuon.WPF Panuon.UI.Silver -> Panuon.WPF.UI

修复了 PasswordHelper 中清除按钮前景色为白色的问题。

⚠️ 为了不与WPF中的类型名称混淆， Panuon.WPF (原 Panuon.UI.Core) 中所有的路由事件类型名称由 XxxEventArgs 和 XxxEventHandler 重命名为 XxxRoutedEventArgs 和 XxxRoutedEventHandler 。 ⚠️ 非常抱歉，由于 2.2.20 中的 Drawer 控件出现了更严重的问题，因此回撤了部分代码。使用方式与 2.2.19 之前的版本相同，你必须为 Drawer 控件指定 MaxWidth 或 MaxHeight 方法。

2022/7/7 本次发布更新了较多内容，请谨慎完成更新。 该版本是Panuon.UI.Silver的最后一个版本。为了方便推出其他的开源库，Panuon.UI.Silver将被重命名为Panuon.WPF.UI。Panuon.WPF.UI提供了一套默认的主题，包含日间和夜间两种配色。 要更新到Panuon.WPF.UI，你必须先更新到当前版本2.2.20，然后进行名称替换。待新库发布后，本页面将推出更新指南。

新增了 Badge 、 Carousel 、 CarouselPanel 、 ZoomViewer 控件。 新增了 Carousel 、 MessageBoxX 、 NoticeBox 、 PendingBox 控件的wiki文档。 在 TextBoxHelper 和 PasswordBoxHelper 中新增了 SelectAllOnFocus 属性。 在 SliderHelper 中新增了 IsTextVisible 、 TextStringFormat 、 TextSpacing 属性。 在 MessageBoxXSetting 中新增了 InteropOwnersMask 属性。如果不需要遮罩层，可以通过该属性关闭。 在 NoticeBox 中新增了带有 setting 参数的 Show 方法的几个重载。要查看详细的使用方法，请查看wiki文档。

修复了 ClickEffect.Shake 效果抖动不明显的问题。 修复了 DataGridHelper 中， [ColumnDisplayIndex] 特性标签会导致报错的问题。 修复了 StateControl 中，当 CurrentState 不满足条件时，显示的内容不会自动隐藏的问题。 修复了 ComboBoxHelper 中，当使用了 BindToEnum 属性时， SelectedValue 属性可能会丢失绑定的问题。 修复了 ProgressBarHelper 中，当 PercentStringFormat 属性动态改变时， Text 不会自动更新的问题。 修复了 SliderHelper 中， ShadowHelper 中的属性不会对 ThumbShadowColor 属性生效的问题。

⚠️ 由于翻译问题， Spinner 控件重命名为 Spin ，其他带有 Spinner 名称的属性也一并做出了改动。你可以通过全局替换（区分大小写）的方式完成替换。 ⚠️ Pagination 和 PaginationItem 中以 CheckedXxx 或 ItemsCheckedXxx 名称的属性被重命名为 SelectedXxx 和 ItemsSelectedXxx 。 ⚠️ 由于 SearchBox 控件的问题较多，该控件已经完全重做。具体用法请参考 Samples/Views/NeteaseMusicView.xaml 中的示例。 ⚠️ 删除了 DataGridHelper 中的 CellPadding 属性。现在，你可以直接使用 DataGrid 控件原生的 Padding 属性来控制内边距。 ⚠️ 移除了 NoticeBox 中 Show 方法的部分重载，新增了带有 setting 参数的几个重载方法。要查看详细的使用方法，请查看wiki文档。 ⚠️ 由于 Drawer 控件的打开关闭问题较多，该控件已经完成了重做，但波及的属性范围不大。现在， Drawer 控件不再需要指定 MaxWidth 或 MaxHeight 属性了。

2022/5/22

本次发布更新了较多内容，请谨慎完成更新。 另请注意：第二版PanuonIconFont仍在更新中，符号代码随时有可能发生改变，不建议在正式环境中使用。 通过优化 Template 结构，在最优情况下，控件的加载性能最高可以提升约 50% 。提升效果因不同的样式而异，不对此效果做出任何保证。 在之前的版本中，收到了关于 ScrollViewer 内部的滚动条出现内容遮挡的问题。事实上，这是由 ScrollViewerHelper.ScrollBarPosition 属性控制的；为了不对用户产生困扰，新版本中这个属性的值已经从 Inside 变为 Outside 。如果需要将滚动条显示在容器内部，请重新修改此属性的值（这个属性支持在控件树中继承）。

修复了 RadioButton 中 ToggleBrush 和 CheckedToggleBrush 绑定相反的问题。要更改选中状态下的圆钮颜色，请通过 CheckedToggleBrush 而不是 ToggleBrush 。另外，还修复了圆钮出现显示偏移，不在中央圆心的问题。 修复了 CheckBox 在动态修改 GlyphBrush 和 CheckedGlyphBrush 时，可能出现勾选对号不显示的问题。 修复了 CalendarX 星期显示异常的问题。 修复了 TimeSelector 控件中 MinTime 和 MaxTime 属性无法动态修改的问题。 修复了 DateTimePicker 控件中 MinDateTime 和 MaxDateTime 属性动态修改效果不及预期的问题。 修复了 CacheControl 中子控件大小测量异常，导致滚动条无法显示的问题。 修复了 DataGridHelper 中 IsVerticalScrollBarCrossingColumnHeaderPanel 和 IsHorizontalScrollBarCrossingFrozenColumns 效果相反的问题。

新功能： ComboBoxHelper 新增了 ItemsHorizontalContentAlignment 和 ItemsVerticalContentAlignment 属性。此属性允许与 Content 呈现不同的对齐布局。 ExpanderHelper 新增了 HeaderFontSize 、 HeaderFontFamily 属性。

由于翻译问题，所有以 Nullablexxx 开头的属性都被重命名为 Nullxxx 。 ComboBoxHelper 中删除了 IsSearchBoxPinned 属性。搜索框必须固定在下拉框的顶部，否则 ComboBox 的虚拟化将会失效。 ListBoxHelper 的 EmptyBackground 属性更改为了 EmptyContent 属性。当 HasItems 属性为 False 时，ListBox的显示区域将被此属性的值覆盖。 ScrollBarHelper 的 ThemeCornerRadius 属性的默认值由 5 更改为 1 。 ToggleButtonHelper 中新增了 CheckedIcon 属性。

2022/3/16

本次发布更新了较多内容，请谨慎完成更新。

修复了 MessageBoxX 窗体大小异常的问题。 修复了 CalendarX 控件中 MinDate 和 MaxDate 属性未达到预期效果的问题。 修复了 DropDown 控件点击内部内容时导致闪烁的问题。 修复了 DataGridHelper 中 ColumnsSequence 属性无效的问题。 修复了 MessageBoxX 中使用部分带有 countdown 参数方法时会引发异常的问题。由于此参数必须与 defaultButton 参数联用，因此删除了部分无效的方法。

新功能： ColorSelector 新增了 ColorEditors 属性。此属性可以控制HEX和RGB文本框编辑器的显示或隐藏。 ColorPicker 新增了 ColorEditors 属性。 DateTimePicker 现在支持时间选择了。此外，新增了 DateTimeSeparatorVisibility 、DateTimeSeparatorBrush 、 DateTimeSeparatorMargin 、 DateTimeSeparatorThickness 。这些属性可以用于控制下拉框中日历和时间选择器之间分割线的显示效果。 FormGroup 新增了 ErrorMessageForeground 、 InfoMessageForeground 、 SuccessMessageForeground 、 WarningMessageForeground 属性。这些属性用于控制不同验证结果时显示的消息的前景色。 SliderHelper 新增了 ThumbWidth 、 ThumbHeight 、 ThumbShadowColor 、 ThumbCornerRadius 、 ThumbBackground 、 ThumbBorderBrush 、 ThumbBorderThickness 属性。这些属性可以直接修改 Slider 中 Thumb 的样式。

改进： PopupX 控件不会再始终位于所有系统窗体的顶部。在其内部放入复杂控件时，展开时也不会再出现位置闪烁。所有使用 PopupX 的控件（如 ComboBox 、 DropDown 等）都会拥有此效果。 MessageBoxX 中展示消息的容器使用 TextBox 控件替代了 TextBlock 控件。 优化了 PendingBox 的显示效果。

新控件： TimeSelector 和 TimeSelectorItem 时间选择控件。此控件已成为 DateTimePicker 控件的一部分，你也可以单独使用这个控件。

ColorSelector 的 SliderStyle 属性拆分为 AccentColorSliderStyle 和 OpacitySliderStyle 属性。另外， InputTextBoxStyle 属性重命名为 EditorTextBoxStyle 。Samples项目中的FormView更新了示例。

2022/2/4

本次发布更新了较多内容，请谨慎完成更新。

修复了 SeparatorX 控件可能会造成窗体的 SizeToContent 失去效果的问题。 修复了 WindowX 在全屏模式下拖拽变回正常大小后，点击最大化按钮后窗体仍会覆盖任务栏的问题。

新功能： MessageBoxX 新增了countdown参数。此参数可以用于设置触发默认按钮的倒计时。倒计时的秒数会显示在默认按钮的内容末尾。 TextBoxHelper 新增了 FocusedBorderThickness 属性。 ToggleButtonHelper 新增了 CheckedShadowColor 属性。 DataGridHelper 新增了 CornerRadius （圆角）、 ShadowColor （阴影）、 IsHorizontalScrollBarCrossingFrozenColumns （使水平滚动条在显示上跨过冻结的列）、 IsVerticalScrollBarCrossingColumnHeaderPanel （使垂直滚动条在显示上跨过列标头栏）等十余个属性。

新控件： CalendarX / CalendarXItem 日历控件 DateTimePicker 日期时间选择器（时间选择暂未支持） Breadcrumb / BreadcrumbItem 面包屑导航 SearchBox 搜索控件

上个版本中发布的ComponentKeys键类现已删除。现在，组件资源键可以使用更简单的方式，并且无需引用资源字典。有关使用缩略资源键的方法，请参考命名与约定 - 资源键简化。所有示例项目和文档代码示例都已更新。

所有的 WatermarkBrush 属性，或以此名称为尾缀的属性都被重命名为 WatermarkForeground 。可以使用重命名 - 整个解决方案/区分大小写/不全字匹配来完成这一变更。

ColumnBindingAttribute 特性中新增了一些构造器。 Mode 属性重命名为 BindingMode 。 ColumnCellAttribute 和 ColumnHeaderAttribute 特性中构造器的参数顺序发生了改变。此外，新增了 Foreground 、 ForegroundBrushKey 、 Background 和 BackgroundBrushKey 属性。 ColumnWidthAttribute 特性中删除了一些构造器。现在， Width 和 Height 属性可以直接访问了，无需通过构造器。