IInputConnectionExtensions.SetComposingText 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| SetComposingText(IInputConnection, String, Int32) |
将当前撰写的文本替换为给定文本,并设置新的光标位置。 |
| SetComposingText(IInputConnection, String, Int32, TextAttribute) |
setComposingText(CharSequence,int)的变体。 |
SetComposingText(IInputConnection, String, Int32)
将当前撰写的文本替换为给定文本,并设置新的光标位置。
public static bool SetComposingText(this Android.Views.InputMethods.IInputConnection self, string? text, int newCursorPosition);
static member SetComposingText : Android.Views.InputMethods.IInputConnection * string * int -> bool
参数
- self
- IInputConnection
要对其调用方法的输入连接。
- text
- String
撰写文本。 使用撰写文本的默认样式。
- newCursorPosition
- Int32
文本周围的新光标位置。 如果 > 为 0,则相对于文本末尾 - 1;如果 <= 0,则相对于文本开头。 因此,在插入全文后,值 1 将始终转到位置。 请注意,这意味着不能将光标定位在文本中,因为编辑器可以对提供的文本进行修改,因此无法正确指定该位置。
返回
如果输入连接不再有效,则为 true;如果输入连接不再有效,则为 true。
注解
将当前撰写的文本替换为给定文本,并设置新的光标位置。 将自动删除之前设置的任何撰写文本。
如果当前有任何组合范围处于活动状态,则会删除它包含的所有字符。 传递的文本将添加到其位置,并且将撰写范围添加到此文本中。 如果没有活动撰写范围,则传递的文本将添加到光标位置(首先删除所选字符(如果有),并在新文本上添加撰写范围。 最后,游标移动到 newCursorPosition 指定的位置。
这通常由 IME 调用,以添加或删除撰写范围中的字符。 调用此方法将导致编辑器在批处理输入结束后对当前 IME 调用 InputMethodService.onUpdateSelection(int、int、int、int、int、int)。
编辑作者:请记住,文本可能与通话时撰写范围非常相似或完全不同,或者可能根本不存在撰写范围。 请注意,虽然这不是典型的用法,但字符串可能为空。 通常处理此问题,将当前撰写的文本替换为空字符串。 此外,请谨慎使用光标位置。 IME 完全依赖于上述工作。 由于这会更改编辑器的内容,因此需要通过调用 InputMethodManager.updateSelection(android.view.View、int、int、int、int)来了解输入方法的更改,但请小心等待,直到批处理编辑正在进行时结束。 请注意,此方法可以在撰写文本的边缘或完全位于该文本的边缘上设置光标位置,但 IME 还可以继续在后续调用中将光标位置移动到撰写文本中,因此您根本不应该做出任何假设:撰写文本和所选内容是完全独立的。
Android 参考。android.view.inputmethod.InputConnection.setComposingText
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
适用于
SetComposingText(IInputConnection, String, Int32, TextAttribute)
setComposingText(CharSequence,int)的变体。
public static bool SetComposingText(this Android.Views.InputMethods.IInputConnection self, string text, int newCursorPosition, Android.Views.InputMethods.TextAttribute? textAttribute);
static member SetComposingText : Android.Views.InputMethods.IInputConnection * string * int * Android.Views.InputMethods.TextAttribute -> bool
参数
- self
- IInputConnection
要对其调用方法的输入连接。
- text
- String
撰写文本。 使用撰写文本的默认样式。 此值不能为 null。
- newCursorPosition
- Int32
文本周围的新光标位置。 如果 > 为 0,则相对于文本末尾 - 1;如果 <= 0,则相对于文本开头。 因此,在插入全文后,值 1 将始终转到位置。 请注意,这意味着不能将光标定位在文本中,因为编辑器可以对提供的文本进行修改,因此无法正确指定该位置。
- textAttribute
- TextAttribute
有关文本的额外信息。 此值可能为 null。
返回
如果输入连接不再有效,则为 true;如果输入连接不再有效,则为 true。
注解
setComposingText(CharSequence,int)的变体。 此方法用于允许 IME 在设置撰写文本时提供额外信息。
Android 参考。android.view.inputmethod.InputConnection.setComposingText
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。