語言

IInputConnectionExtensions.CommitText 方法

定義

多載

名稱 Description
CommitText(IInputConnection, String, Int32)

將文字提交到文字框,並設定新的游標位置。

CommitText(IInputConnection, String, Int32, TextAttribute)

InputConnection.commitText(CharSequence,int) 的變體。

CommitText(IInputConnection, String, Int32)

將文字提交到文字框,並設定新的游標位置。

public static bool CommitText(this Android.Views.InputMethods.IInputConnection self, string? text, int newCursorPosition);
static member CommitText : Android.Views.InputMethods.IInputConnection * string * int -> bool

參數

self
IInputConnection

要呼叫該方法的輸入連線。

text
String

要承諾的文字。

newCursorPosition
Int32

新的游標位置,以 Java 字元圍繞文字。 若 > 0,則相對於文本結尾為 - 1;若 <= 0,則相對於文本開頭。 因此,值為 1 時,游標總是會將游標移至插入完整文字後的位置。 請注意,這表示你無法將游標置於文字中,因為編輯器可能會修改你提供的文字,導致無法正確指定該位置。

傳回

成功時為真;若輸入連線不再有效,則為假。

備註

將文字提交到文字框,並設定新的游標位置。

此方法會移除目前正在撰寫的文字內容,並以傳出的 CharSequence 取代,然後依 newCursorPosition 移動游標。 若呼叫此方法時沒有合成文字,則會在游標位置插入新文字,若有選取區內文字則會被移除。 此操作的行為類似呼叫 setComposingText(text, newCursorPosition),然後完成 ComposingText()。

呼叫此方法會在批次輸入結束後,編輯器在目前 IME 上呼叫 InputMethodService.onUpdateSelection(int, int, int, int, int, int)。 編輯作者,要做到這點,你需要透過呼叫 InputMethodManager.updateSelection(android.view.View,int,int,int,int,int,int)來讓輸入法知道這些變更,但如果批次編輯正在進行中,請小心等到完成後再做。

Android 參考資料。android.view.inputmethod.InputConnection.commitText

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

適用於

CommitText(IInputConnection, String, Int32, TextAttribute)

InputConnection.commitText(CharSequence,int) 的變體。

public static bool CommitText(this Android.Views.InputMethods.IInputConnection self, string text, int newCursorPosition, Android.Views.InputMethods.TextAttribute? textAttribute);
static member CommitText : Android.Views.InputMethods.IInputConnection * string * int * Android.Views.InputMethods.TextAttribute -> bool

參數

self
IInputConnection

要呼叫該方法的輸入連線。

text
String

要承諾的文字。 這個值不可能為零值。

newCursorPosition
Int32

新的游標位置,以 Java 字元圍繞文字。 若 > 0,則相對於文本結尾為 - 1;若 <= 0,則相對於文本開頭。 因此,值為 1 時,游標總是會將游標移至插入完整文字後的位置。 請注意,這表示你無法將游標置於文字中,因為編輯器可能會修改你提供的文字,導致無法正確指定該位置。

textAttribute
TextAttribute

關於文本的額外資訊。 這個值可能是 Null。

傳回

成功時為真;若輸入連線不再有效,則為假。

備註

InputConnection.commitText(CharSequence,int) 的變體。 此方法用於讓 IME 在設定文字時提供額外資訊。

Android 參考資料。android.view.inputmethod.InputConnection.commitText

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

適用於