语言

IInputConnection.GetSurroundingText(Int32, Int32, Int32) 方法

定义

获取当前游标周围的文本,在光标(所选内容开始)之前具有文本 的 BeforeLength 字符、光标之后的文本 后 (所选内容末尾)和所有选定文本之后的文本。

[Android.Runtime.Register("getSurroundingText", "(III)Landroid/view/inputmethod/SurroundingText;", "GetGetSurroundingText_IIIHandler:Android.Views.InputMethods.IInputConnection, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=31)]
public virtual Android.Views.InputMethods.SurroundingText? GetSurroundingText(int beforeLength, int afterLength, int flags);
[<Android.Runtime.Register("getSurroundingText", "(III)Landroid/view/inputmethod/SurroundingText;", "GetGetSurroundingText_IIIHandler:Android.Views.InputMethods.IInputConnection, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=31)>]
abstract member GetSurroundingText : int * int * int -> Android.Views.InputMethods.SurroundingText
override this.GetSurroundingText : int * int * int -> Android.Views.InputMethods.SurroundingText

参数

beforeLength
Int32

光标前文本的预期长度。

afterLength
Int32

光标后文本的预期长度。

flags
Int32

提供用于控制如何返回文本的其他选项。 可以是或 0#GET_TEXT_WITH_STYLES。

返回

android.view.inputmethod.SurroundingText描述周围文本和选定状态的对象,如果输入连接不再有效,或者编辑器由于某种原因而不符合请求,或者应用程序未实现此方法,则为 null。 返回的文本长度可能小于 BeforeLength 和 AfterLength 的总和。

特性

注解

获取当前游标周围的文本,在光标(所选内容开始)之前具有文本 的 BeforeLength 字符、光标之后的文本 后 (所选内容末尾)和所有选定文本之后的文本。 该范围适用于 java 字符,而不是可以是多个字符的字形。

如果输入连接变得无效(例如进程崩溃),或者客户端响应文本的时间过长(返回几秒钟),或者不支持协议,则此方法可能会失败。 在上述任一情况下,返回 null。

此方法不会以任何方式影响编辑器中的文本,也不会影响所选内容或撰写范围。

如果 #GET_TEXT_WITH_STYLES 以标志的形式提供,编辑器应返回 android.text.Spanned 文本上设置的所有跨度。

IME 作者: 请考虑这会触发 IPC 往返,这需要一些时间。 假设此方法占用大量时间。 如果使用此方法获取光标周围的初始周围文本,可以考虑使用 EditorInfo#getInitialTextBeforeCursor(int, int), EditorInfo#getInitialSelectedText(int)并 EditorInfo#getInitialTextAfterCursor(int, int) 防止 IPC 成本。

Java文档android.view.inputmethod.InputConnection.getSurroundingText(int, int, int)。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于