語言

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

定義

命名空間:
Android.Views.InputMethods
組件:
Mono.Android.dll

取得當前游標周圍的文字，游<標前為 var 字元/游標前為 var><> 字元（<選擇開始），var 後為 varLength></游標後為 var> 字元（選擇結束），並包含所有選取的文字。

[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。

傳回

SurroundingText

一個 android.view.inputmethod.SurroundingText 描述周圍文字及選擇狀態的物件;若輸入連線不再有效，或編輯器因某些原因無法配合請求，或應用程式未實作此方法，則稱為 null。 回傳文字的長度可能小於 var<在 Length>/<var 之前與 >var 之後<> var<的總和>。

屬性
RegisterAttribute

備註

取得當前游標周圍的文字，游<標前為 var 字元/游標前為 var><> 字元（<選擇開始），var 後為 varLength></游標後為 var> 字元（選擇結束），並包含所有選取的文字。 這些範圍是 Java 字元，不是可以是多個字元的字形。

此方法可能失敗，例如輸入連線無效（例如程序崩潰）、客戶端回覆文字太慢（有幾秒鐘時間回覆），或協定不支援。 在上述任一情況下，回傳為 null。

此方法不影響編輯器中的文字，也不影響選取或組成的範圍。

如果 #GET_TEXT_WITH_STYLES 以旗標形式提供，編輯器應該回傳包含文字上所有跨度的 a 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)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於