智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 设计了解鸿蒙应用和多设备开发，学习如何构建应用/元服务
- 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
高级筛选
API version全部版本
设备全部
元服务API集不筛选
API参考概述
应用框架
系统
媒体
图形
应用服务
AI
公共基础能力
标准库
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
InputMethod_TextConfig
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
更新时间: 2026-08-29 09:41
收起
自动换行
深色代码主题
复制
- typedef struct InputMethod_TextConfig InputMethod_TextConfig
概述
文本输入框的文本输入行为配置结构体，用于输入框向输入法框架传递核心输入规则，输入法框架根据配置执行相应输入行为。通过配置输入属性（如输入类型、文本格式等），能够满足不同场景下的输入需求，提升用户输入体验，适用于需要精细化控制输入行为的文本输入场景。该结构体为不透明类型（opaque type），调用者不可直接访问其内部成员，仅可通过本模块提供的函数接口进行操作。
起始版本： 12
相关模块： InputMethod
结构体用途
InputMethod_TextConfig承载编辑框的配置信息，包括输入类型、回车键类型、预上屏支持、选区范围、光标信息、避让信息、窗口ID、占位符文本、abilityName等。该配置信息在OH_TextEditorProxy_GetTextConfigFunc回调中使用，开发者需在回调内对config参数设置各配置项，输入法框架据此调整键盘布局和输入行为。
包含关系
InputMethod_TextConfig内部包含以下子结构体信息：
- InputMethod_CursorInfo：光标信息，包括光标位置、高度等。可通过OH_TextConfig_GetCursorInfo获取，返回双指针（函数内部分配内存）。
- InputMethod_TextAvoidInfo：避让信息，包括避让区域的位置和尺寸。可通过OH_TextConfig_GetTextAvoidInfo获取，返回双指针（函数内部分配内存）。
相关函数：
- 创建/销毁函数：
展开
| 函数 | 描述 |
|---|---|
| OH_TextConfig_Create | 创建一个新的InputMethod_TextConfig实例。 |
| OH_TextConfig_Destroy | 销毁一个InputMethod_TextConfig实例。 |
- 设置函数（Set*）：
展开
| 函数 | 描述 |
|---|---|
| OH_TextConfig_SetInputType | 设置文本配置信息中的输入框类型。 |
| OH_TextConfig_SetEnterKeyType | 设置文本配置信息中的回车键功能类型。 |
| OH_TextConfig_SetPreviewTextSupport | 设置预上屏支持情况。 |
| OH_TextConfig_SetSelection | 设置选中文本范围。 |
| OH_TextConfig_SetWindowId | 设置所属窗口的窗口ID。 |
| OH_TextConfig_SetPlaceholder | 设置占位符文本信息。 |
| OH_TextConfig_SetAbilityName | 设置abilityName信息。 |
| OH_TextConfig_SetConsumeKeyEvents | 将编辑框是否具有完整处理字母、字符、功能等按键的能力设置到文本配置信息中。 起始版本： 26.0.0 |
- 获取函数（Get*）：
展开
| 函数 | 描述 |
|---|---|
| OH_TextConfig_GetInputType | 获取输入框类型。 |
| OH_TextConfig_GetEnterKeyType | 获取回车键功能类型。 |
| OH_TextConfig_IsPreviewTextSupported | 获取是否支持预上屏。 |
| OH_TextConfig_GetCursorInfo | 获取光标信息（双指针，函数内部分配内存）。 |
| OH_TextConfig_GetTextAvoidInfo | 获取避让信息（双指针，函数内部分配内存）。 |
| OH_TextConfig_GetSelection | 获取选区范围信息。 |
| OH_TextConfig_GetWindowId | 获取所属窗口的窗口ID。 |
| OH_TextConfig_GetPlaceholder | 获取占位符文本信息。 |
| OH_TextConfig_GetAbilityName | 获取abilityName信息。 |
| OH_TextConfig_GetConsumeKeyEvents | 获取文本配置中编辑框是否具有完整处理字母、字符、功能等按键的能力。 起始版本： 26.0.0 |
相关推荐
华为开发者联盟 版权所有 ©2026
在 API参考 中进行搜索
请输入您想要搜索的关键词