IInputConnection.GetTextBeforeCursorFormatted(Int32, GetTextFlags) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在のカーソル位置の前にあるテキストの var>n</var> 文字を取得<します。
[Android.Runtime.Register("getTextBeforeCursor", "(II)Ljava/lang/CharSequence;", "GetGetTextBeforeCursor_IIHandler:Android.Views.InputMethods.IInputConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.Lang.ICharSequence? GetTextBeforeCursorFormatted (int n, Android.Views.InputMethods.GetTextFlags flags);[<Android.Runtime.Register("getTextBeforeCursor", "(II)Ljava/lang/CharSequence;", "GetGetTextBeforeCursor_IIHandler:Android.Views.InputMethods.IInputConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member GetTextBeforeCursorFormatted : int * Android.Views.InputMethods.GetTextFlags -> Java.Lang.ICharSequenceパラメーター
- n
- Int32
テキストの予想される長さ。 これは負でない必要があります。
- flags
- GetTextFlags
テキストの返し方を制御する追加のオプションを提供します。 のいずれかまたは#GET_TEXT_WITH_STYLES.0
戻り値
カーソル位置の前のテキスト。返されるテキストの長さが var>n</var> より<小さい場合があります。
- 属性
注釈
現在のカーソル位置の前にあるテキストの var>n</var> 文字を取得<します。
このメソッドは、入力接続が無効になった場合 (プロセスのクラッシュなど) か、エディターがテキストで応答するのに時間がかかりすぎる場合 (返すのに数秒かかる場合) に失敗する可能性があります。 どちらの場合も、null が返されます。 このメソッドは、エディター内のテキストに何らかの影響を与えることはなく、選択範囲や作成スパンにも影響しません。
フラグとして指定した場合 #GET_TEXT_WITH_STYLES 、エディターはテキストに設定されているすべてのスパンを含む a android.text.SpannableString を返す必要があります。
<強力な>IME 作成者:</strong> は、時間がかかる IPC ラウンド トリップをトリガーすることを検討してください。 この方法で時間がかかるとします。 また、エディターは、パフォーマンス上の理由から使用できる場合でも、要求された文字よりも少ない文字数を返すように選択する場合があることに注意してください。 これを使用してカーソルの周りの最初のテキストを取得する場合は、IPC コストを回避するために 、、EditorInfo#getInitialSelectedText(int)をEditorInfo#getInitialTextAfterCursor(int, int)使用EditorInfo#getInitialTextBeforeCursor(int, int)することを検討してください。
<強力な>編集者:</強く> 、この呼び出しを実装する上で競合状態に注意してください。 IME はテキストを変更し、すぐにこのメソッドを使用できます。返される値が最新の編集の結果と一致していることを確認する必要があります。 また、パフォーマンスによって決まる場合は n 文字未満を返すこともできますが、IME は多くの関数でこれを利用することに注意してください。たとえば、戻り値を現在の行に制限しないでください。特に、カーソルが実際にテキストの先頭にある場合を除き、0 文字を返さないでください。
の Java ドキュメントandroid.view.inputmethod.InputConnection.getTextBeforeCursor(int, int)
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。