IInputConnectionExtensions.CommitText 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | 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 所創建與分享的作品,並依授權條款所描述的使用進行修改。