示例工程【免费下载链接】Windows-universal-samplesAPI samples for the Universal Windows Platform.项目地址https://gitcode.com/gh_mirrors/wi/Windows-universal-samples点击查看免费下载导读本文基于 Windows-universal-samples 仓库中的 TouchKeyboardTextInput 示例系统讲解如何在 UWP 应用中为TextBox与RichEditBox两类 XAML 文本控件启用触控键盘的优化视图Scoped Views通过InputScope输入作用域让触控键盘自动切换为数字、URL、邮箱、电话等专用布局通过IsSpellCheckEnabled / IsTextPredictionEnabled属性开启拼写检查与文本预测。读完本文你将掌握这两类优化手段的 XAML 配置写法、两者之间的默认行为差异以及该示例的完整构建与运行方法可直接迁移到自己的 UWP 输入界面设计中。一、示例概览两种触控键盘优化手段该示例同时演示了 UWP 文本输入优化的两条核心路径对应仓库Shared目录下的两个独立场景页面场景对应 XAML 文件核心能力Spelling and Text Suggestions拼写检查与文本建议Scenario1_SpellingTextSuggestions.xaml通过IsSpellCheckEnabled与IsTextPredictionEnabled开启/关闭拼写纠错与输入联想Scoped Views作用域视图Scenario2_ScopedViews.xaml通过TextBox.InputScope让触控键盘按输入语义自动切换优化布局两个场景由示例框架统一注册导航C# 版本在 SampleConfiguration.cs 中以Scenario列表形式注册C 版本则在 SampleConfiguration.cpp 中通过Platform::ArrayScenario注册标题分别为 Spelling and Text Suggestions 与 Scoped Views应用启动后即可在场景列表中切换。二、场景一拼写检查与文本建议IsSpellCheckEnabled / IsTextPredictionEnabled2.1 两个属性的作用IsSpellCheckEnabled控制编辑控件是否启用拼写检查服务。启用后用户输入过程中系统会标记疑似拼写错误的单词IsTextPredictionEnabled控制编辑控件是否启用文本预测联想服务。启用后输入时触控键盘上方会动态提供候选词。这两个属性在TextBox与RichEditBox上均可用。需要特别注意的是二者存在默认行为差异——从 Scenario1 的 XAML 描述文本可以看到默认情况下RichEditBox控件已启用拼写检查和文本建议而TextBox控件需要显式设置才能启用。也就是说如果你的界面使用TextBox希望获得拼写纠错与联想能力必须显式把这两个属性设为True而RichEditBox即便不写默认也是开启的。这也是该场景刻意摆放四组控件开/关 × 两种控件对比演示的原因。2.2 完整 XAML 配置开/关对比场景一在页面中构建了一个 2 列表格左侧为控件类型标签右侧为实际输入控件上半部分两组全部关闭、下半部分两组全部开启!-- 全部关闭 -- TextBox x:NameTextBoxOff IsTextPredictionEnabledFalse IsSpellCheckEnabledFalse AutomationProperties.NameTextBox Settings Off HorizontalAlignmentStretch Height46/ RichEditBox x:NameRichEditOff IsTextPredictionEnabledFalse IsSpellCheckEnabledFalse AutomationProperties.NameRichEdit Settings Off HorizontalAlignmentStretch Height46/ !-- 全部开启 -- TextBox x:NameTextBoxOn IsTextPredictionEnabledTrue IsSpellCheckEnabledTrue AutomationProperties.NameTextBox Settings On HorizontalAlignmentStretch Height46/ RichEditBox x:NameRichEditOn IsTextPredictionEnabledTrue IsSpellCheckEnabledTrue AutomationProperties.NameRichEdit Settings On HorizontalAlignmentStretch Height46/完整布局见 Scenario1_SpellingTextSuggestions.xaml。页面底部还给出运行提示当用户在启用相关服务的编辑控件中输入时无论使用触控键盘还是硬件键盘拼写检查和文本建议服务都会被自动提供见 XAML 输出文本。2.3 代码后置文件说明该场景的后置代码C# 的 Scenario1_SpellingTextSuggestions.xaml.cs 与 C 的 Scenario1_SpellingTextSuggestions.xaml.cpp只包含页面构造函数中的InitializeComponent()调用全部行为均由 XAML 属性声明驱动。这印证了一个实现事实拼写检查与文本预测是声明式declarative能力开发者不需要编写任何事件处理或业务逻辑只需设置控件属性即可生效这也是把该能力集成进既有页面时成本极低的原因。三、场景二Scoped Views——用 InputScope 让触控键盘智能换肤3.1 原理InputScope 与 InputScopeNameTextBox与RichEditBox通过InputScope属性声明这个输入框期望什么类型的内容。系统读取该声明后会为触控键盘加载与之匹配的优化布局。例如声明为Number时键盘自动切换为数字键盘便于快速输入数字声明为Url时键盘提供http://、www.、.com等网址常用按键声明为EmailSmtpAddress时键盘提供、.com等邮箱常用按键。XAML 中设置作用域的写法固定为三层结构TextBox.InputScope→InputScope→InputScope.Names中的InputScopeName元素核心取值是InputScopeName的NameValue属性。3.2 示例演示的七个作用域完整 XAML场景二共放置了七组带不同作用域的TextBox见 Scenario2_ScopedViews.xaml!-- Number数字键盘 -- TextBox x:NameNumberControl AutomationProperties.NameNumber HorizontalAlignmentStretch Height46 TextBox.InputScope InputScope InputScope.Names InputScopeName NameValueNumber/ /InputScope.Names /InputScope /TextBox.InputScope /TextBox !-- Search搜索键盘 -- TextBox x:NameSearchControl AutomationProperties.NameSearch HorizontalAlignmentStretch Height46 TextBox.InputScope InputScope InputScope.Names InputScopeName NameValueSearch/ /InputScope.Names /InputScope /TextBox.InputScope /TextBox !-- Url网址键盘 -- TextBox x:NameUrlControl AutomationProperties.NameURL HorizontalAlignmentStretch Height46 TextBox.InputScope InputScope InputScope.Names InputScopeName NameValueUrl/ /InputScope.Names /InputScope /TextBox.InputScope /TextBox !-- Email邮箱键盘EmailSmtpAddress -- TextBox x:NameEmailControl AutomationProperties.NameEmail HorizontalAlignmentStretch Height46 TextBox.InputScope InputScope InputScope.Names InputScopeName NameValueEmailSmtpAddress/ /InputScope.Names /InputScope /TextBox.InputScope /TextBox !-- Default默认键盘 -- TextBox x:NameDefaultControl AutomationProperties.NameDefault HorizontalAlignmentStretch Height46 TextBox.InputScope InputScope InputScope.Names InputScopeName NameValueDefault/ /InputScope.Names /InputScope /TextBox.InputScope /TextBox !-- Telephone电话号码键盘TelephoneNumber -- TextBox x:NameTelephoneControl AutomationProperties.NameTelephone HorizontalAlignmentStretch Height46 TextBox.InputScope InputScope InputScope.Names InputScopeName NameValueTelephoneNumber/ /InputScope.Names /InputScope /TextBox.InputScope /TextBox !-- Formula公式键盘 -- TextBox x:NameFormulaControl AutomationProperties.NameFormula HorizontalAlignmentStretch Height46 TextBox.InputScope InputScope InputScope.Names InputScopeName NameValueFormula/ /InputScope.Names /InputScope /TextBox.InputScope /TextBox3.3 与 README 声明输入类型的对应关系示例 README.md 声明演示的输入类型为 URL、Email、Password、Number、Search、Telephone 六种。对照仓库实际 XAML 可以确认Number、Search、Url、Email对应EmailSmtpAddress、Telephone对应TelephoneNumber五种均已实现同时 XAML 中还额外补充了Default默认键盘与Formula公式键盘两个作用域以展示更完整的枚举用法。至于 README 中列出的Password类型当前场景 XAML 中并未直接放置对应控件——开发者若需要密码输入框的专用键盘可参照同一结构将NameValue改为Password即可示例框架本身不限制作用域取值。InputScopeName的NameValue取值来自 Windows 平台公开的Windows.UI.Xaml.Input.InputScopeNameValue枚举除上文出现的取值外还包括NumberFullWidth、DateDayNumber、TelephoneText、EmailUserName、EmailAddress、Chat、NameOrPhoneNumber等更细分的语义选项可按输入框实际内容自由选择。3.4 触控键盘的显示条件PC 端注意事项场景二页面底部Scenario2_ScopedViews.xaml特别提示了 Windows 10 PC 上的触控键盘显示前提如果设备连接了硬件键盘或者 PC 处于桌面模式且系统设置在没有连接键盘时自动显示触控键盘设置 → 设备 → 键入被关闭触控键盘不会自动弹出。这解释了为什么部分开发者在 PC 上运行示例时看不到键盘布局变化——需要先满足上述显示条件再触碰编辑控件才能观察到对应作用域的优化布局被加载。四、源码组织C# 与 C 双语言实现该示例提供C# 与 CCX两种语言的完整工程共享同一套 XAML 场景页面C# 工程TouchKeyboardTextInput.csproj、TouchKeyboardTextInput.sln代码后置文件位于cs/目录C 工程TouchKeyboardTextInput.vcxproj、TouchKeyboardTextInput.sln代码后置文件位于cpp/目录并包含预编译头 pch.h共享 XAML两个场景页面统一放在 Shared/ 目录被两种语言工程共同引用避免重复维护 UI 定义。从包配置看C# 工程在 Package.appxmanifest 中声明了Windows.Universal目标设备族MinVersion为 10.0.10240.0、MaxVersionTested为 10.0.22621.0即该示例面向 Windows 10 及以上版本的通用 Windows 平台UWP应用标识为Microsoft.SDKSamples.TouchKeyboardTextInput.CS。五、构建与运行完整步骤5.1 系统要求Windows 10UWP 应用运行环境Visual Studio含 UWP 开发工具集用于打开解决方案并构建。5.2 构建步骤启动 Microsoft Visual Studio选择文件 → 打开 → 项目/解决方案进入示例解压后的目录打开目标语言子目录cs/或cpp/中的解决方案文件.sln双击打开按CtrlShiftB或选择生成 → 生成解决方案完成编译。注意该示例依赖仓库顶层SharedContent目录中的公共资源因此从仓库克隆后应保持完整目录结构不要只拷贝单个示例文件夹否则可能因缺少共享依赖而无法构建。5.3 运行步骤后续操作取决于你只需要部署还是需要部署并运行仅部署示例选择生成 → 部署解决方案。部署并运行示例以调试方式运行按F5或选择调试 → 开始调试不以调试方式运行按CtrlF5或选择调试 → 开始执行不调试。运行后应用主界面会列出 Spelling and Text Suggestions 与 Scoped Views 两个场景点击进入即可分别体验拼写检查/文本建议开关对比以及不同输入作用域下的触控键盘布局切换。六、主题延伸与最佳实践建议登录/注册表单账号输入框使用默认作用域密码框设置Password作用域邮箱框使用EmailSmtpAddress可从键盘层直接改善录入效率搜索框设置Search作用域后触控键盘的搜索键可配合QuerySubmitted事件直接触发搜索逻辑数字与电话录入金额、年龄等纯数字场景使用Number手机号使用TelephoneNumber能显著减少用户切换键盘符号层的操作关闭不必要的能力对于不需要纠错的场景如用户名、密码框可将IsSpellCheckEnabled显式设为False避免红色波浪线与候选词干扰输入这也是示例中提供全部关闭对照组的现实意义注意TextBox与RichEditBox默认值差异由于TextBox的拼写检查与文本预测默认关闭若业务上需要联想输入务必显式开启不要依赖默认行为。七、相关资源该示例属于 Windows-universal-samples 仓库中 UWP 功能示例集的一部分。与之配套的官方概念文档如触摸键盘使用指南、登录控件设计清单、用户交互响应指南等以及TextBox、RichEditBox、IsSpellCheckEnabled、IsTextPredictionEnabled、Windows.UI.Core等 API 参考均可通过 Windows 开发者文档检索获取。仓库中与输入交互相关的更多示例如 TouchKeyboard、TextSuggestion也可作为横向对比参考进一步理解 UWP 输入体系的其他侧面。赞分享示例工程【免费下载链接】Windows-universal-samplesAPI samples for the Universal Windows Platform.项目地址https://gitcode.com/gh_mirrors/wi/Windows-universal-samples点击查看免费下载相关推荐AWS CodeBuild 的 AWS SDK for GoV1实战示例构建项目、列出构建与项目AWS CodeBuild 的 AWS SDK for GoV1实战示例构建项目、列出构建与项目 导读 本文基于 AWS 文档代码示例仓库中的 go/co示例工程教程后端Druid文本输入控件深度解析TextBox与富文本编辑Druid文本输入控件深度解析TextBox与富文本编辑 在现代应用开发中文本输入是用户交互的核心环节。Druid作为Rust生态中一款以数据为中心的UI设跨平台桌面应用UI组件如何解决iOS Safari上Egui文本输入框无法唤醒键盘的问题完整指南如何解决iOS Safari上Egui文本输入框无法唤醒键盘的问题完整指南 Egui是一款用Rust编写的跨平台即时模式GUI库支持Web和原生应用开发。然UI组件前端桌面应用上一篇XORTRON.CriminalComputing.LARGE.2026.3-mlx-6Bit vs 原版模型6Bit量化如何在保持性能的同时降低资源消耗下一篇终极指南如何通过GitHub Issues快速找到理想的后端开发工作 创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
