条目

2023-08-28 07:35| 来源: 网络整理| 查看: 265

条目项目 05/05/2023

.NET 多平台应用 UI (.NET MAUI) Entry 允许输入和编辑单行文本。此外， Entry 可用作密码字段。

Entry 定义以下属性:

CharacterSpacing，属于类型 double，设置所输入文本中字符之间的间距。 ClearButtonVisibility，属于类型 ClearButtonVisibility，控制是否显示清除按钮，使用户能够清除文本。此属性的默认值可确保不显示清除按钮。 CursorPosition，属于类型 int，定义游标在条目中的位置。 FontAttributes，属于类型 FontAttributes，确定文本样式。 FontAutoScalingEnabled类型 bool为，定义文本是否反映操作系统中设置的缩放首选项。此属性的默认值为 true。 FontFamily，属于类型 string，定义字体系列。 FontSize，属于类型 double，定义字号。 Keyboard类型 Keyboard为，指定输入文本时显示的虚拟键盘。 HorizontalTextAlignment，属于类型 TextAlignment，定义文本的水平对齐方式。 IsPassword，属于类型 bool，指定条目是否应直观地遮挡类型化文本。 IsTextPredictionEnabled，属于类型 bool，控制是否启用文本预测和自动文本更正。 Placeholder类型 string为的定义控件为空时显示的文本。 PlaceholderColor，属于类型 Color，定义占位符文本的颜色。 ReturnCommand类型 ICommand为，定义在按下返回键时要执行的命令。 ReturnCommandParameter，属于类型 object，指定的参数 ReturnCommand。 ReturnType，属于类型 ReturnType，指定返回按钮的外观。 SelectionLength，属于类型 int，表示条目中所选文本的长度。 Text类型 string为，定义输入到条目中的文本。 TextColor，属于类型 Color，定义输入的文本的颜色。 VerticalTextAlignment，属于类型 TextAlignment，定义文本的垂直对齐方式。

这些属性由 BindableProperty 对象提供支持；也就是说，它们可以作为数据绑定的目标，并能进行样式设置。

此外， Entry 定义一个 Completed 事件，当用户使用返回键在中 Entry 完成文本时引发该事件。

Entry 派生自 InputView 类，它从中继承以下属性：

IsReadOnly类型的 bool定义是否应阻止用户修改文本。此属性的默认值为 false。 IsSpellCheckEnabled，属于类型 bool，控制是否启用拼写检查。 MaxLength类型 int为，定义最大输入长度。 TextTransform，属于类型 TextTransform，指定所输入文本的大小写。

这些属性由 BindableProperty 对象提供支持；也就是说，它们可以作为数据绑定的目标，并能进行样式设置。

此外， InputView 定义一个 TextChanged 事件，该事件在中的 Entry 文本更改时引发。 TextChangedEventArgs事件附带TextChanged的对象具有 NewTextValue 和 OldTextValue 属性，分别指定新文本和旧文本。

有关在上 Entry指定字体的信息，请参阅字体。

创建条目

以下示例演示如何创建 Entry：

等效 C# 代码如下：

Entry entry = new Entry { Placeholder = "Enter text" }; entry.TextChanged += OnEntryTextChanged; entry.Completed += OnEntryCompleted;

以下屏幕截图显示了 Android 上的结果 Entry ：

可以通过读取 Text 属性来访问输入的文本，并且 TextChanged 和 Completed 事件表示文本已更改或已完成。

当 TextChanged 中的 Entry 文本发生更改时，将引发事件，并且 TextChangedEventArgs 通过 OldTextValue 和 NewTextValue 属性提供更改前后的文本：

void OnEntryTextChanged(object sender, TextChangedEventArgs e) { string oldText = e.OldTextValue; string newText = e.NewTextValue; string myText = entry.Text; }

Completed当用户通过按键盘上的返回键或在 Windows 上按 Tab 键结束输入时，将引发该事件。事件的处理程序是泛型事件处理程序：

void OnEntryCompleted(object sender, EventArgs e) { string text = ((Entry)sender).Text; }

事件Completed触发后，将执行由属性指定ReturnCommand的任何 ICommand ，由 object 属性指定的 ReturnCommandParameter 将传递给 ReturnCommand。

注意

VisualElement继承层次结构中的 Entry 类还具有 Focused 和 Unfocused 事件。

设置字符间距

通过将属性设置为CharacterSpacing值，可以将字符间距应用于：Entrydouble

结果是，显示 Entry 的文本中的字符是分隔 CharacterSpacing 的与设备无关的单位。

注意

属性值CharacterSpacing应用于和 Placeholder 属性显示Text的文本。

限制输入长度

属性 MaxLength 可用于限制允许的 Entry输入长度。此属性应设置为正整数：

MaxLength属性值为 0 表示不允许输入，而值为 int.MaxValue（即的Entry默认值）指示可以输入的字符数没有有效限制。

设置光标位置和文本选择长度

属性 CursorPosition 可用于返回或设置将下一个字符插入属性中 Text 存储的字符串的位置：

属性的 CursorPosition 默认值为 0，指示将在的 Entry开头插入文本。

此外， SelectionLength 属性可用于返回或设置中 Entry文本选择的长度：

属性的 SelectionLength 默认值为 0，表示未选择任何文本。

显示清除按钮

属性 ClearButtonVisibility 可用于控制是否 Entry 显示清除按钮，使用户能够清除文本。应将此属性设置为 ClearButtonVisibility 枚举成员：

Never 指示永远不会显示清除按钮。这是 ClearButtonVisibility 属性的默认值。 WhileEditing 指示在具有焦点和文本时，清除按钮将显示在中 Entry。

以下示例演示如何设置属性：

以下屏幕截图显示了 Entry 启用了清除按钮的 Android 上的：

转换文本

Entry通过将属性设置为 TextTransform 枚举的值，可以转换存储在属性中的Text文本的大小TextTransform写。此枚举有四个值：

None 指示不会转换文本。 Default 指示将使用平台的默认行为。这是 TextTransform 属性的默认值。 Lowercase 指示文本将转换为小写。 Uppercase 指示文本将转换为大写。

以下示例演示如何将文本转换为大写：

模糊的文本输入

Entry 提供属性， IsPassword 当设置为 true时，该属性在视觉上遮盖输入的文本：

以下屏幕截图显示了 Entry 其输入已被遮盖的：

自定义键盘

用户与 Entry 交互时显示的虚拟键盘可以通过属性以编程方式 Keyboard 设置为类中的以下属性 Keyboard 之一：

Chat – 用于短信和表情符号有用的地方。 Default – 默认键盘。 Email – 输入电子邮件地址时使用。 Numeric – 输入数字时使用。 Plain – 输入文本时使用，而无需指定任何 KeyboardFlags。 Telephone – 输入电话号码时使用。 Text – 输入文本时使用。 Url - 用于输入文件路径 & Web 地址。

以下示例演示如何设置 Keyboard 属性：

Keyboard 类还具有 Create 工厂方法，可用于通过指定大小写、拼写检查和建议行为来自定义键盘。 KeyboardFlags 枚举值指定为方法的参数，并返回自定义的 Keyboard。 KeyboardFlags 枚举包含以下值：

None – 没有功能添加到键盘。 CapitalizeSentence – 指示输入的每句话的第一个词的首字母将自动大写。 Spellcheck – 指示将对输入的文本执行拼写检查。 Suggestions – 指示将对输入的文本执行单词自动完成。 CapitalizeWord – 指示每个词的首字母将自动大写。 CapitalizeCharacter – 指示每个字符将自动大写。 CapitalizeNone – 指示不会发生自动大写。 All – 指示将对输入的文本执行拼写检查、单词自动完成和句子首字母大写。

以下 XAML 代码示例演示如何自定义默认 Keyboard 来执行单词自动完成并将输入的每个字符的首字母大写：

Suggestions,CapitalizeCharacter

等效 C# 代码如下：

Entry entry = new Entry { Placeholder = "Enter text here" }; entry.Keyboard = Keyboard.Create(KeyboardFlags.Suggestions | KeyboardFlags.CapitalizeCharacter); 自定义返回键

通过将属性设置为 ReturnType 枚举的值ReturnType，可以自定义虚拟键盘上返回键的外观（在具有焦点时Entry显示）：

Default – 指示不需要特定的返回键，并且将使用平台默认值。 Done – 指示“完成”返回键。 Go – 指示“Go”返回键。 Next – 指示“下一步”返回键。 Search – 指示“搜索”返回键。 Send – 指示“发送”返回键。

以下 XAML 示例演示如何设置返回键：

注意

返回键的确切外观取决于平台。在 iOS 上，返回键是基于文本的按钮。但是，在 Android 和 Windows 上，返回键是基于图标的按钮。

按下返回键时，将Completed触发事件，并执行属性指定ReturnCommand的任何ICommand事件。此外，由属性指定ReturnCommandParameter的任何object都将作为参数传递给 ICommand 。有关命令的详细信息，请参阅命令。

启用和禁用拼写检查

属性 IsSpellCheckEnabled 控制是否启用拼写检查。默认情况下，属性设置为 true。当用户输入文本时，会指示拼写错误。

但是，对于某些文本输入方案（例如输入用户名），拼写检查提供负面体验，应通过将属性设置为 IsSpellCheckEnabledfalse来禁用：

注意

当属性 IsSpellCheckEnabled 设置为 false时，并且不使用自定义键盘时，将禁用本机拼写检查器。但是，如果 Keyboard 已设置禁用拼写检查的，例如 Keyboard.Chat，则会忽略该 IsSpellCheckEnabled 属性。因此，属性不能用于为 Keyboard 显式禁用它的启用拼写检查。

启用和禁用文本预测

属性 IsTextPredictionEnabled 控制是否启用文本预测和自动文本更正。默认情况下，属性设置为 true。当用户输入文本时，将显示单词预测。

但是，对于某些文本输入方案（例如输入用户名、文本预测和自动文本更正）提供负面体验，应通过将属性设置为 IsTextPredictionEnabledfalse来禁用：

注意

当属性 IsTextPredictionEnabled 设置为 false时，并且不使用自定义键盘时，将禁用文本预测和自动文本更正。但是，如果 Keyboard 已设置禁用文本预测的，则会 IsTextPredictionEnabled 忽略该属性。因此，属性不能用于为 Keyboard 显式禁用它的启用文本预测。

阻止文本输入

通过将属性设置为 IsReadOnlytrue，可以阻止用户修改中的Entry文本：

注意

属性 IsReadonly 不会改变的 Entry视觉外观，这与属性不同， IsEnabled 该属性也会将的 Entry 视觉外观更改为灰色。

【本文地址】

公司简介

联系我们