From a2684e679e4c5d5baffcdb2c3ff7cef188fc9953 Mon Sep 17 00:00:00 2001
From: guanguanchuangyu <3246907890@qq.com>
Date: Mon, 18 Nov 2019 21:31:00 +0800
Subject: [PATCH 1/2] add doc of visualelement and  windowattach

---
 .../attach/visualElement/index.md             | 78 ++++++++++++++++++-
 .../handycontrol/attach/windowAttach/index.md | 55 ++++++++++++-
 2 files changed, 129 insertions(+), 4 deletions(-)

diff --git a/doc/source/handycontrol/attach/visualElement/index.md b/doc/source/handycontrol/attach/visualElement/index.md
index ca12ad62..b7572a01 100644
--- a/doc/source/handycontrol/attach/visualElement/index.md
+++ b/doc/source/handycontrol/attach/visualElement/index.md
@@ -1,5 +1,79 @@
 ---
-title: 建设中
+title: VisualElement 可视化元素
 ---
 
-建设中
\ No newline at end of file
+# 属性
+
+| 名称           | 用途             |
+| -------------- | ---------------- |
+| HighlightBrush | 设置控件高亮颜色 |
+| Text           | 设置文本内容     |
+
+# 使用案例
+
+对应`xaml`中添加`HandyControl`对应的命名空`xmlns:hc="https://handyorg.github.io/handycontrol"`
+
+## HighlightBrush 设置控件高亮颜色
+
+```xml
+<UniformGrid Margin="22,22,0,0" Rows="2" Columns="2">
+        <RadioButton Margin="10,10,0,0" Background="{DynamicResource SecondaryRegionBrush}" 
+                     Style="{StaticResource RadioButtonIcon}" 
+                     Content="RadioButton" IsChecked="True"
+                     GroupName="radio1"/>
+        <RadioButton Margin="10,10,0,0" BorderThickness="1" 
+                     Style="{StaticResource RadioButtonIcon}"
+                     hc:VisualElement.HighlightBrush="YellowGreen"
+                     Content="RadioButton"
+                     GroupName="radio2"/>
+    </UniformGrid>
+```
+
+如下截图为一组选中状态时的高亮对比结果，左图为样式`默认颜色`，右侧为个人`自定义颜色`
+
+![VisualElement.HighlightBrush](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/attach/VisualElement.HighlightBrush.png)
+
+## Text 设置文本内容
+
+可视化文本内容，主要用于微软`WPF`库中原生控件需要显示辅助文本，但并没有对应的文本内容显示属性时，通过控件的自定义样式时，使用此附加属性进行进行文本内容的显示。
+
+例如：当自定义进度条，需要显示文本时，本身缺少显示额外文本内容的属性，可以通过自定样式显示对应文本，以`Text`作为文本内容承载属性
+
+自定义样式：
+
+```xml
+<Style x:Key="ProgressBarBaseStyle" TargetType="ProgressBar">
+    <Setter Property="controls:VisualElement.Text">
+            <Setter.Value>
+                .....忽略代码.....
+            </Setter.Value>
+    </Setter>
+    <Setter Property="Template">
+            <Setter.Value>
+                <ControlTemplate TargetType="ProgressBar">
+                    <controls:SimplePanel x:Name="TemplateRoot">
+							....忽略代码....
+                        <controls:SimplePanel HorizontalAlignment="Left">
+                            ....忽略代码....
+                            <TextBlock HorizontalAlignment="Center" VerticalAlignment="Center" Foreground="{DynamicResource TextIconBrush}" Text="{Binding Path=(controls:VisualElement.Text),RelativeSource={RelativeSource TemplatedParent}}"/>
+                        </controls:SimplePanel>
+                    </controls:SimplePanel>
+                </ControlTemplate>
+            </Setter.Value>
+        </Setter>
+</Style>
+```
+
+`xaml`中的使用：
+
+```xml
+    <UniformGrid Margin="22,22,0,0" Rows="2" Columns="2">
+        <ProgressBar Style="{DynamicResource ProgressBarDanger}" 
+                     hc:VisualElement.Text="这是可视化文本"
+                     Background="YellowGreen"></ProgressBar>
+    </UniformGrid>
+```
+
+效果：
+
+![VisualElement.Text](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/attach/VisualElement.Text.png)
\ No newline at end of file
diff --git a/doc/source/handycontrol/attach/windowAttach/index.md b/doc/source/handycontrol/attach/windowAttach/index.md
index ca12ad62..ecf59116 100644
--- a/doc/source/handycontrol/attach/windowAttach/index.md
+++ b/doc/source/handycontrol/attach/windowAttach/index.md
@@ -1,5 +1,56 @@
 ---
-title: 建设中
+title: WindowAttach 窗体专用
 ---
 
-建设中
\ No newline at end of file
+# 属性
+
+| 名称              | 用途                                                         |
+| ----------------- | ------------------------------------------------------------ |
+| IsDragElement     | 是否允许当前元素可拖动窗体                                   |
+| IgnoreAltF4       | 是否忽略快捷键Alt和F4（键盘快速退出或者 结束 当前正在运行的应用程序） |
+| ShowInTaskManager | 是否窗体显示到任务管理器中                                   |
+
+# 使用案例
+
+对应`xaml`中添加`HandyControl`对应的命名空`xmlns:hc="https://handyorg.github.io/handycontrol"`
+
+```xml
+<hc:BlurWindow x:Class="类命名空间"
+			 .....常规项......
+             WindowStartupLocation="CenterScreen"
+             ShowTitle="True"
+             Style="{DynamicResource WindowBlur}"
+             xmlns:hc="https://handyorg.github.io/handycontrol"
+             d:DesignHeight="450" d:DesignWidth="800">
+    <hc:SimplePanel>
+        <Rectangle VerticalAlignment="Top" Margin="10" Height="30" RadiusX="4" RadiusY="4" Stroke="{DynamicResource BorderBrush}" StrokeDashArray="2,2"/>
+        <Border hc:WindowAttach.IsDragElement="True" VerticalAlignment="Top" Margin="11" Height="28" Background="{DynamicResource DarkDefaultBrush}" CornerRadius="4">
+            <TextBlock Text="DragHere" Style="{StaticResource TextBlockDefault}"/>
+        </Border>
+        <Button HorizontalAlignment="Right" Margin="0,15,15,0" VerticalAlignment="Top" Padding="0" Height="20" Width="20" Style="{StaticResource ButtonPrimary}" hc:IconElement.Geometry="{StaticResource CloseGeometry}" hc:BorderElement.CornerRadius="15"/>
+    </hc:SimplePanel>
+</hc:BlurWindow>
+```
+
+可在深色框区域鼠标拖动窗体
+
+![WindowAttach.IsDragElement](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/attach/WindowAttach.IsDragElement.png)
+
+# IgnoreAltF4 是否忽略快捷键Alt和F4
+
+常用于自定义设定需要手动关闭当前激活状态的应用程序，如`HandyControl`中的`Notifycation`或者`NotifyIcon`控件，默认为False
+
+```xml
+<Setter Property="hc:WindowAttach.IgnoreAltF4" Value="True"/>
+```
+
+## ShowInTaskManager 是否窗体显示到任务管理器中
+
+设定`Window`控件及其子类是否显示在任务管理器中
+
+使用前提：
+
+- 窗体的实例显示时，不使用`ShowDialog`
+- 同时设置`ShowInTaskBar`为`false`
+
+ps：该附加属性在`Windows7`中效果不是很明显
\ No newline at end of file

From e05b932063b7c9ec6fada21090e3f95d19eac8a9 Mon Sep 17 00:00:00 2001
From: NaBian <836904362@qq.com>
Date: Thu, 28 Nov 2019 21:59:20 +0800
Subject: [PATCH 2/2] modified some descriptions

---
 .../handycontrol/attach/visualElement/index.md     |  4 +---
 .../handycontrol/attach/windowAttach/index.md      | 14 ++++++--------
 2 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/doc/source/handycontrol/attach/visualElement/index.md b/doc/source/handycontrol/attach/visualElement/index.md
index b7572a01..548af7e3 100644
--- a/doc/source/handycontrol/attach/visualElement/index.md
+++ b/doc/source/handycontrol/attach/visualElement/index.md
@@ -11,8 +11,6 @@ title: VisualElement 可视化元素
 
 # 使用案例
 
-对应`xaml`中添加`HandyControl`对应的命名空`xmlns:hc="https://handyorg.github.io/handycontrol"`
-
 ## HighlightBrush 设置控件高亮颜色
 
 ```xml
@@ -35,7 +33,7 @@ title: VisualElement 可视化元素
 
 ## Text 设置文本内容
 
-可视化文本内容，主要用于微软`WPF`库中原生控件需要显示辅助文本，但并没有对应的文本内容显示属性时，通过控件的自定义样式时，使用此附加属性进行进行文本内容的显示。
+主要用于设置控件的辅助文本，当控件没有合适的属性用于显示文本时，可通过此附加属性在自定义样式中设置。
 
 例如：当自定义进度条，需要显示文本时，本身缺少显示额外文本内容的属性，可以通过自定样式显示对应文本，以`Text`作为文本内容承载属性
 
diff --git a/doc/source/handycontrol/attach/windowAttach/index.md b/doc/source/handycontrol/attach/windowAttach/index.md
index ecf59116..5847a3a4 100644
--- a/doc/source/handycontrol/attach/windowAttach/index.md
+++ b/doc/source/handycontrol/attach/windowAttach/index.md
@@ -12,7 +12,7 @@ title: WindowAttach 窗体专用
 
 # 使用案例
 
-对应`xaml`中添加`HandyControl`对应的命名空`xmlns:hc="https://handyorg.github.io/handycontrol"`
+## IsDragElement 是否允许当前元素可拖动窗体
 
 ```xml
 <hc:BlurWindow x:Class="类命名空间"
@@ -36,21 +36,19 @@ title: WindowAttach 窗体专用
 
 ![WindowAttach.IsDragElement](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/attach/WindowAttach.IsDragElement.png)
 
-# IgnoreAltF4 是否忽略快捷键Alt和F4
+## IgnoreAltF4 是否忽略快捷键Alt和F4
 
-常用于自定义设定需要手动关闭当前激活状态的应用程序，如`HandyControl`中的`Notifycation`或者`NotifyIcon`控件，默认为False
+用于屏蔽窗口的 Alt+F4 关闭功能。
 
 ```xml
 <Setter Property="hc:WindowAttach.IgnoreAltF4" Value="True"/>
 ```
 
-## ShowInTaskManager 是否窗体显示到任务管理器中
-
-设定`Window`控件及其子类是否显示在任务管理器中
+## ShowInTaskManager 是否将窗体显示到任务管理器中
 
 使用前提：
 
-- 窗体的实例显示时，不使用`ShowDialog`
-- 同时设置`ShowInTaskBar`为`false`
+- 窗口必须为非模态窗口，即不能使用`ShowDialog`显示窗口。
+- 窗口必须同时设置`ShowInTaskBar`为`false`
 
 ps：该附加属性在`Windows7`中效果不是很明显
\ No newline at end of file