diff --git a/doc/source/handycontrol/extend_controls/blurWindow/index.md b/doc/source/handycontrol/extend_controls/blurWindow/index.md deleted file mode 100644 index ca12ad62..00000000 --- a/doc/source/handycontrol/extend_controls/blurWindow/index.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: 建设中 ---- - -建设中 \ No newline at end of file diff --git a/doc/source/handycontrol/extend_controls/clock/index.md b/doc/source/handycontrol/extend_controls/clock/index.md index ca12ad62..89fc1253 100644 --- a/doc/source/handycontrol/extend_controls/clock/index.md +++ b/doc/source/handycontrol/extend_controls/clock/index.md @@ -1,5 +1,57 @@ --- -title: 建设中 +title: Clock 时钟 --- -建设中 \ No newline at end of file +Clock 控件展示一个虚拟的时钟,允许用户在这个时钟上选择时间。 + +``` CS +[TemplatePart(Name = ElementButtonAm, Type = typeof(RadioButton))] +[TemplatePart(Name = ElementButtonPm, Type = typeof(RadioButton))] +[TemplatePart(Name = ElementCanvas, Type = typeof(Canvas))] +[TemplatePart(Name = ElementBorderTitle, Type = typeof(Border))] +[TemplatePart(Name = ElementBorderClock, Type = typeof(Border))] +[TemplatePart(Name = ElementPanelNum, Type = typeof(CirclePanel))] +[TemplatePart(Name = ElementTimeStr, Type = typeof(TextBlock))] +public class Clock : ClockBase +``` + +# 创建Clock + +``` XML + +``` + +``` CS +var clock = new Clock(); +``` + +生成的Clock如下图所示: + +![Clock](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/extend_controls/Clock_1.png) + +# 选择时间 + +可以通过点击左边的时钟,或者点击右边的时分秒列表选择时间。也可以在XAML钟或代码中这样设置日期。 + +``` XML + +``` + +``` CS +clock.SelectedTime = DateTime.Now; +``` + +# 属性 + +| 属性 | 描述 | +| ---------------- | ------------------ | +| SelectedTime | 获取或设置当前选中的时间。 | +| DisplayTime | 获取或设置当前的显示时间。 | +| TimeFormat | 获取或设置用于显示选定的时间的格式 | +| ClockRadioButtonStyle | 获取或设置Clock控件中RadioButton的样式 | + +# 事件 + +| 事件 | 描述 | +| ---------------- | ------------------ | +| DisplayTimeChanged | 当显示的时间改变时发生。 | diff --git a/doc/source/handycontrol/extend_controls/index.md b/doc/source/handycontrol/extend_controls/index.md index ca12ad62..772e7310 100644 --- a/doc/source/handycontrol/extend_controls/index.md +++ b/doc/source/handycontrol/extend_controls/index.md @@ -1,5 +1,5 @@ --- -title: 建设中 +title: 扩展控件 --- -建设中 \ No newline at end of file +HandyControl目前包含70余款扩展控件,正逐步增加。 \ No newline at end of file diff --git a/doc/source/handycontrol/extend_controls/passwordBox/index.md b/doc/source/handycontrol/extend_controls/passwordBox/index.md index ca12ad62..3eeb5705 100644 --- a/doc/source/handycontrol/extend_controls/passwordBox/index.md +++ b/doc/source/handycontrol/extend_controls/passwordBox/index.md @@ -1,5 +1,77 @@ --- -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 + +``` + +``` CS +var passwordBox = new PasswordBox(); +``` + +# 输入密码 + +可以通过文本框输入密码,也可以在XAML钟或代码中这样设置日期。 + +``` XML + +``` + +``` CS +passwordBox.Password = "123456"; +``` + +# 显示密码 + +PasswordBox控件可以主动显示已输入的密码。将`ShowEyeButton`设置为`true`,PasswordBox将显示一个“眼睛”的按钮,点击这个按钮即可显示已输入的密码。 + +``` XML + +``` + +![PasswordBox](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/extend_controls/PasswordBox_2.gif) + + +# 设置标题和占位符文本 + +你可以将 Header(标题)和 Placeholder(占位符)添加到PasswordBox,以向用户指示其用途。 + +``` XML + +``` + +``` CS +var textBox = new TextBox(); +``` + +# 输入文本 + +此示例演示如何使用 Text 属性设置 TextBox 控件的初始文本内容: + +``` XML + +``` + +``` CS +textBox.Text = "这是内容"; +``` + +生成的TextBox如下图所示: + +![TextBox](https://raw.githubusercontent.com/HandyOrg/HandyOrgResource/master/HandyControl/Doc/extend_controls/TextBox_1.png) + + +有关TextBox的更多示例,可以参考它的基类的[文档](https://docs.microsoft.com/zh-cn/dotnet/api/system.windows.controls.textbox?view=netframework-4.8)。 + + +# 设置标题和占位符文本 + +你可以将 Header(标题)和 Placeholder(占位符)添加到TextBox,以向用户指示其用途。要使用这两个属性, + +``` XML + e) => RaiseEvent(e); + protected virtual void OnValueChanged(FunctionEventArgs e) + { + RaiseEvent(e); + UpdateItems(); + } public static readonly DependencyProperty TextProperty = DependencyProperty.Register( "Text", typeof(string), typeof(Rate), new PropertyMetadata(default(string)));