update doc

2020-07-25 23:21:56 +08:00
1 parent 3a05bad249
commit c0e0f7d387
@@ -4,7 +4,7 @@ title: AnimationPath 动画路径

 `AnimationPath`动画路径，设定`Geometry `派生类型几何图形的数据，例如`PathGeometry `、`LineGeometry `等，实现固定的路径动画效果。

-```xml
+```cs
 public class AnimationPath : Shape
 ```

@@ -1,5 +1,5 @@
 ---
-title: CalendarWithClock
+title: CalendarWithClock 带有时钟的日历
 ---


@@ -4,7 +4,7 @@ title: Card 卡片

 用于卡片化展示数据，为`ContentControl`的派生类

-```c#
+```cs
 public class Card : ContentControl
 ```

@@ -4,7 +4,7 @@ title: Carousel 轮播

 可以在固定时间内循环切换项目。

-```c#
+```cs
 public class Carousel : SimpleItemsControl, IDisposable
 ```

@@ -4,7 +4,7 @@ title: ChatBubble 对话气泡

 对话气泡常出现于通讯类软件中，相对于纯文本形式的上下文对话，使用对话气泡可以让聊天界面更加生动有趣。通过扩展，还可以做出气泡皮肤，可使软件个性化功能更加丰富。

-```c#
+```cs
 public class ChatBubble : SelectableItem
 ```

@@ -4,7 +4,7 @@ title: CirclePanel 圆形布局

 圆形布局常用作方向按钮、功能按钮的容器。

-```c#
+```cs
 public class CirclePanel : Panel
 ```

@@ -1,5 +1,43 @@
 ---
-title: 建设中
+title: CircleProgressBar 圆形进度条
 ---

-建设中
+在宽高存在一定限制的区域可以使用圆形进度条节省空间。
+
+```cs
+[TemplatePart(Name = IndicatorTemplateName, Type = typeof(Arc))]
+public class CircleProgressBar : RangeBase
+```
+
+# 属性
+
+|属性|描述|默认值|备注|
+|-|-|-|-|
+|ArcThickness|圆形粗细|4|该默认值由主题提供|
+|ShowText|是否显示文本|true||
+|Text|文本内容|<空>|进度文本|
+
+# 样式
+
+|样式|描述|
+|-|-|
+|ProgressBarCircleBaseStyle|默认样式|
+|ProgressBarSuccessCircle|成功|
+|ProgressBarInfoCircle|信息|
+|ProgressBarWarningCircle|警告|
+|ProgressBarDangerCircle|危险|
+
+# 案例
+
+```xml
+<StackPanel Orientation="Horizontal" Margin="0,32,0,0">
+    <hc:CircleProgressBar Value="{Binding Value,ElementName=SliderDemo}"/>
+    <hc:CircleProgressBar Value="{Binding Value,ElementName=SliderDemo}" FontSize="30" Margin="16,0,0,0"/>
+    <hc:CircleProgressBar Value="{Binding Value,ElementName=SliderDemo}" Margin="16,0,0,0" ShowText="False" Width="20" Height="20" ArcThickness="2" Style="{StaticResource ProgressBarSuccessCircle}"/>
+    <hc:CircleProgressBar Value="{Binding Value,ElementName=SliderDemo}" Margin="16,0,0,0" ShowText="False" Width="30" Height="30" ArcThickness="6" Style="{StaticResource ProgressBarInfoCircle}"/>
+    <hc:CircleProgressBar Value="{Binding Value,ElementName=SliderDemo}" Margin="16,0,0,0" ShowText="False" Width="40" Height="40" ArcThickness="10" Style="{StaticResource ProgressBarWarningCircle}"/>
+    <hc:CircleProgressBar Value="{Binding Value,ElementName=SliderDemo}" Margin="16,0,0,0" Width="50" Height="50" Style="{StaticResource ProgressBarDangerCircle}"/>
+</StackPanel>
+```
+
+![CircleProgressBar](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Resources/CircleProgressBar.png)
@@ -1,5 +1,38 @@
 ---
-title: 建设中
+title: ColorPicker 颜色拾取器
 ---

-建设中
+仿制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
+<hc:ColorPicker Name="ColorPicker" Margin="32"/>
+```
+
+![ColorPicker](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Resources/ColorPicker.gif)
@@ -1,5 +1,68 @@
 ---
-title: 建设中
+title: ComboBox 组合框
 ---

-建设中
+原生组合框的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
+<StackPanel Margin="32">
+    <hc:ComboBox ShowClearButton="True" ItemsSource="{Binding DataList}" SelectedIndex="0"/>
+    <hc:ComboBox ItemsSource="{Binding DataList}" Margin="0,16,0,0" SelectedIndex="0" IsEnabled="False"/>
+    <hc:ComboBox ShowClearButton="True" ItemsSource="{Binding DataList}" SelectedIndex="0" Margin="0,16,0,0" IsEditable="True"/>
+
+    <hc:ComboBox ItemsSource="{Binding DataList}" SelectedIndex="0" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr1}}" Margin="0,32,0,0" Text="{ex:Lang Key={x:Static langs:LangKeys.ContentDemoStr}}"/>
+    <hc:ComboBox ShowClearButton="True" ItemsSource="{Binding DataList}" hc:InfoElement.Placeholder="{ex:Lang Key={x:Static langs:LangKeys.PlsEnterContent}}" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr2}}" hc:InfoElement.Necessary="True" Margin="0,32,0,0"/>
+    <hc:ComboBox ItemsSource="{Binding DataList}" IsEditable="True" SelectedIndex="0" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr1}}" Margin="0,32,0,0" Text="{ex:Lang Key={x:Static langs:LangKeys.ContentDemoStr}}"/>
+    <hc:ComboBox AutoComplete="True" ShowClearButton="True" ItemsSource="{Binding DataList}" IsEditable="True" hc:InfoElement.Placeholder="{ex:Lang Key={x:Static langs:LangKeys.PlsEnterContent}}" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr2}}" hc:InfoElement.Necessary="True" Margin="0,32,0,0"/>
+
+    <hc:ComboBox ItemsSource="{Binding DataList}" Width="380" hc:InfoElement.TitleWidth="140" hc:InfoElement.TitlePlacement="Left" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr3}}" Margin="0,32,0,0" Text="{ex:Lang Key={x:Static langs:LangKeys.ContentDemoStr}}"/>
+    <hc:ComboBox ShowClearButton="True" ItemsSource="{Binding DataList}" Width="380" hc:InfoElement.TitleWidth="140" hc:InfoElement.Placeholder="{ex:Lang Key={x:Static langs:LangKeys.PlsEnterContent}}" hc:InfoElement.TitlePlacement="Left" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr3}}" hc:InfoElement.Necessary="True" Margin="0,32,0,0"/>
+    <hc:ComboBox ItemsSource="{Binding DataList}" IsEditable="True" Width="380" hc:InfoElement.TitleWidth="140" hc:InfoElement.TitlePlacement="Left" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr3}}" Margin="0,32,0,0" Text="{ex:Lang Key={x:Static langs:LangKeys.ContentDemoStr}}"/>
+    <hc:ComboBox AutoComplete="True" ShowClearButton="True" ItemsSource="{Binding DataList}" IsEditable="True" Width="380" hc:InfoElement.TitleWidth="140" hc:InfoElement.Placeholder="{ex:Lang Key={x:Static langs:LangKeys.PlsEnterContent}}" hc:InfoElement.TitlePlacement="Left" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr3}}" hc:InfoElement.Necessary="True" Margin="0,32,0,0"/>
+</StackPanel>
+```
+
+![ColorPicker](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/extend_controls/ComboBox_1.png)
@@ -1,5 +1,4 @@
 ---
-title: 建设中
+title: CompareSlider 对比滑块
 ---

-建设中
@@ -1,5 +1,5 @@
 ---
-title: DatePicker
+title: DatePicker 日期选择器
 ---

 DatePicker 控件允许用户通过在文本框中键入日期或使用下拉的日历控件来选择日期。
@@ -1,5 +1,5 @@
 ---
-title: DateTimePicker
+title: DateTimePicker 日期时间选择器
 ---