## 概述

PhonePC/2in1TabletTVWearable

提供输入框配置信息对象的创建、销毁与读写方法。

**引用文件：** <inputmethod/inputmethod\_text\_config\_capi.h>

**库：** libohinputmethod.so

**系统能力：** SystemCapability.MiscServices.InputMethodFramework

**起始版本：** 12

**相关模块：** [InputMethod](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod)

## 汇总

PhonePC/2in1TabletTVWearable

### 结构体

PhonePC/2in1TabletTVWearable

展开

| 名称 | typedef关键字 | 描述 |
| --- | --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) | InputMethod\_TextConfig | 输入框的配置信息。 |

### 函数

PhonePC/2in1TabletTVWearable

展开

| 名称 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig \*OH\_TextConfig\_Create(void)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_create) | 创建一个新的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例。 |
| [void OH\_TextConfig\_Destroy(InputMethod\_TextConfig \*config)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_destroy) | 销毁一个[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_SetInputType(InputMethod\_TextConfig \*config, InputMethod\_TextInputType inputType)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_setinputtype) | 设置文本配置信息中的输入框类型。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_SetEnterKeyType(InputMethod\_TextConfig \*config, InputMethod\_EnterKeyType enterKeyType)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_setenterkeytype) | 设置文本配置信息中的回车键功能类型。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_SetPreviewTextSupport(InputMethod\_TextConfig \*config, bool supported)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_setpreviewtextsupport) | 将预上屏支持情况设置到文本配置信息中。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_SetSelection(InputMethod\_TextConfig \*config, int32\_t start, int32\_t end)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_setselection) | 设置文本配置信息中的选中文本范围。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_SetWindowId(InputMethod\_TextConfig \*config, int32\_t windowId)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_setwindowid) | 设置文本配置信息中所属窗口的窗口id。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_SetPlaceholder(InputMethod\_TextConfig \*config, const char16\_t \*placeholder,size\_t length)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_setplaceholder) | 设置文本配置信息中的占位符文本信息。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_SetAbilityName(InputMethod\_TextConfig \*config, const char16\_t \*abilityName,size\_t length)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_setabilityname) | 设置文本配置信息中的abilityName信息。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_GetInputType(InputMethod\_TextConfig \*config, InputMethod\_TextInputType \*inputType)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_getinputtype) | 获取文本配置信息中的输入框类型。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_GetEnterKeyType(InputMethod\_TextConfig \*config, InputMethod\_EnterKeyType \*enterKeyType)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_getenterkeytype) | 获取文本配置信息中的回车键功能类型。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_IsPreviewTextSupported(InputMethod\_TextConfig \*config, bool \*supported)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_ispreviewtextsupported) | 获取文本配置中是否支持预上屏。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_GetCursorInfo(InputMethod\_TextConfig \*config, InputMethod\_CursorInfo \*\*cursorInfo)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_getcursorinfo) | 获取文本配置信息中的光标信息。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_GetTextAvoidInfo(InputMethod\_TextConfig \*config, InputMethod\_TextAvoidInfo \*\*avoidInfo)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_gettextavoidinfo) | 获取文本配置信息中的避让信息。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_GetSelection(InputMethod\_TextConfig \*config, int32\_t \*start, int32\_t \*end)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_getselection) | 获取文本配置信息中的选区范围信息。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_GetWindowId(InputMethod\_TextConfig \*config, int32\_t \*windowId)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_getwindowid) | 获取文本配置信息中所属窗口的窗口id。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_GetPlaceholder(InputMethod\_TextConfig \*config, char16\_t \*placeholder,size\_t \*length)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_getplaceholder) | 获取文本配置信息中的占位符文本信息。 |
| [InputMethod\_ErrorCode OH\_TextConfig\_GetAbilityName(InputMethod\_TextConfig \*config, char16\_t \*abilityName,size\_t \*length)](/consumer/cn/doc/harmonyos-references/capi-inputmethod-text-config-capi-h#oh_textconfig_getabilityname) | 获取文本配置信息中的abilityName信息。 |

## 函数说明

PhonePC/2in1TabletTVWearable

### OH\_TextConfig\_Create()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_TextConfig *OH_TextConfig_Create(void)
```

**描述**

创建一个新的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例。

**起始版本：** 12

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \* | 如果创建成功，返回一个指向新创建的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。  如果创建失败，对象返回NULL，可能的失败原因有应用地址空间满。 |

### OH\_TextConfig\_Destroy()

PhonePC/2in1TabletTVWearable



```
1. void OH_TextConfig_Destroy(InputMethod_TextConfig *config)
```

**描述**

销毁一个[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 表示指向即将被销毁的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |

### OH\_TextConfig\_SetInputType()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_SetInputType(InputMethod_TextConfig *config, InputMethod_TextInputType inputType)
```

**描述**

设置文本配置信息中的输入框类型。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被设置值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| [InputMethod\_TextInputType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_textinputtype) inputType | 输入框的输入类型。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | 返回一个特定的错误码。  [IME\_ERR\_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。  [IME\_ERR\_NULL\_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。  具体错误码可以参考[InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。 |

### OH\_TextConfig\_SetEnterKeyType()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_SetEnterKeyType(InputMethod_TextConfig *config, InputMethod_EnterKeyType enterKeyType)
```

**描述**

设置文本配置信息中的回车键功能类型。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被设置值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| [InputMethod\_EnterKeyType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_enterkeytype) enterKeyType | 回车键功能类型。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | 返回一个特定的错误码。  [IME\_ERR\_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。  [IME\_ERR\_NULL\_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。  具体错误码可以参考[InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。 |

### OH\_TextConfig\_SetPreviewTextSupport()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_SetPreviewTextSupport(InputMethod_TextConfig *config, bool supported)
```

**描述**

将预上屏支持情况设置到文本配置信息中。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被设置值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| bool supported | 表示输入框是否支持预上屏。true - 表示支持预上屏。false - 表示不支持预上屏。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | 返回一个特定的错误码。  [IME\_ERR\_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。  [IME\_ERR\_NULL\_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。  具体错误码可以参考[InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。 |

### OH\_TextConfig\_SetSelection()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_SetSelection(InputMethod_TextConfig *config, int32_t start, int32_t end)
```

**描述**

设置文本配置信息中的选中文本范围。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被设置值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| int32\_t start | 所选文本的起始位置。 |
| int32\_t end | 所选文本的结束位置。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | 返回一个特定的错误码。  [IME\_ERR\_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。  [IME\_ERR\_NULL\_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。  具体错误码可以参考[InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。 |

### OH\_TextConfig\_SetWindowId()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_SetWindowId(InputMethod_TextConfig *config, int32_t windowId)
```

**描述**

设置文本配置信息中所属窗口的窗口id。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被设置值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| int32\_t windowId | 绑定输入法的应用所属窗口的窗口id。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | 返回一个特定的错误码。  [IME\_ERR\_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。  [IME\_ERR\_NULL\_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。  具体错误码可以参考[InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。 |

### OH\_TextConfig\_SetPlaceholder()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_SetPlaceholder(InputMethod_TextConfig *config, const char16_t *placeholder,size_t length)
```

**描述**

设置文本配置信息中的占位符文本信息。

**起始版本：** 20

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被设置值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| const char16\_t \*placeholder | 指向UTF-16编码的双字节指针；若传空指针，则会将占位文本信息设置为空字符串。 |
| size\_t length | placeholder指针指向内存所包含的元素个数，包含最后的字符串结尾符，计数单位为双字节。1. 如果长度为0，占位文本信息会被设置为空字符串。2. UTF-16编码的最大长度为255个字符（如果最后一位是字符串结尾符，不包含在计数中），超过255个字符数将会被截断。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)：  IME\_ERR\_OK = 0：表示成功。  IME\_ERR\_NULL\_POINTER = 12802000：非预期的空指针。 |

### OH\_TextConfig\_SetAbilityName()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_SetAbilityName(InputMethod_TextConfig *config, const char16_t *abilityName,size_t length)
```

**描述**

设置文本配置信息中的abilityName信息。

**起始版本：** 20

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被设置值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| const char16\_t \*abilityName | 指向UTF-16编码的双字节指针；若传空指针，则会将abilityName设置为空字符串。 |
| size\_t length | abilityName指针指向内存所包含的元素个数，包含最后的字符串结尾符，计数单位为双字节。1. 如果长度为0，abilityName会被设置为空字符串。2. UTF-16编码的最大长度为127个字符（如果最后一位是字符串结尾符，不包含在计数中），超过127个字符数将会被截断。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)：  IME\_ERR\_OK = 0：表示成功。  IME\_ERR\_NULL\_POINTER = 12802000：非预期的空指针。 |

### OH\_TextConfig\_GetInputType()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_GetInputType(InputMethod_TextConfig *config, InputMethod_TextInputType *inputType)
```

**描述**

获取文本配置信息中的输入框类型。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被获取值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| [InputMethod\_TextInputType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_textinputtype) \*inputType | 表示指向[InputMethod\_TextInputType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_textinputtype)实例的指针。 输入框的输入类型。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | 返回一个特定的错误码。  [IME\_ERR\_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。  [IME\_ERR\_NULL\_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。  具体错误码可以参考[InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。 |

### OH\_TextConfig\_GetEnterKeyType()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_GetEnterKeyType(InputMethod_TextConfig *config, InputMethod_EnterKeyType *enterKeyType)
```

**描述**

获取文本配置信息中的回车键功能类型。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被获取值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| [InputMethod\_EnterKeyType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_enterkeytype) \*enterKeyType | 表示指向[InputMethod\_EnterKeyType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_enterkeytype)实例的指针。 输入框的回车键功能类型。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | 返回一个特定的错误码。  [IME\_ERR\_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。  [IME\_ERR\_NULL\_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。  具体错误码可以参考[InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。 |

### OH\_TextConfig\_IsPreviewTextSupported()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_IsPreviewTextSupported(InputMethod_TextConfig *config, bool *supported)
```

**描述**

获取文本配置中是否支持预上屏。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被获取值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| bool \*supported | 表示输入框是否支持预上屏。true - 表示支持预上屏。false - 表示不支持预上屏。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | 返回一个特定的错误码。  [IME\_ERR\_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。  [IME\_ERR\_NULL\_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。  具体错误码可以参考[InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。 |

### OH\_TextConfig\_GetCursorInfo()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_GetCursorInfo(InputMethod_TextConfig *config, InputMethod_CursorInfo **cursorInfo)
```

**描述**

获取文本配置信息中的光标信息。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被获取值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| [InputMethod\_CursorInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-cursorinfo) \*\*cursorInfo | 光标信息。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | 返回一个特定的错误码。  [IME\_ERR\_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。  [IME\_ERR\_NULL\_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。  具体错误码可以参考[InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。 |

### OH\_TextConfig\_GetTextAvoidInfo()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_GetTextAvoidInfo(InputMethod_TextConfig *config, InputMethod_TextAvoidInfo **avoidInfo)
```

**描述**

获取文本配置信息中的避让信息。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 表示文本配置信息。 |
| [InputMethod\_TextAvoidInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textavoidinfo) \*\*avoidInfo | 输入框避让信息。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | 返回一个特定的错误码。  [IME\_ERR\_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。  [IME\_ERR\_NULL\_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。  具体错误码可以参考[InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。 |

### OH\_TextConfig\_GetSelection()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_GetSelection(InputMethod_TextConfig *config, int32_t *start, int32_t *end)
```

**描述**

获取文本配置信息中的选区范围信息。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被获取值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| int32\_t \*start | 所选文本的起始位置。 |
| int32\_t \*end | 所选文本的结束位置。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | 返回一个特定的错误码。  [IME\_ERR\_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。  [IME\_ERR\_NULL\_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。  具体错误码可以参考[InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。 |

### OH\_TextConfig\_GetWindowId()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_GetWindowId(InputMethod_TextConfig *config, int32_t *windowId)
```

**描述**

获取文本配置信息中所属窗口的窗口id。

**起始版本：** 12

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被获取值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| int32\_t \*windowId | 绑定输入法的应用所属窗口的窗口id。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | 返回一个特定的错误码。  [IME\_ERR\_OK](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 表示成功。  [IME\_ERR\_NULL\_POINTER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) - 非预期的空指针。  具体错误码可以参考[InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)。 |

### OH\_TextConfig\_GetPlaceholder()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_GetPlaceholder(InputMethod_TextConfig *config, char16_t *placeholder,size_t *length)
```

**描述**

获取文本配置信息中的占位符文本信息。

**起始版本：** 20

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被获取值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| char16\_t \*placeholder | 用于存放占位文本信息，该指针内存由调用者维护。 |
| size\_t \*length | 占位文本信息长度，计数单位为双字节，长度包含字符串结尾符。1. 作为入参，代表placeholder指向的内存可用长度。作为出参，代表实际的占位文本长度。2. 如果placeholder为空指针，且length指向有效内存，则length会被填充实际的占位文本长度。接口会返错。3. 如果placeholder和length都指向有效内存，但length传入的长度小于实际的占位文本长度，则length会被填充实际的占位文本长度。接口会返错。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)：  IME\_ERR\_OK = 0：表示成功。  IME\_ERR\_PARAMCHECK = 401：参数检查失败。  IME\_ERR\_NULL\_POINTER = 12802000：非预期的空指针。 |

### OH\_TextConfig\_GetAbilityName()

PhonePC/2in1TabletTVWearable



```
1. InputMethod_ErrorCode OH_TextConfig_GetAbilityName(InputMethod_TextConfig *config, char16_t *abilityName,size_t *length)
```

**描述**

获取文本配置信息中的abilityName信息。

**起始版本：** 20

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig) \*config | 指向即将被获取值的[InputMethod\_TextConfig](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-inputmethod-textconfig)实例的指针。 |
| char16\_t \*abilityName | 用于存放abilityName，该指针内存由调用者维护。 |
| size\_t \*length | abilityName长度，计数单位为双字节，长度包含字符串结尾符。1. 作为入参，代表abilityName指向的内存可用长度。作为出参，代表实际的abilityName长度。2. 如果abilityName为空指针，且length指向有效内存，则length会被填充实际的abilityName长度。接口会返错。3. 如果abilityName和length都指向有效内存，但length传入的长度小于实际的abilityName长度，则length会被填充实际的abilityName长度。接口会返错。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode) | [InputMethod\_ErrorCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-inputmethod-types-capi-h#inputmethod_errorcode)：  IME\_ERR\_OK = 0：表示成功。  IME\_ERR\_PARAMCHECK = 401：参数检查失败。  IME\_ERR\_NULL\_POINTER = 12802000：非预期的空指针。 |