已合并
UIContext新增setTextSelectionPolicy接口 #137495
luckclover创建于 4月7日
UIContext新增setTextSelectionPolicy接口 #137495
已合并
共 2 个文件变更+65-1
| @@ -127,4 +127,21 @@ UIContext对象的解析策略。 | |||
| 127 | | 名称 | 值 | 说明 | | 127 | | 名称 | 值 | 说明 | |
| 128 | | ------ | ---- | ---------- | | 128 | | ------ | ---- | ---------- | |
| 129 | | ENABLED | 0 | 接续。 | | 129 | | ENABLED | 0 | 接续。 | |
| 130 | -| DISABLED | 1 | 不接续。 | | 130 | +| DISABLED | 1 | 不接续。 | |
| 131 | + | ||
| 132 | +## TextSelectionClearPolicy | ||
| 133 | + | ||
| 134 | +文本选择清除策略枚举。 | ||
| 135 | + | ||
 | |||
| 136 | +**起始版本：** 26.0.0 | ||
| 137 | + | ||
| 138 | +**原子化服务API：** 从API版本26.0.0开始，该接口支持在原子化服务中使用。 | ||
| 139 | + | ||
| 140 | +**系统能力：** SystemCapability.ArkUI.ArkUI.Full | ||
| 141 | + | ||
| 142 | +**模型约束：** 此接口仅可在Stage模型下使用。 | ||
| 143 | + | ||
| 144 | +| 名称 | 值 | 说明 | | ||
| 145 | +| ------ | ---- | ---------- | | ||
| 146 | +| KEEP_SELECTED_TEXT_ON_EXTERNAL_TOUCH | 0 | 触摸到文本组件外部时，保留文本选中和手柄。 | | ||
| 147 | +| CLEAR_SELECTED_TEXT_ON_EXTERNAL_TOUCH | 1 | 触摸到文本组件外部时，清除文本选中和手柄。 | | ||
| @@ -4813,3 +4813,50 @@ type InputEventListener = (event: RawInputEventWrapper) => InputEventInterceptRe | |||||||
| 4813 | | 类型 | 说明 | | 4813 | | 类型 | 说明 | | ||||
| 4814 | | -------- | ---- | | 4814 | | -------- | ---- | | ||||
| 4815 | | [InputEventInterceptResult](#inputeventinterceptresult) | 事件拦截结果。 | | 4815 | | [InputEventInterceptResult](#inputeventinterceptresult) | 事件拦截结果。 | | ||||
| 4816 | + | ||||||
| 4817 | +## setTextSelectionClearPolicy | ||||||
| 4818 | + | ||||||
| 4819 | +setTextSelectionClearPolicy(policy: TextSelectionClearPolicy): void | ||||||
| 4820 | + | ||||||
| 4821 | +设置文本组件的文本选择清除策略。未通过该接口设置时，默认策略为TextSelectionClearPolicy.KEEP_SELECTED_TEXT_ON_EXTERNAL_TOUCH。 | ||||||
A ❌疑似检测到中英文错别字 错误原因：中文句号后直接跟英文单词，不符合中文标点使用规范。建议使用全角标点或保持一致性。 建议修改为： 改动建议
  | |||||||
| 4822 | + | ||||||
| 4823 | +**起始版本：** 26.0.0 | ||||||
| 4824 | + | ||||||
| 4825 | +**原子化服务API：** 从API版本26.0.0开始，该接口支持在原子化服务中使用。 | ||||||
| 4826 | + | ||||||
| 4827 | +**系统能力：** SystemCapability.ArkUI.ArkUI.Full | ||||||
| 4828 | + | ||||||
| 4829 | +**模型约束：** 此接口仅可在Stage模型下使用。 | ||||||
| 4830 | + | ||||||
| 4831 | +**参数：** | ||||||
| 4832 | + | ||||||
| 4833 | +| 参数名 | 类型 | 必填 | 说明 | | ||||||
| 4834 | +| ------- | --------------------------------------------------------- | ---- | -------------------------------------- | | ||||||
| 4835 | +| policy | [TextSelectionClearPolicy](arkts-apis-uicontext-e.md#textselectionclearpolicy) | 是 | 文本选择清除策略。 | | ||||||
| 4836 | + | ||||||
| 4837 | +**示例：** | ||||||
| 4838 | + | ||||||
| 4839 | +```ts | ||||||
| 4840 | +import { TextSelectionClearPolicy } from '@kit.ArkUI'; | ||||||
| 4841 | + | ||||||
| 4842 | +@Entry | ||||||
| 4843 | +@Component | ||||||
| 4844 | +struct Index { | ||||||
| 4845 | + @State message: string = 'Hello World'; | ||||||
| 4846 | + | ||||||
| 4847 | + build() { | ||||||
| 4848 | + Column() { | ||||||
| 4849 | + Text(this.message) | ||||||
| 4850 | + .fontSize(20) | ||||||
| 4851 | + .margin(10) | ||||||
| 4852 | + .copyOption(CopyOptions.LocalDevice) | ||||||
| 4853 | + Button('Set Clear Policy') | ||||||
| 4854 | + .onClick(() => { | ||||||
| 4855 | + this.getUIContext()?.setTextSelectionClearPolicy(TextSelectionClearPolicy.CLEAR_SELECTED_TEXT_ON_EXTERNAL_TOUCH); | ||||||
| 4856 | + }) | ||||||
| 4857 | + } | ||||||
| 4858 | + .width('100%') | ||||||
| 4859 | + .height('100%') | ||||||
| 4860 | + } | ||||||
| 4861 | +} | ||||||
| 4862 | +``` | ||||||
26的接口都添加下起始版本说明。 起始版本： 26.0.0