From bb3e379ed422f284e0a6f11496481ff41b869c56 Mon Sep 17 00:00:00 2001
From: guanguanchuangyu <3246907890@qq.com>
Date: Sun, 8 Dec 2019 22:33:00 +0800
Subject: [PATCH 1/5] doc of attach/tipElement doc of
 native_controls/listview,menu,passwordbox

---
 .../handycontrol/attach/tipElement/index.md   | 41 +++++++++-
 .../native_controls/listView/index.md         | 22 ++++-
 .../native_controls/menu/index.md             | 81 ++++++++++++++++++-
 .../native_controls/passwordBox/index.md      | 45 ++++++++++-
 .../native_controls/progressBar/index.md      |  3 +-
 5 files changed, 182 insertions(+), 10 deletions(-)

diff --git a/doc/source/handycontrol/attach/tipElement/index.md b/doc/source/handycontrol/attach/tipElement/index.md
index ca12ad62..6b91f48d 100644
--- a/doc/source/handycontrol/attach/tipElement/index.md
+++ b/doc/source/handycontrol/attach/tipElement/index.md
@@ -1,5 +1,42 @@
 ---
-title: 建设中
+title: TipElement 提示元素
 ---
 
-建设中
\ No newline at end of file
+# 属性
+
+| 名称       | 用途     |
+| ---------- | -------- |
+| Placement | 提示元素显示位置 |
+| Visibility | 是否可见 |
+
+
+# 使用案例
+
+## Placement 提示元素显示位置
+
+该属性，用于设定提示元素显示位置，目前支持BottomRight和TopLeft（默认值）
+
+```
+<hc:RangeSlider Width="400" 
+                    hc:TipElement.Visibility="Visible" 
+                    TickPlacement="BottomRight" 
+                    IsSnapToTickEnabled="True" 
+                    Maximum="100" ValueEnd="60" 
+                    TickFrequency="10" 
+                    Margin="0,32,0,0"/>
+    <hc:RangeSlider Width="400" 
+                    hc:TipElement.Visibility="Visible"
+                    hc:TipElement.Placement="BottomRight"
+                    TickPlacement="BottomRight" 
+                    IsSnapToTickEnabled="True" 
+                    Maximum="100" ValueEnd="60" 
+                    TickFrequency="10" 
+                    Margin="0,32,0,0"/>
+```
+
+效果
+
+![TipElement.Default](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/attach/TipElement.Default.png)
+
+![TipElement.TopLeft](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/attach/TipElement.TopLeft.png)
+
diff --git a/doc/source/handycontrol/native_controls/listView/index.md b/doc/source/handycontrol/native_controls/listView/index.md
index ca12ad62..308ecd17 100644
--- a/doc/source/handycontrol/native_controls/listView/index.md
+++ b/doc/source/handycontrol/native_controls/listView/index.md
@@ -1,5 +1,23 @@
 ---
-title: 建设中
+title: ListView 列表视图
 ---
 
-建设中
\ No newline at end of file
+`HandyControl`中仅仅提供了一个默认的`ListView`的资源样式，可根据个人需求，自行定义
+
+# 案例
+
+```
+    <ListView ItemsSource="{Binding DataList}" Margin="20">
+        <ListView.View>
+            <GridView>
+                <GridViewColumn Width="80" Header="标题1" DisplayMemberBinding="{Binding Index}"/>
+                <GridViewColumn Width="100" Header="标题2" DisplayMemberBinding="{Binding Name}"/>
+                <GridViewColumn Width="200" Header="标题3" DisplayMemberBinding="{Binding Remark}"/>
+            </GridView>
+        </ListView.View>
+    </ListView>
+```
+
+
+
+![ListView.DefaultStyle](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/native_controls/ListView.DefaultStyle.png)
\ No newline at end of file
diff --git a/doc/source/handycontrol/native_controls/menu/index.md b/doc/source/handycontrol/native_controls/menu/index.md
index ca12ad62..33edb44e 100644
--- a/doc/source/handycontrol/native_controls/menu/index.md
+++ b/doc/source/handycontrol/native_controls/menu/index.md
@@ -1,5 +1,82 @@
 ---
-title: 建设中
+title: Menu 菜单
 ---
 
-建设中
\ No newline at end of file
+# MenuBaseStyle
+
+`HandyControl`中的菜单默认样式，一般不建议直接使用，而是选择继承，便于个人自定义风格
+
+样式
+
+```xml
+    <Style BasedOn="{StaticResource MenuItemBaseStyle}" TargetType="MenuItem"/>
+    <Style BasedOn="{StaticResource MenuBaseStyle}" TargetType="Menu"/>
+```
+
+使用
+
+```
+<Menu ItemsSource="{Binding Menus}">
+        <Menu.ItemTemplate>
+            <HierarchicalDataTemplate ItemsSource="{Binding Children}">
+                <TextBlock Text="{Binding Name}"></TextBlock>
+            </HierarchicalDataTemplate>
+        </Menu.ItemTemplate>
+</Menu>
+```
+
+数据视图
+
+```c#
+    //菜单子项视图类
+    public class MenuItemViewModel
+    {
+        public List<MenuItemViewModel> Children { get; set; }
+        public MenuItemViewModel Parent { get; set; }
+        public string Name { get; set; }
+        public string Remark { get; set; }
+    }
+    //菜单数据视图类
+    public class MenuViewModel
+    {
+        public MenuViewModel()
+        {
+            Menus = new List<MenuItemViewModel>
+            {
+               new MenuItemViewModel
+               {
+                 Name="一级菜单",
+                 Children =  new List<MenuItemViewModel>{
+                  new MenuItemViewModel{
+                    Name="二级菜单"
+                  }
+                 }
+               },
+               new MenuItemViewModel
+               {
+                 Name="一级菜单",
+                 Children =  new List<MenuItemViewModel>{
+                  new MenuItemViewModel{
+                    Name="二级菜单"
+                  }
+                 }
+               },
+               new MenuItemViewModel
+               {
+                 Name="一级菜单",
+                 Children =  new List<MenuItemViewModel>{
+                  new MenuItemViewModel{
+                    Name="二级菜单"
+                  }
+                 }
+               }
+            };
+        }
+        public List<MenuItemViewModel> Menus { get; set; }
+    }
+```
+
+效果
+
+![Menu.BaseStyle](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/native_controls/Menu.BaseStyle.png)
+
diff --git a/doc/source/handycontrol/native_controls/passwordBox/index.md b/doc/source/handycontrol/native_controls/passwordBox/index.md
index ca12ad62..19bbda94 100644
--- a/doc/source/handycontrol/native_controls/passwordBox/index.md
+++ b/doc/source/handycontrol/native_controls/passwordBox/index.md
@@ -1,5 +1,46 @@
 ---
-title: 建设中
+title: PasswordBox 密码框
 ---
 
-建设中
\ No newline at end of file
+# PasswordBoxBaseStyle
+
+控件默认样式，该样式不建议直接使用，而是选择继承的方式进行个人控件样式的处理，参考在线资源[PasswordBoxBaseStyle](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Base/PasswordBoxBaseStyle.xaml)
+
+```
+<Style BasedOn="{StaticResource PasswordBoxBaseStyle}" TargetType="PasswordBox"/>
+```
+
+使用
+
+```
+    <PasswordBox PasswordChar="*"
+                 VerticalAlignment="Center"
+                 Width="120"></PasswordBox>
+```
+
+效果
+
+![PasswordBox.BaseStyle](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/native_controls/PasswordBox.BaseStyle.png)
+
+# PasswordBoxExtendBaseStyle
+
+控件拓展基础样式，是样式`PasswordBoxExtend`的基本样式，不建议直接使用，而是选择使用`PasswordBoxExtend`，该样式支持添加`PasswordBox`专用附加属性`PasswordBoxAttach`、额外信息元素`InfoElement`和标题元素`TitleElement`
+
+```
+    <!--为使普通密码输入文本框显示水印,需要设定PasswordBoxAttach.PasswordLength="0"-->
+    <PasswordBox Style="{DynamicResource PasswordBoxExtend}" PasswordChar="*" 
+                 hc:PasswordBoxAttach.PasswordLength="0"
+                 hc:InfoElement.Placeholder="请输入密码" 
+                 VerticalAlignment="Center"
+                 Width="120"></PasswordBox>
+    <PasswordBox Style="{DynamicResource PasswordBoxExtend}" PasswordChar="*" 
+                 hc:TitleElement.Title="用户密码："
+                 hc:TitleElement.TitleAlignment="Top"
+                 VerticalAlignment="Center"
+                 Width="120"></PasswordBox>
+```
+
+效果
+
+![PasswordBox.ExtendStyle](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/native_controls/PasswordBox.ExtendStyle.png)
+
diff --git a/doc/source/handycontrol/native_controls/progressBar/index.md b/doc/source/handycontrol/native_controls/progressBar/index.md
index ca12ad62..794ae369 100644
--- a/doc/source/handycontrol/native_controls/progressBar/index.md
+++ b/doc/source/handycontrol/native_controls/progressBar/index.md
@@ -1,5 +1,4 @@
 ---
-title: 建设中
+title: ProgressBar 进度条
 ---
 
-建设中
\ No newline at end of file

From 7f03a1015a1b41f8983e3ae458afd6b4c5cc1937 Mon Sep 17 00:00:00 2001
From: guanguanchuangyu <3246907890@qq.com>
Date: Mon, 23 Dec 2019 21:31:09 +0800
Subject: [PATCH 2/5] add progressbar.md

---
 .../native_controls/progressBar/index.md      | 81 +++++++++++++++++++
 1 file changed, 81 insertions(+)

diff --git a/doc/source/handycontrol/native_controls/progressBar/index.md b/doc/source/handycontrol/native_controls/progressBar/index.md
index 794ae369..4e37ca4c 100644
--- a/doc/source/handycontrol/native_controls/progressBar/index.md
+++ b/doc/source/handycontrol/native_controls/progressBar/index.md
@@ -2,3 +2,84 @@
 title: ProgressBar 进度条
 ---
 
+# ProgressBarBaseStyle
+
+`HandyControl`中自带的默认样式，不建议直接使用而是选择继承的方式，案例如下：
+
+```
+<Style BasedOn="{StaticResource ProgressBarBaseStyle}" TargetType="ProgressBar">
+        <Setter Property="Foreground" Value="{DynamicResource PrimaryBrush}"/>
+</Style>
+```
+
+# 其他样式
+
+`HandyControl`中自带的其他样式和效果，其中包含如下样式：
+
+| 样式Key            | 用途 |
+| ------------------ | ---- |
+| ProgressBarSuccess | 成功色进度条 |
+| ProgressBarInfo | 提示色进度条 |
+| ProgressBarWarning | 警告色进度条 |
+| ProgressBarDanger | 危险色进度条 |
+| ProgressBarPrimaryStripe | 主题色条纹进度条 |
+| ProgressBarSuccessStripe | 成功色条纹进度条 |
+| ProgressBarInfoStripe | 信息色条纹进度条 |
+| ProgressBarWarningStripe | 警告色条纹进度条 |
+| ProgressBarDangerStripe | 危险色条纹进度条 |
+| ProgressBarFlat | 扁平风格 |
+
+案例：
+```xml
+<StackPanel Margin="20">
+        <TextBlock Text="默认样式"></TextBlock>
+        <ProgressBar Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarSuccess"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarSuccess}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarInfo"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarInfo}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarWarning"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarWarning}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarDanger"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarDanger}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarPrimaryStripe"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarPrimaryStripe}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarSuccessStripe"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarSuccessStripe}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarInfoStripe"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarInfoStripe}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarWarningStripe"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarWarningStripe}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarDangerStripe"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarDangerStripe}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarFlat"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarFlat}" Value="40"></ProgressBar>
+    </StackPanel>
+```
+效果：
+![ProgressBar.Styles](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/native_controls/ProgressBar.Styles.png)
+
+# 温馨提示
+
+对于进度条进度颜色、圆角以及其他样式的个人使用需求，可查看`HandyControl`开源目中的[源码样式部分](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ProgressBar.xaml)自行定义
+

From 585f49306e38032b5b089dda2a390f8bdb03d331 Mon Sep 17 00:00:00 2001
From: guanguanchuangyu <3246907890@qq.com>
Date: Mon, 23 Dec 2019 22:07:08 +0800
Subject: [PATCH 3/5] reset The progressbar.md

---
 .../native_controls/progressBar/index.md      | 85 -------------------
 1 file changed, 85 deletions(-)

diff --git a/doc/source/handycontrol/native_controls/progressBar/index.md b/doc/source/handycontrol/native_controls/progressBar/index.md
index 4e37ca4c..e69de29b 100644
--- a/doc/source/handycontrol/native_controls/progressBar/index.md
+++ b/doc/source/handycontrol/native_controls/progressBar/index.md
@@ -1,85 +0,0 @@
----
-title: ProgressBar 进度条
----
-
-# ProgressBarBaseStyle
-
-`HandyControl`中自带的默认样式，不建议直接使用而是选择继承的方式，案例如下：
-
-```
-<Style BasedOn="{StaticResource ProgressBarBaseStyle}" TargetType="ProgressBar">
-        <Setter Property="Foreground" Value="{DynamicResource PrimaryBrush}"/>
-</Style>
-```
-
-# 其他样式
-
-`HandyControl`中自带的其他样式和效果，其中包含如下样式：
-
-| 样式Key            | 用途 |
-| ------------------ | ---- |
-| ProgressBarSuccess | 成功色进度条 |
-| ProgressBarInfo | 提示色进度条 |
-| ProgressBarWarning | 警告色进度条 |
-| ProgressBarDanger | 危险色进度条 |
-| ProgressBarPrimaryStripe | 主题色条纹进度条 |
-| ProgressBarSuccessStripe | 成功色条纹进度条 |
-| ProgressBarInfoStripe | 信息色条纹进度条 |
-| ProgressBarWarningStripe | 警告色条纹进度条 |
-| ProgressBarDangerStripe | 危险色条纹进度条 |
-| ProgressBarFlat | 扁平风格 |
-
-案例：
-```xml
-<StackPanel Margin="20">
-        <TextBlock Text="默认样式"></TextBlock>
-        <ProgressBar Value="40"></ProgressBar>
-    </StackPanel>
-    <StackPanel Margin="20">
-        <TextBlock Text="ProgressBarSuccess"></TextBlock>
-        <ProgressBar Style="{DynamicResource ProgressBarSuccess}" Value="40"></ProgressBar>
-    </StackPanel>
-    <StackPanel Margin="20">
-        <TextBlock Text="ProgressBarInfo"></TextBlock>
-        <ProgressBar Style="{DynamicResource ProgressBarInfo}" Value="40"></ProgressBar>
-    </StackPanel>
-    <StackPanel Margin="20">
-        <TextBlock Text="ProgressBarWarning"></TextBlock>
-        <ProgressBar Style="{DynamicResource ProgressBarWarning}" Value="40"></ProgressBar>
-    </StackPanel>
-    <StackPanel Margin="20">
-        <TextBlock Text="ProgressBarDanger"></TextBlock>
-        <ProgressBar Style="{DynamicResource ProgressBarDanger}" Value="40"></ProgressBar>
-    </StackPanel>
-    <StackPanel Margin="20">
-        <TextBlock Text="ProgressBarPrimaryStripe"></TextBlock>
-        <ProgressBar Style="{DynamicResource ProgressBarPrimaryStripe}" Value="40"></ProgressBar>
-    </StackPanel>
-    <StackPanel Margin="20">
-        <TextBlock Text="ProgressBarSuccessStripe"></TextBlock>
-        <ProgressBar Style="{DynamicResource ProgressBarSuccessStripe}" Value="40"></ProgressBar>
-    </StackPanel>
-    <StackPanel Margin="20">
-        <TextBlock Text="ProgressBarInfoStripe"></TextBlock>
-        <ProgressBar Style="{DynamicResource ProgressBarInfoStripe}" Value="40"></ProgressBar>
-    </StackPanel>
-    <StackPanel Margin="20">
-        <TextBlock Text="ProgressBarWarningStripe"></TextBlock>
-        <ProgressBar Style="{DynamicResource ProgressBarWarningStripe}" Value="40"></ProgressBar>
-    </StackPanel>
-    <StackPanel Margin="20">
-        <TextBlock Text="ProgressBarDangerStripe"></TextBlock>
-        <ProgressBar Style="{DynamicResource ProgressBarDangerStripe}" Value="40"></ProgressBar>
-    </StackPanel>
-    <StackPanel Margin="20">
-        <TextBlock Text="ProgressBarFlat"></TextBlock>
-        <ProgressBar Style="{DynamicResource ProgressBarFlat}" Value="40"></ProgressBar>
-    </StackPanel>
-```
-效果：
-![ProgressBar.Styles](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/native_controls/ProgressBar.Styles.png)
-
-# 温馨提示
-
-对于进度条进度颜色、圆角以及其他样式的个人使用需求，可查看`HandyControl`开源目中的[源码样式部分](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ProgressBar.xaml)自行定义
-

From dd45e7e32314211e1b49dbc2e81c3f50ed159e16 Mon Sep 17 00:00:00 2001
From: guanguanchuangyu <3246907890@qq.com>
Date: Mon, 23 Dec 2019 22:07:51 +0800
Subject: [PATCH 4/5] add doc of native_controls.progressbar.md

---
 .../native_controls/progressBar/index.md      | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)

diff --git a/doc/source/handycontrol/native_controls/progressBar/index.md b/doc/source/handycontrol/native_controls/progressBar/index.md
index e69de29b..4e37ca4c 100644
--- a/doc/source/handycontrol/native_controls/progressBar/index.md
+++ b/doc/source/handycontrol/native_controls/progressBar/index.md
@@ -0,0 +1,85 @@
+---
+title: ProgressBar 进度条
+---
+
+# ProgressBarBaseStyle
+
+`HandyControl`中自带的默认样式，不建议直接使用而是选择继承的方式，案例如下：
+
+```
+<Style BasedOn="{StaticResource ProgressBarBaseStyle}" TargetType="ProgressBar">
+        <Setter Property="Foreground" Value="{DynamicResource PrimaryBrush}"/>
+</Style>
+```
+
+# 其他样式
+
+`HandyControl`中自带的其他样式和效果，其中包含如下样式：
+
+| 样式Key            | 用途 |
+| ------------------ | ---- |
+| ProgressBarSuccess | 成功色进度条 |
+| ProgressBarInfo | 提示色进度条 |
+| ProgressBarWarning | 警告色进度条 |
+| ProgressBarDanger | 危险色进度条 |
+| ProgressBarPrimaryStripe | 主题色条纹进度条 |
+| ProgressBarSuccessStripe | 成功色条纹进度条 |
+| ProgressBarInfoStripe | 信息色条纹进度条 |
+| ProgressBarWarningStripe | 警告色条纹进度条 |
+| ProgressBarDangerStripe | 危险色条纹进度条 |
+| ProgressBarFlat | 扁平风格 |
+
+案例：
+```xml
+<StackPanel Margin="20">
+        <TextBlock Text="默认样式"></TextBlock>
+        <ProgressBar Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarSuccess"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarSuccess}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarInfo"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarInfo}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarWarning"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarWarning}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarDanger"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarDanger}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarPrimaryStripe"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarPrimaryStripe}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarSuccessStripe"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarSuccessStripe}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarInfoStripe"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarInfoStripe}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarWarningStripe"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarWarningStripe}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarDangerStripe"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarDangerStripe}" Value="40"></ProgressBar>
+    </StackPanel>
+    <StackPanel Margin="20">
+        <TextBlock Text="ProgressBarFlat"></TextBlock>
+        <ProgressBar Style="{DynamicResource ProgressBarFlat}" Value="40"></ProgressBar>
+    </StackPanel>
+```
+效果：
+![ProgressBar.Styles](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/native_controls/ProgressBar.Styles.png)
+
+# 温馨提示
+
+对于进度条进度颜色、圆角以及其他样式的个人使用需求，可查看`HandyControl`开源目中的[源码样式部分](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ProgressBar.xaml)自行定义
+

From cef6fd433ef5a258ba70bb501fa9b203638b53c8 Mon Sep 17 00:00:00 2001
From: NaBian <836904362@qq.com>
Date: Sun, 5 Jan 2020 22:31:29 +0800
Subject: [PATCH 5/5] modified doc

uniform doc structure
---
 .../native_controls/label/index.md            |  2 +-
 .../native_controls/listView/index.md         | 14 ++--
 .../native_controls/menu/index.md             | 73 ++-----------------
 .../native_controls/passwordBox/index.md      | 39 +++++-----
 .../native_controls/progressBar/index.md      | 36 ++++-----
 5 files changed, 49 insertions(+), 115 deletions(-)

diff --git a/doc/source/handycontrol/native_controls/label/index.md b/doc/source/handycontrol/native_controls/label/index.md
index 25b65927..cbd200ed 100644
--- a/doc/source/handycontrol/native_controls/label/index.md
+++ b/doc/source/handycontrol/native_controls/label/index.md
@@ -4,7 +4,7 @@ title: Lable标签
 
 # LabelBaseStyle
 
-Label标签 默认样式，不推荐直接使用，应该始终被其它样式以BasedOn的方式使用。
+Label标签默认样式，不推荐直接使用，应该始终被其它样式以BasedOn的方式使用。
 
 {% note info no-icon %}
 用例：
diff --git a/doc/source/handycontrol/native_controls/listView/index.md b/doc/source/handycontrol/native_controls/listView/index.md
index 308ecd17..10c9d1cb 100644
--- a/doc/source/handycontrol/native_controls/listView/index.md
+++ b/doc/source/handycontrol/native_controls/listView/index.md
@@ -2,11 +2,11 @@
 title: ListView 列表视图
 ---
 
-`HandyControl`中仅仅提供了一个默认的`ListView`的资源样式，可根据个人需求，自行定义
+`HandyControl`中仅提供了一个默认的`ListView`样式，可根据个人需求，自行定义。
 
-# 案例
-
-```
+{% note info no-icon %}
+用例：
+{% code %}
     <ListView ItemsSource="{Binding DataList}" Margin="20">
         <ListView.View>
             <GridView>
@@ -16,8 +16,8 @@ title: ListView 列表视图
             </GridView>
         </ListView.View>
     </ListView>
-```
+{% endcode %}
 
+![ListView.DefaultStyle](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/native_controls/ListView.DefaultStyle.png)
 
-
-![ListView.DefaultStyle](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/native_controls/ListView.DefaultStyle.png)
\ No newline at end of file
+{% endnote %}
\ No newline at end of file
diff --git a/doc/source/handycontrol/native_controls/menu/index.md b/doc/source/handycontrol/native_controls/menu/index.md
index 33edb44e..28d0237f 100644
--- a/doc/source/handycontrol/native_controls/menu/index.md
+++ b/doc/source/handycontrol/native_controls/menu/index.md
@@ -4,79 +4,20 @@ title: Menu 菜单
 
 # MenuBaseStyle
 
-`HandyControl`中的菜单默认样式，一般不建议直接使用，而是选择继承，便于个人自定义风格
+菜单默认样式，不推荐直接使用，应该始终被其它样式以BasedOn的方式使用。
 
-样式
-
-```xml
-    <Style BasedOn="{StaticResource MenuItemBaseStyle}" TargetType="MenuItem"/>
-    <Style BasedOn="{StaticResource MenuBaseStyle}" TargetType="Menu"/>
-```
-
-使用
-
-```
-<Menu ItemsSource="{Binding Menus}">
+{% note info no-icon %}
+用例：
+{% code %}
+    <Menu ItemsSource="{Binding Menus}">
         <Menu.ItemTemplate>
             <HierarchicalDataTemplate ItemsSource="{Binding Children}">
                 <TextBlock Text="{Binding Name}"></TextBlock>
             </HierarchicalDataTemplate>
         </Menu.ItemTemplate>
 </Menu>
-```
-
-数据视图
-
-```c#
-    //菜单子项视图类
-    public class MenuItemViewModel
-    {
-        public List<MenuItemViewModel> Children { get; set; }
-        public MenuItemViewModel Parent { get; set; }
-        public string Name { get; set; }
-        public string Remark { get; set; }
-    }
-    //菜单数据视图类
-    public class MenuViewModel
-    {
-        public MenuViewModel()
-        {
-            Menus = new List<MenuItemViewModel>
-            {
-               new MenuItemViewModel
-               {
-                 Name="一级菜单",
-                 Children =  new List<MenuItemViewModel>{
-                  new MenuItemViewModel{
-                    Name="二级菜单"
-                  }
-                 }
-               },
-               new MenuItemViewModel
-               {
-                 Name="一级菜单",
-                 Children =  new List<MenuItemViewModel>{
-                  new MenuItemViewModel{
-                    Name="二级菜单"
-                  }
-                 }
-               },
-               new MenuItemViewModel
-               {
-                 Name="一级菜单",
-                 Children =  new List<MenuItemViewModel>{
-                  new MenuItemViewModel{
-                    Name="二级菜单"
-                  }
-                 }
-               }
-            };
-        }
-        public List<MenuItemViewModel> Menus { get; set; }
-    }
-```
-
-效果
+{% endcode %}
 
 ![Menu.BaseStyle](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/native_controls/Menu.BaseStyle.png)
 
+{% endnote %}
\ No newline at end of file
diff --git a/doc/source/handycontrol/native_controls/passwordBox/index.md b/doc/source/handycontrol/native_controls/passwordBox/index.md
index 19bbda94..0b72a68d 100644
--- a/doc/source/handycontrol/native_controls/passwordBox/index.md
+++ b/doc/source/handycontrol/native_controls/passwordBox/index.md
@@ -4,29 +4,29 @@ title: PasswordBox 密码框
 
 # PasswordBoxBaseStyle
 
-控件默认样式，该样式不建议直接使用，而是选择继承的方式进行个人控件样式的处理，参考在线资源[PasswordBoxBaseStyle](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Base/PasswordBoxBaseStyle.xaml)
+原生密码框默认样式，不推荐直接使用，应该始终被其它样式以BasedOn的方式使用。
 
-```
-<Style BasedOn="{StaticResource PasswordBoxBaseStyle}" TargetType="PasswordBox"/>
-```
-
-使用
-
-```
-    <PasswordBox PasswordChar="*"
-                 VerticalAlignment="Center"
-                 Width="120"></PasswordBox>
-```
-
-效果
+{% note info no-icon %}
+用例：
+{% code %}
+    <PasswordBox PasswordChar="*" VerticalAlignment="Center" Width="120"></PasswordBox>
+{% endcode %}
 
 ![PasswordBox.BaseStyle](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/native_controls/PasswordBox.BaseStyle.png)
 
-# PasswordBoxExtendBaseStyle
+{% endnote %}
 
-控件拓展基础样式，是样式`PasswordBoxExtend`的基本样式，不建议直接使用，而是选择使用`PasswordBoxExtend`，该样式支持添加`PasswordBox`专用附加属性`PasswordBoxAttach`、额外信息元素`InfoElement`和标题元素`TitleElement`
+# PasswordBoxExtendBaseStyle : PasswordBoxBaseStyle
 
-```
+原生密码框扩展默认样式，不推荐直接使用，应该始终被其它样式以BasedOn的方式使用。
+
+# PasswordBoxExtend : PasswordBoxExtendBaseStyle
+
+相对于原生密码框默认样式，它借助于附加属性可以实现标题、水印的功能。
+
+{% note info no-icon %}
+用例：
+{% code %}
     <!--为使普通密码输入文本框显示水印,需要设定PasswordBoxAttach.PasswordLength="0"-->
     <PasswordBox Style="{DynamicResource PasswordBoxExtend}" PasswordChar="*" 
                  hc:PasswordBoxAttach.PasswordLength="0"
@@ -38,9 +38,8 @@ title: PasswordBox 密码框
                  hc:TitleElement.TitleAlignment="Top"
                  VerticalAlignment="Center"
                  Width="120"></PasswordBox>
-```
-
-效果
+{% endcode %}
 
 ![PasswordBox.ExtendStyle](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/native_controls/PasswordBox.ExtendStyle.png)
 
+{% endnote %}
\ No newline at end of file
diff --git a/doc/source/handycontrol/native_controls/progressBar/index.md b/doc/source/handycontrol/native_controls/progressBar/index.md
index 4e37ca4c..8f5ca2a7 100644
--- a/doc/source/handycontrol/native_controls/progressBar/index.md
+++ b/doc/source/handycontrol/native_controls/progressBar/index.md
@@ -4,30 +4,25 @@ title: ProgressBar 进度条
 
 # ProgressBarBaseStyle
 
-`HandyControl`中自带的默认样式，不建议直接使用而是选择继承的方式，案例如下：
-
-```
-<Style BasedOn="{StaticResource ProgressBarBaseStyle}" TargetType="ProgressBar">
-        <Setter Property="Foreground" Value="{DynamicResource PrimaryBrush}"/>
-</Style>
-```
+进度条默认样式，不推荐直接使用，应该始终被其它样式以BasedOn的方式使用。
 
 # 其他样式
 
 `HandyControl`中自带的其他样式和效果，其中包含如下样式：
 
-| 样式Key            | 用途 |
-| ------------------ | ---- |
-| ProgressBarSuccess | 成功色进度条 |
-| ProgressBarInfo | 提示色进度条 |
-| ProgressBarWarning | 警告色进度条 |
-| ProgressBarDanger | 危险色进度条 |
-| ProgressBarPrimaryStripe | 主题色条纹进度条 |
-| ProgressBarSuccessStripe | 成功色条纹进度条 |
-| ProgressBarInfoStripe | 信息色条纹进度条 |
-| ProgressBarWarningStripe | 警告色条纹进度条 |
-| ProgressBarDangerStripe | 危险色条纹进度条 |
-| ProgressBarFlat | 扁平风格 |
+| 样式Key            | 用途 |父样式|
+| ------------------ | ---- ||
+| ProgressBarSuccess | 成功色进度条 |ProgressBarBaseStyle|
+| ProgressBarInfo | 提示色进度条 |ProgressBarBaseStyle|
+| ProgressBarWarning | 警告色进度条 |ProgressBarBaseStyle|
+| ProgressBarDanger | 危险色进度条 |ProgressBarBaseStyle|
+| ProgressBarStripeBaseStyle | 条纹进度条默认样式（不推荐直接使用） |-|
+| ProgressBarPrimaryStripe | 主题色条纹进度条 |ProgressBarStripeBaseStyle|
+| ProgressBarSuccessStripe | 成功色条纹进度条 |ProgressBarStripeBaseStyle|
+| ProgressBarInfoStripe | 信息色条纹进度条 |ProgressBarStripeBaseStyle|
+| ProgressBarWarningStripe | 警告色条纹进度条 |ProgressBarStripeBaseStyle|
+| ProgressBarDangerStripe | 危险色条纹进度条 |ProgressBarStripeBaseStyle|
+| ProgressBarFlat | 扁平风格 |-|
 
 案例：
 ```xml
@@ -81,5 +76,4 @@ title: ProgressBar 进度条
 
 # 温馨提示
 
-对于进度条进度颜色、圆角以及其他样式的个人使用需求，可查看`HandyControl`开源目中的[源码样式部分](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ProgressBar.xaml)自行定义
-
+对于颜色、圆角或其它自定义需求，可参考[进度条样式源码](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ProgressBar.xaml)自行定义。
\ No newline at end of file