PanuonUI(v1.0.0 alpha)

一个好看精致，不限制个人或商业使用的WPF控件库。
本库是一个正在开发的项目，如果遇到问题或有更好的建议，请发送邮件至[email protected]，或在我的知乎账户上私信我(@末城via)，QQ亦可（969954321，请务必备注来意）。

你可以在任何地方使用该库，包括移植到你自己的项目中。

警告

PUTabControl和PUTabItem是一对组合控件，必须结合起来使用（同理于PUComboBox和PUComboBoxItem、PUTreeView和PUTreeViewItem）。如果您是从工具箱中拖出的PUTabControl控件，设计器自动生成的子项将是TabItem，需要您手动修改为PUTabItem。
如果遇到问题，可以先查看示例程序中的代码。

v1.0.0 版本说明

全新的示例程序尚未开发完成，已加入此版本。
0.1.2版本中仍旧存在一些BUG。这些问题已在1.0版本中修复，并会在一些时间后再提交到0.1.2。
更新说明:

1. v0.1.2版本无法无损升级到此版本，您可能要对现有项目进行一些修改。
   
2. 将大多数的枚举类型移入到了Panuon.UI命名空间中。
   
3. 解决了ComboBox可能在虚拟化容器中出现BUG的问题。
   
4. 解决了多个控件在使用BindingItems属性时可能出现设置SelectedValue无效的问题。
   
5. 全新的示例程序（集成了属性说明、注意事项，左右滑动可以看到控件示例）。
   
6. Helper中的RowDefinition和ColumnDefinition已支持输入星号（例如pu:Helper.RowDefinition="1*"），纯数字则表示使用像素（例如pu:Helper.RowDefinition="40"）。
   
7. DeleteButtonVisibility统一重命名为CanDelete
8. 图片裁剪器中存在未修复的BUG，不推荐使用。
   

使用方式

1.添加对Panuon.UI.dll的引用
2.在你的项目中添加fontawesome.ttf字体文件，并在App.xaml中添加以下资源字典。

<ResourceDictionary Source="pack://application:,,,/Panuon.UI;component/Themes/Control.xaml" />

3.在需要使用PanuonUI的xaml文件中添加引用

xmlns:pu="clr-namespace:Panuon.UI;assembly=Panuon.UI"

当前的所有控件

基础控件
Window / MessageBox 窗体
Button / RepeatButton 按钮
TextBox 输入框
PasswordBox 密码框
ComboBox / ComboBoxItem 下拉框
CheckBox 复选框
RadioButton 单选按钮
TreeView / TreeViewItem 树视图
ProgressBar 进度条
TabControl / TabItem 选项卡
ListBox / ListBoxItem 列表
Slider 滑块
特殊控件
ResizeGrid 可调大小容器
Loading 等待控件
SlideShow 轮播控件
ImageCuter 图片裁剪器
DatePicker 日期时间选择器
PagingNav 分页器
图表
LineCharts 折线图

Window 窗体

PUWindow是一个继承自Window的控件，支持边角拖动缩放。
通过设置IsCoverMaskShow和IsAwaitShow属性，可以快速打开一个遮罩层，或同时打开遮罩层和等待控件。

PUWindow在创建时总是尝试将排在最前面的活动窗口设置为自己的Owner（但如果你在Show或ShowDialog前手动指定了它的Owner，则将以你的为准），以便于使用WindowStartupLocation属性和AllowAutoCoverMask属性（当此属性为True，且Owner是PUWindow类型时，该窗体打开时将自动把其Owner窗体的遮罩层打开，并在关闭时将其遮罩层关闭）。但这可能在某些情况下对你造成困扰。当你在一个窗体中尝试Show出多个PUWindow子窗体时，必须全部指定这些子窗体的Owner属性为当前窗体，否则可能会出现预料不到的问题。

PUMessageBox是一个继承自PUWindow的控件，它可以提供一段消息显示，一个询问对话框，或一个可以取消的等待框。

//1. 显示一个提示框
PUMessageBox.ShowDialog("你好啊");

//2. 显示一个确认框
if(PUMessageBox.ShowConfirm("确定执行？") == true)
{
  PUMessageBox.ShowDialog("已开始执行");
}

//3. 显示一个不能取消的等待框，该窗体将以Show的方式打开
PUMessageBox.ShowAwait("正在执行...");
//当任务执行完，将其关闭
PUMessageBox.CloseAwait();

//4. 显示一个可以取消的等待框，该窗体将以Show的方式打开
PUMessageBox.ShowAwait("正在执行...", delegate
{
  //当用户点击取消按钮时，将把取消按钮禁用，前端文字显示为“正在取消”，并触发此回调。
  PUMessageBox.CloseAwait(delegate
  {
    PUMessageBox.ShowDialog("您取消了此任务。");
  });
});
//如果用户没有取消，当任务执行完，您可以再将其关闭
PUMessageBox.CloseAwait();

你可以使用PUMessageBox.ShowAwait(string content)来打开一个等待对话框，并用PUMessageBox.CloseAwait()方法来将其关闭。
但如果你希望在CloseAwait之后立即打开一个新的PUWindow窗体（PUMessageBox的所有Show方法亦在此列），你必须指定新窗体的Owner为当前的主窗体，或者使用另一个重载方法PUMessageBox.CloseAwait(EventHandle closedCallback)关闭等待窗口，并将打开窗体的方法放入此事件处理中。否则新打开的窗体将被立即关闭。 示例：

//这种代码会导致弹框刚显示就被关闭
PUMessageBox.ShowAwait("正在执行...");
PUMessageBox.CloseAwait();
PUMessageBox.ShowDialog("任务已完成");

//必须像下面这样
PUMessageBox.ShowAwait("正在执行...");
PUMessageBox.CloseAwait(delegate
{
  PUMessageBox.ShowDialog("任务已完成");
});

//或这样
PUMessageBox.ShowAwait("正在执行...");
PUMessageBox.CloseAwait();
await Task.Delay(500);
PUMessageBox.ShowDialog("任务已完成");

//或者向下面这样
PUMessageBox.CloseAwait();
var testWindow = new TestWindow();
testWindow.Owner = this;
testWindow.ShowDialog();

依赖属性	类型	含义
Header	Object	通常情况下，Title属性会同时设置窗体的左上角标题和任务栏标题。如果你期望使用不同的值，可以单独设置Header属性来改变左上角的标题内容。如果设置为Null，左上角标题将默认使用Title属性的内容。默认值为Null。
Icon	Object	显示在左上角标题之前的图标。默认值为Null。
AnimationStyle	AnimationStyles枚举	启动/关闭时使用的动画样式。默认值为Scale（其余可选项为Gradual、Fade）。
AnimateIn	Boolean	打开窗体时是否使用动画。默认值为True。
AnimateOut	Boolean	关闭窗体时是否使用动画。默认值为True。
NavButtonVisibilty	Visibility	设置控制条右侧三个按钮的显示状态。默认值为Visible。
IsCoverMaskShow	Boolean	是否显示窗体的遮罩层。默认值为False。
IsAwaitShow	Boolean	是否打开窗体的遮罩层，并显示等待控件。默认值为False。
AllowShowDelay	Boolean	是否允许在启动时延迟显示窗体内容。在页面较为复杂时，将此属性设置为True有助于减少启动动画卡顿。
NavbarBackground	Brush	控制栏的背景色。默认值为White（白色）。
NavbarHeight	Double	控制栏的高度。默认值为30。
NavButtonHeight	Double	控制栏按钮的高度。默认值为30。
NavButtonWidth	Double	控制栏按钮的宽度。默认值为40。
BorderCornerRadius	CornerRadius	窗体圆角大小。默认值为0。
AllowAutoCoverMask*	Boolean	获取或设置是否允许在调用Show或ShowDialog方法时自动打开父窗体的遮罩层，并在Close时将其关闭。默认值为False。
AllowForcingClose	Boolean	获取或设置是否允许用户使用Alt+F4组合键强制关闭窗体（在窗体Load事件之后设置此属性无效）。默认值为True。

方法	含义
AppendNavButton(object content, RoutedEventHandler clickHandler)	向标题栏右侧控制按钮组中添加一个新的按钮，该按钮将被添加在按钮组的最左侧。

注意：上一个版本的CloseWindow()方法将不再使用，直接使用Close()方法即可触发关闭动画（若AnimateOut为True）。

Button 按钮

PUButton是一个继承自Button的控件，目前共有四种样式。
PURepeatButton和PUButton的样式、属性、方法完全一致。

依赖属性	类型	含义
ButtonStyle	ButtonStyles枚举	按钮的基本样式。默认值为General（其他可选项为Hollow、Outline、Link）。
ClickStyle	ClickStyles枚举	鼠标点击时按钮的效果。默认值为Classic（其他可选项为Sink）。
BorderCornerRadius	CornerRadius	按钮圆角大小。默认值为0。
CoverBrush	AnimationStyles枚举	鼠标悬浮时遮罩层的背景颜色（Outline和Link样式下为前景色）。默认值为白色（在Outline和Link样式下为灰色）

TextBox 输入框

PUTextBox是一个继承自TextBox的控件，目前共有两种样式。

依赖属性	类型	含义
TextBoxStyle	TextBoxStyles枚举	输入框的基本样式。默认值为General（其他可选项为IconGroup）。
Watermark	String	水印。默认值为空。
Icon	Object	放置在输入框前的图标，仅在IconGroup样式下有效。默认值为空。
IconWidth	Double	图标的宽度。默认值为30。
ShadowColor	Color	输入框获得焦点时阴影的颜色。默认值为#888888。
BorderCornerRadius	CornerRadius	输入框圆角大小。默认值为0。

PasswordBox 密码框

PUPasswordBox继承自TextBox。恶意程序可能会通过内存读取用户输入的密码，请勿在较高安全要求环境中使用。

不要对Text属性进行赋值，可能会导致意外的错误。按原生PasswordBox的方式使用即可。

依赖属性	类型	含义
PasswordBoxStyle	PasswordBoxStyles枚举	密码框的基本样式。默认值为General（其他可选项为IconGroup）。
Watermark	String	水印。默认值为空。
Icon	Object	放置在输入框前的图标，仅在IconGroup样式下有效。默认值为空。
IconWidth	Double	图标的宽度，仅在IconGroup样式下有效。默认值为30。
ShadowColor	Color	密码框获得焦点时阴影的颜色。默认值为#888888。
BorderCornerRadius	CornerRadius	密码框圆角大小。默认值为0。

ComboBox 下拉框

PUComboBox依赖属性

依赖属性	类型	含义
ShadowColor	Color	获下拉框激活时阴影的颜色。默认值为#88888。
CoverBrush	String	鼠标悬浮在选择项时的背景颜色。默认值为#EEEEEE。
DeleteMode	DeleteModes枚举	当用户点击下拉框子项的删除按钮时，应该执行的操作。默认值为DeleteAndRouted（其他可选项为EventOnly）。
BindingItems	IList集合	绑定对象模板，通过该属性可以将内容绑定到Model类集合，而不是UI对象集合。默认值为空。
SelectedValuePath	SelectedValuePaths枚举	当子项目被选中时，SelectedValue应呈现子项PUComboBoxItem的哪一个值。默认值为Header（Value）。
SelectedValue	Object	子项PUComboBoxItem的Header或Value属性（取决于SelectedValuePath的值），或通过设置该值来选中指定的子项目。默认值为空。
BorderCornerRadius	CornerRadius	下拉框和输入框的圆角大小。默认值为0。

PUComboBox包含以下一个额外的路由事件。

路由事件	含义
DeleteItem	当用户点击子项PUComboBoxItem的删除按钮时，触发此路由事件。

PUComboBoxItem依赖属性

依赖属性	类型	含义
DeleteButtonVisibility	Visibility	下拉选择项后侧删除按钮的显示状态。默认值为Collpased。
Value	Object	下拉选择项可以携带的值，仅用于标记该子项的实际内容，不会对前端显示造成影响。默认值为Null。

PUComboBoxItem包含以下一个额外的类。

类	含义
PUComboBoxItemModel	用于绑定到PUComboBox子项集合的模型类，参见PUComboBox的BindingItems属性。

（文档更新中）