IInputConnection.CommitText 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
CommitText(ICharSequence, Int32) |
將文字認可至文本框,並設定新的游標位置。 |
CommitText(ICharSequence, Int32, TextAttribute) |
的 |
CommitText(String, Int32, TextAttribute) |
的 |
CommitText(ICharSequence, Int32)
將文字認可至文本框,並設定新的游標位置。
[Android.Runtime.Register("commitText", "(Ljava/lang/CharSequence;I)Z", "GetCommitText_Ljava_lang_CharSequence_IHandler:Android.Views.InputMethods.IInputConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public bool CommitText (Java.Lang.ICharSequence? text, int newCursorPosition);
[<Android.Runtime.Register("commitText", "(Ljava/lang/CharSequence;I)Z", "GetCommitText_Ljava_lang_CharSequence_IHandler:Android.Views.InputMethods.IInputConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member CommitText : Java.Lang.ICharSequence * int -> bool
參數
- text
- ICharSequence
要認可的文字。 這可能包括樣式。
- newCursorPosition
- Int32
文字周圍的新數據指標位置,以 Java 字元表示。 如果 > 為 0,則相對於文字結尾 - 1;如果 <= 0,則相對於文字開頭。 因此,值 1 一律會將游標前進到插入全文之後的位置。 請注意,這表示您無法將游標放置在文字內,因為編輯器可以修改您提供的文字,因此無法正確指定該處的位置。
傳回
true 表示成功,如果輸入連接不再有效,則為 false。
- 屬性
備註
將文字認可至文本框,並設定新的游標位置。
此方法會移除目前撰寫文字的內容,並將它取代為傳遞的 CharSequence,然後根據 newCursorPosition
移動游標。 如果呼叫此方法時沒有撰寫文字,則會在游標位置插入新的文字,並移除選取範圍內的文字。 其行為就像呼叫 #setComposingText(CharSequence, int) setComposingText(text, newCursorPosition)
然後 #finishComposingText()
。
呼叫這個方法會導致編輯器在批次輸入結束之後,於目前的 IME 上呼叫 android.inputmethodservice.InputMethodService#onUpdateSelection(int, int, int, int, int, int)
。 <強>編輯器作者</強>,若要發生這種情況,您必須呼叫 InputMethodManager#updateSelection(View, int, int, int, int)
來對輸入法進行已知的變更,但請小心等候批次編輯是否正在進行中。
的 android.view.inputmethod.InputConnection.commitText(java.lang.CharSequence, int)
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
CommitText(ICharSequence, Int32, TextAttribute)
的 InputConnection#commitText(CharSequence, int)
變體。
[Android.Runtime.Register("commitText", "(Ljava/lang/CharSequence;ILandroid/view/inputmethod/TextAttribute;)Z", "GetCommitText_Ljava_lang_CharSequence_ILandroid_view_inputmethod_TextAttribute_Handler:Android.Views.InputMethods.IInputConnection, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=33)]
public virtual bool CommitText (Java.Lang.ICharSequence text, int newCursorPosition, Android.Views.InputMethods.TextAttribute? textAttribute);
[<Android.Runtime.Register("commitText", "(Ljava/lang/CharSequence;ILandroid/view/inputmethod/TextAttribute;)Z", "GetCommitText_Ljava_lang_CharSequence_ILandroid_view_inputmethod_TextAttribute_Handler:Android.Views.InputMethods.IInputConnection, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=33)>]
abstract member CommitText : Java.Lang.ICharSequence * int * Android.Views.InputMethods.TextAttribute -> bool
override this.CommitText : Java.Lang.ICharSequence * int * Android.Views.InputMethods.TextAttribute -> bool
參數
- text
- ICharSequence
要認可的文字。 這可能包括樣式。
- newCursorPosition
- Int32
文字周圍的新數據指標位置,以 Java 字元表示。 如果 > 為 0,則相對於文字結尾 - 1;如果 <= 0,則相對於文字開頭。 因此,值 1 一律會將游標前進到插入全文之後的位置。 請注意,這表示您無法將游標放置在文字內,因為編輯器可以修改您提供的文字,因此無法正確指定該處的位置。
- textAttribute
- TextAttribute
文字的額外資訊。
傳回
true 表示成功,如果輸入連接不再為 false
- 屬性
備註
的 InputConnection#commitText(CharSequence, int)
變體。 這個方法可用來允許輸入法在設定文字時提供額外的資訊。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
CommitText(String, Int32, TextAttribute)
的 InputConnection#commitText(CharSequence, int)
變體。
public virtual bool CommitText (string text, int newCursorPosition, Android.Views.InputMethods.TextAttribute? textAttribute);
abstract member CommitText : string * int * Android.Views.InputMethods.TextAttribute -> bool
override this.CommitText : string * int * Android.Views.InputMethods.TextAttribute -> bool
參數
- text
- String
要認可的文字。 這可能包括樣式。
- newCursorPosition
- Int32
文字周圍的新數據指標位置,以 Java 字元表示。 如果 > 為 0,則相對於文字結尾 - 1;如果 <= 0,則相對於文字開頭。 因此,值 1 一律會將游標前進到插入全文之後的位置。 請注意,這表示您無法將游標放置在文字內,因為編輯器可以修改您提供的文字,因此無法正確指定該處的位置。
- textAttribute
- TextAttribute
文字的額外資訊。
傳回
true 表示成功,如果輸入連接不再為 false
備註
的 InputConnection#commitText(CharSequence, int)
變體。 這個方法可用來允許輸入法在設定文字時提供額外的資訊。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。