From da5c94bf1a092146a4b9875e8911b70b7807650c Mon Sep 17 00:00:00 2001
From: DinoChan <dino.chan@live.com>
Date: Wed, 1 Apr 2020 09:15:04 +0800
Subject: [PATCH] add passwordbox document

---
 .../extend_controls/passwordBox/index.md      | 85 ++++++++++++++++++-
 1 file changed, 83 insertions(+), 2 deletions(-)

diff --git a/doc/source/handycontrol/extend_controls/passwordBox/index.md b/doc/source/handycontrol/extend_controls/passwordBox/index.md
index ca12ad62..c48a7ee1 100644
--- a/doc/source/handycontrol/extend_controls/passwordBox/index.md
+++ b/doc/source/handycontrol/extend_controls/passwordBox/index.md
@@ -1,5 +1,86 @@
 ---
-title: 建设中
+title: PasswordBox
 ---
 
-建设中
\ No newline at end of file
+表示用于输入和处理密码的控件。
+
+``` CS
+[TemplatePart(Name = ElementPasswordBox, Type = typeof(System.Windows.Controls.PasswordBox))]
+[TemplatePart(Name = ElementTextBox, Type = typeof(System.Windows.Controls.TextBox))]
+public class PasswordBox : Control, IDataInput
+
+```
+
+# PasswordBox
+
+``` XML
+<hc:PasswordBox />
+```
+
+``` CS
+var passwordBox = new PasswordBox();
+```
+
+生成的PasswordBox如下图所示：
+
+![PasswordBox](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/extend_controls/PasswordBox_1.png)
+
+
+
+# 输入密码
+
+可以通过文本框输入密码，也可以在XAML钟或代码中这样设置日期。
+
+``` XML
+<hc:PasswordBox Password="123456"/>
+```
+
+``` CS
+passwordBox.Password = "123456";
+```
+
+# 显示密码
+
+PasswordBox控件可以主动显示已输入的密码。将`ShowEyeButton`设置为`true`，PasswordBox将显示一个“眼睛”的按钮，点击这个按钮即可显示已输入的密码。
+
+<hc:PasswordBox ShowClearButton="True"/>
+
+![PasswordBox](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/extend_controls/PasswordBox_2.gif)
+
+
+# 设置标题和占位符文本
+
+你可以将 Header（标题）和 Placeholder（占位符）添加到PasswordBox，以向用户指示其用途。要使用这两个属性，首先需要应用 **TimePickerExtend** 或 **TimePickerPlus** 样式。
+
+``` XML
+<hc:PasswordBox hc:InfoElement.Placeholder="{x:Static langs:Lang.PlsEnterContent}"
+               hc:InfoElement.Title="{x:Static langs:Lang.TitleDemoStr2}"
+```
+
+
+
+
+# 属性
+
+| 属性             |   描述             |
+| ---------------- | ------------------ |
+| Password      | 获取或设置 PasswordBox 当前保留的密码。 |
+| PasswordChar      | 获取或设置 PasswordBox 的掩码字符。 |
+| ShowEyeButton      | 获取或设置是否显示一个“眼睛”的按钮，点击可以显示密码。 |
+| ShowPassword      | 获取或设置是否显示密码。 |
+| Text      |  	获取由 **TimePicker** 显示的文本，或设置选定的时间 |
+| VerifyFunc        | 获取或设置数据验证委托           |
+| IsError           | 获取或设置数据是否错误           |
+| ErrorStr    | 获取或设置错误提示           |
+| TextType | 获取或设置文本类型       |
+| ShowClearButton | 获取或设置是否显示清除按钮       |
+
+# 方法
+
+| 方法             |  描述              |
+| ---------------- | ------------------ |
+| Clear()    | 清除 Password 属性的值。 |
+| Paste()      | 用剪贴板中的内容替换 PasswordBox 中的当前选定内容。 |
+| SelectAll()     | 选择 PasswordBox 中的全部内容。 |
+| VerifyData()      | 验证数据。 |
+