NoticeBox zh CN
适用于: v1.1.12 或更新的版本
类名: NoticeBox
命名空间: Panuon.WPF.UI
位于: SharedResources/Panuon.WPF.UI/Helpers/NoticeBox.cs
静态类
提供一系列属性和方法, 用于在桌面的左下角显示通知。
NoticeBox 通知 不依赖任何 Panuon.WPF.UI 中的资源字典，即使不引用 Control.xaml ，也可使用 NoticeBox 通知 或自定义它的样式。
当 CreateOnNewThread 属性为 True 时（它的默认值为 True）， 你无法在通知的内部样式中使用 Panuon.WPF.UI 中提供的任何资源（例如 Style），因为它们无法跨越线程。因此，NoticeBox 通知 是基于自定义或原生控件样式制作的。
除非将 CreateOnNewThread 属性显式设置为 False ，否则你也应当使用原生控件来完成样式设计。
默认情况下，通知会在一个新的线程上启动。这意味着，即使你在打开通知后执行一个UI线程上的耗时操作，通知的UI线程也不会被干扰（即不会出现假死状态）。
请注意，Panuon.WPF.UI.Configurations.NoticeBoxSetting 和
Panuon.WPF.UI.NoticeBoxSettings 是两个完全不同的类型（后者带s）。
要统一修改所有 NoticeBox 通知 的样式，你可以在 cs代码 中直接修改 NoticeBoxSettings.Setting 属性中的内容，或者也可以选择像示例3 中那样，将属性定义放置在 App.xaml 中。在使用后一种方案时，你仍然可以在 cs代码 中使用前一种方案来覆盖属性的值。
如果要单独为某个 NoticeBox 通知 指定样式，请使用带有 setting 参数的 Show 重载方法，并在 cs代码 中创建 MessageBoxSetting 对象（或资源字典中创建，并使用 Application.Current.FindResource() 等类似的方法找到对象并传入（见示例2））。
一旦 Show 方法被调用，之后该方法的 setting 参数中就只有 NoticeBoxItemStyle 属性会重新生效。要修改其他属性的值，请使用 DestoryInstance() 方法销毁实例，然后再次调用 Show 方法。
该方法带有多个重载，请根据实际需要，选择合适的重载方法。
全部参数: Window owner, string message, string caption, bool canCancel, MessageBoxXSetting setting
返回值: Panuon.WPF.UI.IPendingHandler
显示一个通知。
owner: 指定通知的 Owner 窗体。如果此参数为空，通知会显示在屏幕的中央。当此参数不为空时，通知会显示在该参数窗体的中央。如果该参数窗体是 WindowX 窗体X 类型，通知在打开和关闭时会自动控制该窗体的遮罩层。
message: 要显示的消息主体。
caption: 要显示的标题。
canCancel: 是否显示取消通知项卡片并允许用户取消等待。
setting: 框的属性设定。如果此参数不为空，将不再使用 MessageBoxXSettings.Setting 属性中的值。
返回值: 通过此手柄来控制通知的文本内容、处理取消和关闭事件，或关闭通知。
销毁现有的 NoticeBox 通知 实例。这将关闭承载通知卡片的窗体，并终止已经创建的线程。
之后，你可以通过调用 Show 方法再次创建新的实例。
类型: System.Boolean
默认值: True
获取或设置是否在新线程上打开通知。当此属性值为 True 时，Panuon.WPF.UI会创建一个新的线程来承载通知。这在执行UI线程长时操作时非常有用。
类型: System.Windows.Style
默认值: [见资源键[NoticeBoxItemStyle](#NoticeBoxItemStyle)]
获取或设置 NoticeBoxItem 通知项 控件的样式。
类型: Panuon.WPF.UI.AnimationEase
默认值: [None] / BackIn / BackOut / BackInOut_ ...
获取或设置卡片弹出动画使用的缓动函数。有关WPF缓动函数的更多信息，请查阅 EasingFunction 相关的文档。
类型: System.Duration
默认值: 0:0:0.5 ...
获取或设置卡片弹出动画的持续时间。
类型: System.Double
默认值: 35.0
获取或设置标题的高度。
类型: System.Windows.CornerRadius
默认值: 0,0,0,0
获取或设置通知项卡片的圆角大小。
类型: System.Media.Color ?
默认值: {Null}
获取或设置通知项卡片的阴影颜色。此属性可以通过设置为 Null (在Xaml中为 {x:Null})来取消效果。若要更改阴影的模糊半径、深度等属性，请查看ShadowHelper 辅助类。
类型: System.Media.Brush
默认值: (相较于Background属性较深的颜色)
获取或设置通知项卡片悬浮时的背景色彩画刷。此属性可以通过设置为 Null (在Xaml中为 {x:Null})来取消效果。
类型: System.Media.Brush
默认值: {Null}
获取或设置通知项卡片悬浮时的前景色彩画刷。此属性可以通过设置为 Null (在Xaml中为 {x:Null})来取消效果。
类型: System.Media.Brush
默认值: {Null}
获取或设置通知项卡片悬浮时的边框色彩画刷。此属性可以通过设置为 Null (在Xaml中为 {x:Null})来取消效果。
类型: System.Media.Color ?
默认值: {Null}
获取或设置通知项卡片悬浮时的阴影颜色。此属性可以通过设置为 Null (在Xaml中为 {x:Null})来取消效果。若要更改阴影的模糊半径、深度等属性，请查看ShadowHelper 辅助类。
类型: System.Media.Brush
默认值: (相较于Background属性更深的颜色)
获取或设置通知项卡片点击时的背景色彩画刷。此属性可以通过设置为 Null (在Xaml中为 {x:Null})来取消效果。
类型: System.Media.Brush
默认值: {Null}
获取或设置通知项卡片点击时的前景色彩画刷。此属性可以通过设置为 Null (在Xaml中为 {x:Null})来取消效果。
类型: System.Media.Brush
默认值: {Null}
获取或设置通知项卡片点击时的边框色彩画刷。此属性可以通过设置为 Null (在Xaml中为 {x:Null})来取消效果。
类型: System.Windows.Thickness ?
默认值: {Null}
获取或设置通知项卡片点击时的边框色彩粗细。此属性可以通过设置为 Null (在Xaml中为 {x:Null})来取消效果。
类型: Panuon.WPF.UI.ClickEffect
默认值: [None] / Sink / Shake
获取或设置通知项卡片的点击特效。None 表示没有点击特效，Sink 表示点击时下沉，Shake 表示点击时抖动。
有关如何使用资源键的更多内容, 请查看命名与约定-资源键。
一些无法从外部访问的属性已被隐去。
资源键全称: {ComponentResourceKey ResourceId=NoticeBoxItemStyle, TypeInTargetAssembly={x:Type pu:NoticeBox}}
缩略资源键: {pu:NoticeBox.NoticeBoxItemStyle}
通知项卡片的样式。
<Style x:Key="{ComponentResourceKey ResourceId=NoticeBoxItemStyle, TypeInTargetAssembly={x:Type pu:NoticeBox}}"
TargetType="pu:NoticeBoxItem">
<Setter Property="pu:IconHelper.FontFamily" Value="{Binding IconFontFamily, Source={x:Static pu:GlobalSettings.Setting}}" />
<Setter Property="pu:IconHelper.FontSize" Value="{Binding IconFontSize, Source={x:Static pu:GlobalSettings.Setting}}" />
<Setter Property="FontFamily" Value="{Binding FontFamily, Source={x:Static pu:GlobalSettings.Setting}}" />
<Setter Property="FontSize" Value="{Binding FontSize, Source={x:Static pu:GlobalSettings.Setting}}" />
<Setter Property="Width" Value="350" />
<Setter Property="Height" Value="150" />
<Setter Property="ClickEffect" Value="Sink" />
<Setter Property="VerticalContentAlignment" Value="Stretch" />
<Setter Property="HorizontalContentAlignment" Value="Stretch" />
</Style>
using Panuon.WPF.UI;
···
var handler = NoticeBox.Show("正在执行...", "提示", MessageBoxIcon.Info);
将以下定义放置在 App.xaml 中的 ResourceDictionary 中（或其他资源字典文件中，但要确保在 App.xaml 中引用，或通过 cs代码 装填到 Application.Current.Resources.MergedDictionaries 中）。如果不清楚如何放置，请下载源代码并查看 Samples 项目。
xmlns:pu="https://opensource.panuon.com/wpf-ui"
xmlns:puconfig="clr-namespace:Panuon.WPF.UI.Configurations;assembly=Panuon.WPF.UI"
···
<puconfig:NoticeBoxSetting x:Key="CustomNoticeSetting" AnimationEase="CircleOut" AnimationDuration="0:0:1.5" />
using Panuon.WPF.UI;
using Panuon.WPF.UI.Configurations;
···
var setting = Application.Current.FindResource("CustomNoticeSetting") as NoticeBoxSetting;
var handler = NoticeBox.Show("正在执行...", "提示", MessageBoxIcon.Info, true, setting);
将以下定义放置在 App.xaml 中的 ResourceDictionary 中（或其他资源字典文件中，但要确保在 App.xaml 中引用，或通过 cs代码 装填到 Application.Current.Resources.MergedDictionaries 中）。如果不清楚如何放置，请下载源代码并查看 Samples 项目。
xmlns:pu="https://opensource.panuon.com/wpf-ui"
···
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:pu="https://opensource.panuon.com/wpf-ui">
<!--注意，出于某种未知的原因，无论是否在App.xaml中直接定义，都需要在根资源字典中再嵌套一层资源字典。-->
<ResourceDictionary.MergedDictionaries>
<ResourceDictionary>
<!--x:Key的值是任意的，没有特殊要求-->
<pu:NoticeBoxSettings x:Key="noticeSetting" AnimationDuration="0:0:1" AnimationEase="CubicInOut">
<pu:NoticeBoxSettings.NoticeBoxItemStyle>
<Style TargetType="pu:NoticeBoxItem"
BasedOn="{StaticResource {ComponentResourceKey ResourceId=NoticeBoxItemStyle, TypeInTargetAssembly={x:Type pu:NoticeBox}}}">
<Setter Property="Background" Value="#1E1E1E" />
<Setter Property="BorderBrush" Value="#4E4E4E" />
<Setter Property="Foreground" Value="White" />
<Setter Property="ClickEffect" Value="None" />
</Style>
</pu:NoticeBoxSettings.NoticeBoxItemStyle>
</pu:NoticeBoxSettings>
</ResourceDictionary>
</ResourceDictionary.MergedDictionaries>
</ResourceDictionary>
using Panuon.WPF.UI;
···
var handler = NoticeBox.Show("正在执行...", "提示", MessageBoxIcon.Info);