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