update doc

2019-10-30 19:54:13 +08:00
1 parent cfe20a7f13
commit d15dda019a
@@ -2,14 +2,18 @@
 title: 欢迎来到HandyOrg
 ---

+# 关于我们
+
 HandyOrg的宗旨是为用户提供最简单的API。

-我们一直期待着有更多的同学加入。
+我们一直期待有更多的同学加入。

-我们的入坑要求：
+# 入坑要求
 - 热爱编码
 - 接受目前Handy的代码风格，并尽量遵守
 - 项目名必须以Handy为前缀
 - 活着

-我们的QQ群：714704041
+# 参与讨论
+
+[![qq-group](https://img.shields.io/badge/qq-714704041-red.svg)](//shang.qq.com/wpa/qunwpa?idkey=a571e5553c9d41e49c4f22f3a8b2865451497a795ff281fedf3285def247efc1) [![qq-group](https://img.shields.io/badge/qq-858784803-red.svg)](//shang.qq.com/wpa/qunwpa?idkey=5c18622a0f6ee07a6f33afa8cdb85b1f72ea50e878271dfcec919c76b55afee7)
@@ -2,15 +2,7 @@
 title: BackgroundSwitchElement 可切换背景的元素
 ---

-# 准备工作
-
-添加`HandyControl`命名空间
-
-```xml
-xmlns:hc="https://handyorg.github.io/handycontrol"
-```
-
-# 相关属性
+# 属性

 | 名称 | 用途 |
 |-|-|
@@ -2,15 +2,7 @@
 title: BorderElement 具有边框的元素
 ---

-# 准备工作
-
-添加`HandyControl`命名空间
-
-```xml
-xmlns:hc="https://handyorg.github.io/handycontrol"
-```
-
-# 相关属性
+# 属性

 | 名称 | 用途 |
 |-|-|
@@ -22,13 +14,13 @@ xmlns:hc="https://handyorg.github.io/handycontrol"
 ## CornerRadius 设置边框圆角值

 ```xml
-<Button Content="[Button]测试CornerRadius" hc:BorderElement.CornerRadius="0"></Button>
-<hc:TextBox Text="[hc:TextBox]测试CornerRadius" hc:BorderElement.CornerRadius="15"></hc:TextBox>
-<TextBox Text="[TextBox]测试CornerRadius" hc:BorderElement.CornerRadius="0"></TextBox>
-<Button Content="[Button]测试CornerRadius" hc:BorderElement.CornerRadius="0,0,4,4"></Button>
+<StackPanel Width="200" VerticalAlignment="Center">
+    <Button Content="Button" hc:BorderElement.CornerRadius="15" HorizontalAlignment="Stretch"/>
+    <TextBox Text="TextBox" hc:BorderElement.CornerRadius="15" Margin="0,10,0,0"/>
+</StackPanel>
 ```

-![CorberRadius_Case_01](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/attach\borderelment_case_01.png)
+![BorderElement.CornerRadius](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/attach\BorderElement.CornerRadius.png)

 ## Circular 是否呈现为圆形

@@ -36,40 +28,4 @@ xmlns:hc="https://handyorg.github.io/handycontrol"
 ```xml
 <Border Style="{StaticResource BorderCircular}" Background="OrangeRed" Width="100" Height="100"/>
 ```
-![borderElement_Case_02](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/attach\borderElement_Case_02.png)
-
-# 温馨提示
-
-## 常见控件支持项
-
-**所属**  是指该控件为`WPF默认`控件还是为`HandControl自定义`实现的控件
-**适用属性 ** 为当前控件`BorderElement`对应有效的附加属性
-
-| 控件类型 | 所属                  | 适用属性     |
-| -------- | --------------------- | ------------ |
-|Button   | WPF默认               | CornerRadius |
-|DatePicker|WPF默认|  CornerRadius|
-|ProgressBar| WPF默认|CornerRadus|
-|RadioButton|WPF默认|CornerRadus|
-|ToggleButton|WPF默认|CornerRadus|
-|RepeatButton|WPF默认|CornerRadus|
-|ToolBar|WPF默认|CornerRadus|
-|**Border**|WPF默认|**Circular**|
-|GroupBox|WPF默认(部分Style)|CornerRadus|
-|TextBox  | WPF默认、HandyControl | CornerRadius |
-|PasswordBox| WPF默认、HandyControl|CornerRadus|
-|ComboBox| WPF默认、HandyControl|CornerRadus|
-|DateTimePicker|HandyControl|CornerRadus|
-|GotoTop|HandyControl|CornerRadus|
-|Gravatar|HandyControl|CornerRadus|
-|NumericUpDown|HandyControl|CornerRadus|
-|ProgressButton| HandyControl|CornerRadus|
-|RunningBlock|HandyControl|CornerRadus|
-|SearchBar|HandyControl|CornerRadus|
-|SplitButton|HandyControl|CornerRadus|
-|TabItem|HandyControl|CornerRadus|
-|Growl|HandyControl|CornerRadus|
-|Shield|HandyControl|CornerRadus(暂时无效)|
-|Tag|HandyControl|CornerRadus(暂时无效)|
-
-
+![BorderElement.Circular](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/attach\BorderElement.Circular.png)
@@ -1,5 +1,16 @@
 ---
-title: 建设中
+title: DataGridAttach DataGrid专用
 ---

-建设中
+# 属性
+
+| 名称 | 用途 |
+|-|-|
+| ApplyDefaultStyle | 是否应用默认样式 |
+| TextColumnStyle | 文本列样式 |
+| EditingTextColumnStyle | 编辑时文本列样式 |
+| ComboBoxColumnStyle | 组合框列样式 |
+| EditingComboBoxColumnStyle | 编辑时组合框列样式 |
+| CheckBoxColumnStyle | 复选框列样式 |
+| EditingCheckBoxColumnStyle | 编辑时复选框列样式 |
+| ShowRowNumber | 是否显示行号 |
@@ -1,5 +1,13 @@
 ---
-title: 建设中
+title: EdgeElement 具有边界内容的元素
 ---

-建设中
+# 属性
+
+| 名称 | 用途 |
+|-|-|
+| LeftContent | 左侧边界内容 |
+| TopContent | 顶部边界内容 |
+| RightContent | 右侧边界内容 |
+| BottomContent | 底部边界内容 |
+| ShowEdgeContent | 是否显示边界内容 |
@@ -1,5 +1,24 @@
 ---
-title: 建设中
+title: IconElement 具有图标的元素
 ---

-建设中
+# 属性
+
+| 名称 | 用途 |
+|-|-|
+| Geometry | 几何形状 |
+| Width | 图标宽度 |
+| Height | 图标高度 |
+
+# 使用案例
+
+## Geometry 几何形状
+
+```xml
+<StackPanel Width="200" VerticalAlignment="Center">
+    <Button Content="Button" HorizontalAlignment="Stretch"/>
+    <Button Content="Button" hc:IconElement.Geometry="{StaticResource CalendarGeometry}" HorizontalAlignment="Stretch" Margin="0,10,0,0"/>
+</StackPanel>
+```
+
+![IconElement.Geometry](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/attach\IconElement.Geometry.png)
@@ -79,7 +79,5 @@ Controls中的每个控件一般都能在Themes中找到对应的xaml定义。
 编译前请确认你的开发环境是否符合要求。
 {% endnote %}

-{% note info %}
 打开HandyControl.sln，在解决方案配置下拉框中选择指定的环境进行编译：
-![Build_Config](images/Build_Config.png)
-{% endnote %}
+![Build_Config](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/Build_Config.png)
@@ -4,7 +4,7 @@ title: 国际化

 # 使用方式

-可通过`ConfigHelper.Instance.SetLang(string lang)`指定需要使用的语言包，默认使用zh-cn。
+可通过`ConfigHelper.Instance.SetLang(string lang)`指定需要使用的语言包，默认使用简体中文（zh-cn）。

 控件库自带的语言包一般为控件库内部使用，但用户也可以通过以下两种方式使用：

@@ -21,9 +21,9 @@ title: 国际化

 # 扩展

-控件库自带zh-cn和en两份语言包，默认为zh-cn：
+控件库自带的语言包包括简体中文（zh-cn）、英文（en）、波斯语（fa）、法语（fr），默认为简体中文（zh-cn）：

-![Langs](images/Langs.png)
+![Langs](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/langs/Langs.png)

 如果需要可自行扩展，这里推荐使用开源插件：[ResXManager](https://marketplace.visualstudio.com/items?itemName=TomEnglert.ResXManager)，来维护所有的语言包。

@@ -180,7 +180,7 @@ menu:
      BackgroundSwitchElement 可切换背景的元素: /backgroundSwitchElement/ ||
      BorderElement 具有边框的元素: /borderElement/ ||
      DataGridAttach DataGrid专用: /dataGridAttach/ ||
-      EdgeElement: /edgeElement/ ||
+      EdgeElement 具有边界内容的元素: /edgeElement/ ||
      IconElement 具有图标的元素: /iconElement/ ||
      IconSwitchElement 可切换图标的元素: /iconSwitchElement/ ||
      InfoElement 信息元素: /infoElement/ ||
@@ -319,10 +319,12 @@ site_state: false
 social:
  GitHub: https://github.com/HandyOrg || github
  E-Mail: mailto:handycontrol@qq.com || envelope
-  QQ: //shang.qq.com/wpa/qunwpa?idkey=a571e5553c9d41e49c4f22f3a8b2865451497a795ff281fedf3285def247efc1 || qq
+  QQ群1: //shang.qq.com/wpa/qunwpa?idkey=a571e5553c9d41e49c4f22f3a8b2865451497a795ff281fedf3285def247efc1 || qq
+  QQ群2: //shang.qq.com/wpa/qunwpa?idkey=5c18622a0f6ee07a6f33afa8cdb85b1f72ea50e878271dfcec919c76b55afee7 || qq
  Nuget: https://www.nuget.org/packages/HandyControl || code
  Gitter: https://gitter.im/HandyControl/Lobby || commenting
  Wiki-en: https://github.com/ghost1372/HandyControl/wiki || book
+  Wiki-fr: https://github.com/TheKeytrap/HandyControl/wiki || book

 social_icons:
  enable: true
@@ -8,4 +8,15 @@
 .post-body h2 {
    font-size: 1.45em;
    border-bottom: 0px solid #eee;
+}
+
+a, span.exturl {
+    overflow-wrap: break-word;
+    word-wrap: break-word;
+    background-color: transparent;
+    color: #555;
+    text-decoration: none;
+    outline: none;
+    border-bottom: 0px solid #999;
+    cursor: pointer;
 }