From c0e0f7d3875dcf7fce19807b54b4217459976535 Mon Sep 17 00:00:00 2001 From: NaBian <836904362@qq.com> Date: Sat, 25 Jul 2020 23:21:56 +0800 Subject: [PATCH] update doc --- .../extend_controls/animationPath/index.md | 2 +- .../calendarWithClock/index.md | 2 +- .../extend_controls/card/index.md | 2 +- .../extend_controls/carousel/index.md | 2 +- .../extend_controls/chatBubble/index.md | 2 +- .../extend_controls/circlePanel/index.md | 2 +- .../circleProgressBar/index.md | 42 +++++++++++- .../extend_controls/colorPicker/index.md | 37 +++++++++- .../extend_controls/comboBox/index.md | 67 ++++++++++++++++++- .../extend_controls/compareSlider/index.md | 3 +- .../extend_controls/datePicker/index.md | 2 +- .../extend_controls/dateTimePicker/index.md | 2 +- 12 files changed, 149 insertions(+), 16 deletions(-) diff --git a/doc/source/handycontrol/extend_controls/animationPath/index.md b/doc/source/handycontrol/extend_controls/animationPath/index.md index 9466b1cc..7b807212 100644 --- a/doc/source/handycontrol/extend_controls/animationPath/index.md +++ b/doc/source/handycontrol/extend_controls/animationPath/index.md @@ -4,7 +4,7 @@ title: AnimationPath 动画路径 `AnimationPath`动画路径，设定`Geometry `派生类型几何图形的数据，例如`PathGeometry `、`LineGeometry `等，实现固定的路径动画效果。 -```xml +```cs public class AnimationPath : Shape ``` diff --git a/doc/source/handycontrol/extend_controls/calendarWithClock/index.md b/doc/source/handycontrol/extend_controls/calendarWithClock/index.md index 1705ddf9..b6dd7754 100644 --- a/doc/source/handycontrol/extend_controls/calendarWithClock/index.md +++ b/doc/source/handycontrol/extend_controls/calendarWithClock/index.md @@ -1,5 +1,5 @@ --- -title: CalendarWithClock +title: CalendarWithClock 带有时钟的日历 --- diff --git a/doc/source/handycontrol/extend_controls/card/index.md b/doc/source/handycontrol/extend_controls/card/index.md index 98a172fb..b22c443a 100644 --- a/doc/source/handycontrol/extend_controls/card/index.md +++ b/doc/source/handycontrol/extend_controls/card/index.md @@ -4,7 +4,7 @@ title: Card 卡片 用于卡片化展示数据，为`ContentControl`的派生类 -```c# +```cs public class Card : ContentControl ``` diff --git a/doc/source/handycontrol/extend_controls/carousel/index.md b/doc/source/handycontrol/extend_controls/carousel/index.md index f9350738..704ad0c6 100644 --- a/doc/source/handycontrol/extend_controls/carousel/index.md +++ b/doc/source/handycontrol/extend_controls/carousel/index.md @@ -4,7 +4,7 @@ title: Carousel 轮播 可以在固定时间内循环切换项目。 -```c# +```cs public class Carousel : SimpleItemsControl, IDisposable ``` diff --git a/doc/source/handycontrol/extend_controls/chatBubble/index.md b/doc/source/handycontrol/extend_controls/chatBubble/index.md index 07005158..c3417537 100644 --- a/doc/source/handycontrol/extend_controls/chatBubble/index.md +++ b/doc/source/handycontrol/extend_controls/chatBubble/index.md @@ -4,7 +4,7 @@ title: ChatBubble 对话气泡 对话气泡常出现于通讯类软件中，相对于纯文本形式的上下文对话，使用对话气泡可以让聊天界面更加生动有趣。通过扩展，还可以做出气泡皮肤，可使软件个性化功能更加丰富。 -```c# +```cs public class ChatBubble : SelectableItem ``` diff --git a/doc/source/handycontrol/extend_controls/circlePanel/index.md b/doc/source/handycontrol/extend_controls/circlePanel/index.md index e3250b28..45493a1a 100644 --- a/doc/source/handycontrol/extend_controls/circlePanel/index.md +++ b/doc/source/handycontrol/extend_controls/circlePanel/index.md @@ -4,7 +4,7 @@ title: CirclePanel 圆形布局 圆形布局常用作方向按钮、功能按钮的容器。 -```c# +```cs public class CirclePanel : Panel ``` diff --git a/doc/source/handycontrol/extend_controls/circleProgressBar/index.md b/doc/source/handycontrol/extend_controls/circleProgressBar/index.md index ca12ad62..f3cb7e7a 100644 --- a/doc/source/handycontrol/extend_controls/circleProgressBar/index.md +++ b/doc/source/handycontrol/extend_controls/circleProgressBar/index.md @@ -1,5 +1,43 @@ --- -title: 建设中 +title: CircleProgressBar 圆形进度条 --- -建设中 \ No newline at end of file +在宽高存在一定限制的区域可以使用圆形进度条节省空间。 + +```cs +[TemplatePart(Name = IndicatorTemplateName, Type = typeof(Arc))] +public class CircleProgressBar : RangeBase +``` + +# 属性 + +|属性|描述|默认值|备注| +|-|-|-|-| +|ArcThickness|圆形粗细|4|该默认值由主题提供| +|ShowText|是否显示文本|true|| +|Text|文本内容|<空>|进度文本| + +# 样式 + +|样式|描述| +|-|-| +|ProgressBarCircleBaseStyle|默认样式| +|ProgressBarSuccessCircle|成功| +|ProgressBarInfoCircle|信息| +|ProgressBarWarningCircle|警告| +|ProgressBarDangerCircle|危险| + +# 案例 + +```xml + + + + + + + + +``` + +![CircleProgressBar](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Resources/CircleProgressBar.png) \ No newline at end of file diff --git a/doc/source/handycontrol/extend_controls/colorPicker/index.md b/doc/source/handycontrol/extend_controls/colorPicker/index.md index ca12ad62..50755e87 100644 --- a/doc/source/handycontrol/extend_controls/colorPicker/index.md +++ b/doc/source/handycontrol/extend_controls/colorPicker/index.md @@ -1,5 +1,38 @@ --- -title: 建设中 +title: ColorPicker 颜色拾取器 --- -建设中 \ No newline at end of file +仿制Chrome的颜色拾取器，相关博文：[《WPF 控件库——仿制Chrome的ColorPicker》](https://www.cnblogs.com/nabian/p/9267646.html) + +```cs +[TemplatePart(Name = ElementBorderColor, Type = typeof(Border))] +[TemplatePart(Name = ElementBorderPicker, Type = typeof(Border))] +[TemplatePart(Name = ElementBorderDrag, Type = typeof(Border))] +[TemplatePart(Name = ElementPanelColor, Type = typeof(Panel))] +[TemplatePart(Name = ElementSliderColor, Type = typeof(Panel))] +[TemplatePart(Name = ElementSliderOpacity, Type = typeof(Panel))] +[TemplatePart(Name = ElementPanelRgb, Type = typeof(Panel))] +[TemplatePart(Name = ElementButtonDropper, Type = typeof(ToggleButton))] +public class ColorPicker : Control, ISingleOpen +``` + +# 属性 + +|属性|描述|默认值|备注| +|-|-|-|-| +|SelectedBrush|选中色|Brushes.White||| + +# 事件 + +|事件|描述|备注| +|-|-|-| +|SelectedColorChanged|颜色改变事件|| +|Canceled|取消事件||| + +# 案例 + +```xml + +``` + +![ColorPicker](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Resources/ColorPicker.gif) \ No newline at end of file diff --git a/doc/source/handycontrol/extend_controls/comboBox/index.md b/doc/source/handycontrol/extend_controls/comboBox/index.md index ca12ad62..4f765c15 100644 --- a/doc/source/handycontrol/extend_controls/comboBox/index.md +++ b/doc/source/handycontrol/extend_controls/comboBox/index.md @@ -1,5 +1,68 @@ --- -title: 建设中 +title: ComboBox 组合框 --- -建设中 \ No newline at end of file +原生组合框的HC扩展。 + +```cs +public class ComboBox : System.Windows.Controls.ComboBox, IDataInput +``` +# 属性 + +|属性|描述|默认值|备注| +|-|-|-|-| +|VerifyFunc|数据验证委托||| +|IsError|数据是否错误|false|| +|ErrorStr|错误提示||| +|TextType|文本类型||| +|ShowClearButton|是否显示清除按钮|false|| +|AutoComplete|是否自动完成输入|false||| + +# 附加属性 + +|属性|描述|默认值|备注| +|-|-|-|-| +|InfoElement.Placeholder|占位符||| +|InfoElement.Necessary|是否必填|false|| +|InfoElement.Symbol|必填标记|●|| +|InfoElement.ContentHeight|内容高度|30|标题在上时可用| +|InfoElement.MinContentHeight|最小内容高度|30|标题在上时可用| +|TitleElement.Title|标题||| +|TitleElement.TitlePlacement|标题对齐方式|TitlePlacementType.Top|| +|TitleElement.TitleWidth|标题宽度|120||| + +# 方法 + +|方法|描述|备注| +|-|-|-| +|VerifyData|验证数据|可手动触发验证| + +# 样式 + +|样式|描述| +|-|-| +|ComboBoxPlusBaseStyle|默认样式| + +# 案例 + +原生功能在扩展ComboBox上行为一致。 + +```xml + + + + + + + + + + + + + + + +``` + +![ColorPicker](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/extend_controls/ComboBox_1.png) \ No newline at end of file diff --git a/doc/source/handycontrol/extend_controls/compareSlider/index.md b/doc/source/handycontrol/extend_controls/compareSlider/index.md index ca12ad62..c58a6f3a 100644 --- a/doc/source/handycontrol/extend_controls/compareSlider/index.md +++ b/doc/source/handycontrol/extend_controls/compareSlider/index.md @@ -1,5 +1,4 @@ --- -title: 建设中 +title: CompareSlider 对比滑块 --- -建设中 \ No newline at end of file diff --git a/doc/source/handycontrol/extend_controls/datePicker/index.md b/doc/source/handycontrol/extend_controls/datePicker/index.md index f61a8282..12f44c7e 100644 --- a/doc/source/handycontrol/extend_controls/datePicker/index.md +++ b/doc/source/handycontrol/extend_controls/datePicker/index.md @@ -1,5 +1,5 @@ --- -title: DatePicker +title: DatePicker 日期选择器 --- DatePicker 控件允许用户通过在文本框中键入日期或使用下拉的日历控件来选择日期。 diff --git a/doc/source/handycontrol/extend_controls/dateTimePicker/index.md b/doc/source/handycontrol/extend_controls/dateTimePicker/index.md index 8dbbe027..fec76a19 100644 --- a/doc/source/handycontrol/extend_controls/dateTimePicker/index.md +++ b/doc/source/handycontrol/extend_controls/dateTimePicker/index.md @@ -1,5 +1,5 @@ --- -title: DateTimePicker +title: DateTimePicker 日期时间选择器 ---