背水一战 Windows 10 (28)

zeromax

　　[源码下载]




背水一战 Windows 10 (28) - 控件（文本类）: TextBox, PasswordBox　　
作者：webabcd

介绍
背水一战 Windows 10 之 控件（文本类）

• TextBox
  
• PasswordBox
  

　　
示例
1、TextBox 的示例 1
Controls/TextControl/TextBoxDemo1.xaml



<Page
x:Class="Windows10.Controls.TextControl.TextBoxDemo1"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:Windows10.Controls.TextControl"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d">
<Grid Background="Transparent">
<StackPanel Margin="10 0 10 10">
<!--
TextBox - 文本输入框
Text - 文本值
Header - 可以设置一个纯文本，不能命中测试，空 Header 的话不会占用任何空间
HeaderTemplate - 可以将 Header 设置为任何 xaml，且支持命中测试
MaxLength - 最大字符数（默认是 0 代表无限制）
PlaceholderText - 占位符水印
AcceptsReturn - 是否允许输入和显示回车符和换行符
IsSpellCheckEnabled - 是否开启拼写检查功能
IsTextPredictionEnabled - 是否开启输入预测功能
DesiredCandidateWindowAlignment - IME 的对齐方式（IME - Input Method Editor; SIP - Soft Input Panel）
Default - 当使用硬键盘时，IME 会随着光标移动；当使用软键盘时，IME 停靠于 SIP
BottomEdge - 当使用硬键盘时，IME 会与文本编辑控件的底部边缘和左侧对齐（经测试仅微软输入法有效，也许是第三方输入法没有实现某个接口）；当使用软键盘时，IME 停靠于 SIP
-->
<TextBox Name="textBox1" Margin="5" Height="100"
Header="文本框"
PlaceholderText="enter your text"
MaxLength="32"
TextWrapping="Wrap"
AcceptsReturn="True"
IsSpellCheckEnabled="False"
IsTextPredictionEnabled="True"
DesiredCandidateWindowAlignment="Default" />
<TextBox Name="textBox2" Margin="5"
Text="textBox2"
TextAlignment="Center"
IsReadOnly ="True">
<TextBox.HeaderTemplate>
<DataTemplate>
<TextBlock Text="文本框" Foreground="Red" />
</DataTemplate>
</TextBox.HeaderTemplate>
</TextBox>

<!--
InputScope - 指定 SIP（Soft Input Panel）的类型
-->
<TextBox Name="textBox3" Margin="5" InputScope="Number" />
<!--
在 CodeBehind 端设置此 TextBox 的 InputScope
-->
<TextBox Name="textBox4" Margin="5" />

<!--
TextWrapping - 换行方式
NoWrap - 不换行
Wrap - 换行，必要时可截断单词
WrapWholeWords - 换行，但是绝不截断单词，即使单词可能会显示不全（经测试无效，TextBlock 是支持的）
-->
<TextBox Width="100" HorizontalAlignment="Left" Text="abcdefghijklmnopq www" Margin="5" TextWrapping="NoWrap" />
<TextBox Width="100" HorizontalAlignment="Left" Text="abcdefghijklmnopq www" Margin="5" TextWrapping="Wrap" />

<!--
TextAlignment - 文本的水平对齐方式
Center, Left（默认值）, Right, Justify（两端对齐，经测试无效，TextBlock 是支持的）
-->
<TextBox Text="i am a &quot;TextBlock&quot;" Margin="5" TextAlignment="Right" />
</StackPanel>
</Grid>
</Page>
　　Controls/TextControl/TextBoxDemo1.xaml.cs



/*
* TextBox - 文本输入框（继承自 Control, 请参见 /Controls/BaseControl/ControlDemo/）
*/
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Input;
namespace Windows10.Controls.TextControl
{
public sealed partial class TextBoxDemo1 : Page
{
public TextBoxDemo1()
{
this.InitializeComponent();
this.Loaded += TextBoxDemo1_Loaded;
}
private void TextBoxDemo1_Loaded(object sender, RoutedEventArgs e)
{
// 在 CodeBehind 端设置 TextBox 的 InputScope
InputScope scope = new InputScope();
InputScopeName name = new InputScopeName();
name.NameValue = InputScopeNameValue.ChineseFullWidth;
scope.Names.Add(name);
textBox4.InputScope = scope;
}
}
}
　　
2、TextBox 的示例 2
Controls/TextControl/TextBoxDemo2.xaml



<Page
x:Class="Windows10.Controls.TextControl.TextBoxDemo2"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:Windows10.Controls.TextControl"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d">
<Grid Background="Transparent">
<StackPanel Margin="10 0 10 10">
<!--用于显示 Segoe UI Emoji 字符-->
<TextBox Name="textBox1" Margin="5" TextWrapping="Wrap" />
<TextBox Name="textBox2" Margin="5" />
<TextBlock Name="textBlock2" Margin="5" />
<TextBox Name="textBox3" Margin="5" />
<ScrollViewer Margin="5" Height="300">
<TextBlock Name="textBlock3" />
</ScrollViewer>
</StackPanel>
</Grid>
</Page>
　　Controls/TextControl/TextBoxDemo2.xaml.cs



/*
* TextBox - 文本输入框（继承自 Control, 请参见 /Controls/BaseControl/ControlDemo/）
*     IsColorFontEnabled - 是否以彩色方式显示 Segoe UI Emoji 之类的字符（默认值是 true）
*     SelectAll() - 选中全部内容（先要获取焦点后，才能做这个操作）
*     Select(int start, int length) - 选中指定范围的内容（先要获取焦点后，才能做这个操作）
*     SelectedText - 选中的内容
*     SelectionStart - 选中内容的起始位置
*     SelectionLength - 选中内容的字符数
*     SelectionHighlightColor - 选中文本的颜色
*     PreventKeyboardDisplayOnProgrammaticFocus - 通过 FocusState.Programmatic 让 TextBox 获取焦点时，是否不显示软键盘
*     GetLinguisticAlternativesAsync() - 获取输入法编辑器 (IME) 窗口中的候选词列表（经测试仅微软输入法有效，也许是第三方输入法没有实现某个接口）
*     GetRectFromCharacterIndex(int charIndex, bool trailingEdge) - 获取指定字符的边缘位置的 Rect 对象
*         charIndex - 字符的位置
*         trailingEdge - false 代表前边缘（左边缘），true 代表后边缘（右边缘）
*
*     TextBox 的相关事件的说明详见代码部分的注释
*/
using System;
using System.Text;
using Windows.UI;
using Windows.UI.Popups;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Media;
namespace Windows10.Controls.TextControl
{
public sealed partial class TextBoxDemo2 : Page
{
public TextBoxDemo2()
{
this.InitializeComponent();
this.Loaded += TextBoxDemo2_Loaded;
}
private void TextBoxDemo2_Loaded(object sender, RoutedEventArgs e)
{
// 显示 Segoe UI Emoji 字符
StringBuilder strContect = new StringBuilder();
for (int code = 0x1F600; code < 0x1F6C6; code++)
{
strContect.Append(char.ConvertFromUtf32(code));
}
// 是否以彩色方式显示 Segoe UI Emoji 之类的字符（默认值是 true）
textBox1.IsColorFontEnabled = true;
textBox1.Text = strContect.ToString();

textBox2.Text = "123456";
// 当通过 FocusState.Programmatic 让 textBox2 获取焦点时，不显示软键盘
textBox2.PreventKeyboardDisplayOnProgrammaticFocus = true;
// 通过 FocusState.Programmatic 让 textBox2 获取焦点
            textBox2.Focus(FocusState.Programmatic);
// 获取焦点后，才能 Select() 或 SelectAll()
textBox2.Select(1, 4); // SelectAll() - 选中全部
textBox2.SelectionHighlightColor = new SolidColorBrush(Colors.Orange);
textBlock2.Text = "SelectedText: " + textBox2.SelectedText;
textBlock2.Text += Environment.NewLine;
textBlock2.Text += "SelectionStart: " + textBox2.SelectionStart;
textBlock2.Text += Environment.NewLine;
textBlock2.Text += "SelectionLength: " + textBox2.SelectionLength;
textBlock2.Text += Environment.NewLine;
// 获取第 1 个字符的左边缘的 Rect 对象
textBlock2.Text += "GetRectFromCharacterIndex(0, false): " + textBox2.GetRectFromCharacterIndex(0, false).ToString();
textBlock2.Text += Environment.NewLine;
// 获取第 1 个字符的右边缘的 Rect 对象
textBlock2.Text += "GetRectFromCharacterIndex(0, true): " + textBox2.GetRectFromCharacterIndex(0, true).ToString();

// TextBox 的相关事件的说明及演示如下
// 当文本发生变化时触发的事件
textBox3.TextChanging += TextBox3_TextChanging;
// 当文本发生变化后触发的事件
textBox3.TextChanged += TextBox3_TextChanged;
// 选中的文本发生变化后触发的事件
textBox3.SelectionChanged += TextBox3_SelectionChanged;
// 在 TextBox 中做粘贴操作时触发的事件
textBox3.Paste += TextBox3_Paste;
// 在 TextBox 中打开上下文菜单时触发的事件（触摸屏长按或鼠标右键）
textBox3.ContextMenuOpening += TextBox3_ContextMenuOpening;
// 在打开、更新或关闭输入法编辑器 (IME) 窗口时触发的事件（经测试仅微软输入法有效，也许是第三方输入法没有实现某个接口）
textBox3.CandidateWindowBoundsChanged += TextBox3_CandidateWindowBoundsChanged;
// 当通过输入方法编辑器 (IME) 组成的文本出现变化时触发的事件
textBox3.TextCompositionChanged += TextBox3_TextCompositionChanged;
// 当用户开始通过输入方法编辑器 (IME) 组成文本时触发的事件
textBox3.TextCompositionStarted += TextBox3_TextCompositionStarted;
// 当用户停止通过输入方法编辑器 (IME) 组成文本时触发的事件
textBox3.TextCompositionEnded += TextBox3_TextCompositionEnded;
}
private void TextBox3_TextChanging(TextBox sender, TextBoxTextChangingEventArgs args)
{
textBlock3.Text += "TextChanging: " + textBox3.Text;
textBlock3.Text += Environment.NewLine;
}
private void TextBox3_TextChanged(object sender, TextChangedEventArgs e)
{
textBlock3.Text += "TextChanged: " + textBox3.Text;
textBlock3.Text += Environment.NewLine;
}
private void TextBox3_SelectionChanged(object sender, RoutedEventArgs e)
{
textBlock3.Text += "SelectionChanged: " + textBox3.SelectedText;
textBlock3.Text += Environment.NewLine;
}
private async void TextBox3_Paste(object sender, TextControlPasteEventArgs e)
{
await new MessageDialog("禁用粘贴").ShowAsync();
// 将路由事件设置为已处理，从而禁用粘贴功能
e.Handled = true;
}
private void TextBox3_ContextMenuOpening(object sender, ContextMenuEventArgs e)
{
textBlock3.Text += "ContextMenuOpening";
textBlock3.Text += Environment.NewLine;
}
private void TextBox3_CandidateWindowBoundsChanged(TextBox sender, CandidateWindowBoundsChangedEventArgs args)
{
// CandidateWindowBoundsChangedEventArgs.Bounds - 获取 IME 窗口的 Rect 对象
textBlock3.Text += "CandidateWindowBoundsChanged: " + args.Bounds.ToString();
textBlock3.Text += Environment.NewLine;
}
private async void TextBox3_TextCompositionChanged(TextBox sender, TextCompositionChangedEventArgs args)
{
// TextCompositionChangedEventArgs.StartIndex - 通过 IME 组成的文本的起始位置
// TextCompositionChangedEventArgs.Length - 通过 IME 组成的文本的长度
textBlock3.Text += $"TextCompositionChanged StartIndex:{args.StartIndex}, Length:{args.Length}";
textBlock3.Text += Environment.NewLine;

// GetLinguisticAlternativesAsync() - 获取输入法编辑器 (IME) 窗口中的候选词列表（经测试仅微软输入法有效，也许是第三方输入法没有实现某个接口）
var candidateWords = await textBox3.GetLinguisticAlternativesAsync();
textBlock3.Text += "candidate words: " + string.Join(",", candidateWords); ;
textBlock3.Text += Environment.NewLine;
}
private void TextBox3_TextCompositionStarted(TextBox sender, TextCompositionStartedEventArgs args)
{
// TextCompositionStartedEventArgs.StartIndex - 通过 IME 组成的文本的起始位置
// TextCompositionStartedEventArgs.Length - 通过 IME 组成的文本的长度
textBlock3.Text += $"TextCompositionStarted StartIndex:{args.StartIndex}, Length:{args.Length}";
textBlock3.Text += Environment.NewLine;
}
private void TextBox3_TextCompositionEnded(TextBox sender, TextCompositionEndedEventArgs args)
{
// TextCompositionEndedEventArgs.StartIndex - 通过 IME 组成的文本的起始位置
// TextCompositionEndedEventArgs.Length - 通过 IME 组成的文本的长度
textBlock3.Text += $"TextCompositionEnded StartIndex:{args.StartIndex}, Length:{args.Length}";
textBlock3.Text += Environment.NewLine;
}
}
}
　　
3、PasswordBox 的示例
Controls/TextControl/PasswordBoxDemo.xaml



<Page
x:Class="Windows10.Controls.TextControl.PasswordBoxDemo"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:Windows10.Controls.TextControl"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d">
<Grid Background="Transparent">
<StackPanel Margin="10 0 10 10">
<!--
PasswordBox - 密码输入框
Password - 密码值
PasswordChar - 密码框所显示显示的密码替代字符。默认值为“●”
IsPasswordRevealButtonEnabled - 是否显示“显示密码明文”按钮（弃用了）
PasswordRevealMode - 密码显示方式
Peek - 密文显示，按下“显示密码明文”按钮时显示明文（默认值）
Hidden - 密文显示，“显示密码明文”按钮不可见
Visible - 明文显示，“显示密码明文”按钮不可见
Header - 可以设置一个纯文本，不能命中测试，空 Header 的话不会占用任何空间
HeaderTemplate - 可以将 Header 设置为任何 xaml，且支持命中测试
MaxLength - 最大字符数（默认是 0 代表无限制）
PlaceholderText - 占位符水印
-->
<PasswordBox Name="passwordBox1" Width="200" Margin="5" HorizontalAlignment="Left"
Header="密码"
PlaceholderText="enter your password"
MaxLength="6"
PasswordChar="@"
PasswordRevealMode="Peek" />

<PasswordBox Name="passwordBox2" Width="200" Margin="5" HorizontalAlignment="Left">
<PasswordBox.HeaderTemplate>
<DataTemplate>
<TextBlock Text="密码" Foreground="Red" />
</DataTemplate>
</PasswordBox.HeaderTemplate>
</PasswordBox>
<TextBlock Name="textBlock" Margin="5" />
</StackPanel>
</Grid>
</Page>
　　Controls/TextControl/PasswordBoxDemo.xaml.cs



/*
* PasswordBox - 密码输入框（继承自 Control, 请参见 /Controls/BaseControl/ControlDemo/）
*     Password - 密码值
*     SelectAll() - 选中 PasswordBox 中的所有字符（先要获取焦点后，才能做这个操作）
*     SelectionHighlightColor - 选中文本的颜色
*     PreventKeyboardDisplayOnProgrammaticFocus - 通过 FocusState.Programmatic 让 PasswordBox 获取焦点时，是否不显示软键盘
*     PasswordChanged - Password 属性值发生变化时触发的事件
*     Paste - 在 PasswordBox 中做粘贴操作时触发的事件
*     ContextMenuOpening - 在 PasswordBox 中打开上下文菜单时触发的事件（触摸屏长按或鼠标右键）
*/
using System;
using Windows.UI;
using Windows.UI.Popups;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Media;
namespace Windows10.Controls.TextControl
{
public sealed partial class PasswordBoxDemo : Page
{
public PasswordBoxDemo()
{
this.InitializeComponent();
this.Loaded += PasswordBoxDemo_Loaded;
}
private void PasswordBoxDemo_Loaded(object sender, RoutedEventArgs e)
{
passwordBox2.Password = "123456";
// 当通过 FocusState.Programmatic 让 passwordBox2 获取焦点时，不显示软键盘
passwordBox2.PreventKeyboardDisplayOnProgrammaticFocus = true;
// 通过 FocusState.Programmatic 让 passwordBox2 获取焦点
            passwordBox2.Focus(FocusState.Programmatic);
passwordBox2.SelectAll(); // 先要获取焦点后，才能做这个操作
passwordBox2.SelectionHighlightColor = new SolidColorBrush(Colors.Orange);
passwordBox2.PasswordChanged += (x, y) =>
{
textBlock.Text = passwordBox2.Password;
};
passwordBox2.Paste += async (x, y) =>
{
await new MessageDialog("禁用粘贴").ShowAsync();
// 将路由事件设置为已处理，从而禁用粘贴功能
y.Handled = true;
};
passwordBox2.ContextMenuOpening += (x, y) =>
{
// 触发条件：触摸屏长按或鼠标右键
            };
}
}
}
　　
OK
[源码下载]