IInputConnection.GetSurroundingText(Int32, Int32, Int32) メソッド

定義

現在のカーソル <の周囲のテキストを取得します。カーソルの前のテキストの var>beforeLength</var> 文字 (選択範囲の開始)、 <カーソルの後のテキストの var>afterLength</var> 文字 (選択範囲の末尾)、および選択したすべてのテキストを取得します。

[Android.Runtime.Register("getSurroundingText", "(III)Landroid/view/inputmethod/SurroundingText;", "GetGetSurroundingText_IIIHandler:Android.Views.InputMethods.IInputConnection, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=31)]
public virtual Android.Views.InputMethods.SurroundingText? GetSurroundingText (int beforeLength, int afterLength, int flags);
[<Android.Runtime.Register("getSurroundingText", "(III)Landroid/view/inputmethod/SurroundingText;", "GetGetSurroundingText_IIIHandler:Android.Views.InputMethods.IInputConnection, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=31)>]
abstract member GetSurroundingText : int * int * int -> Android.Views.InputMethods.SurroundingText
override this.GetSurroundingText : int * int * int -> Android.Views.InputMethods.SurroundingText

パラメーター

beforeLength
Int32

カーソルの前のテキストの予想される長さ。

afterLength
Int32

カーソルの後のテキストの予想される長さ。

flags
Int32

テキストの返し方を制御する追加のオプションを提供します。 または #GET_TEXT_WITH_STYLESのいずれかを0指定できます。

戻り値

android.view.inputmethod.SurroundingText周囲のテキストと選択範囲の状態を記述するオブジェクト。入力接続が無効になった場合、またはエディターが何らかの理由で要求に準拠できない場合、またはアプリケーションがこのメソッドを実装していない場合は null。 返されるテキストの長さは、var beforeLength/var と var>afterLength<</var>> の合計<より小さい場合があります。><

属性

注釈

現在のカーソル <の周囲のテキストを取得します。カーソルの前のテキストの var>beforeLength</var> 文字 (選択範囲の開始)、 <カーソルの後のテキストの var>afterLength</var> 文字 (選択範囲の末尾)、および選択したすべてのテキストを取得します。 範囲は java 文字用であり、複数の文字を使用できるグリフではありません。

このメソッドは、入力接続が無効になった場合 (プロセスのクラッシュなど)、クライアントがテキストで応答するのに時間がかかりすぎる (返されるまでに数秒かかる) か、プロトコルがサポートされていない場合に失敗する可能性があります。 いずれの場合も、null が返されます。

このメソッドは、エディター内のテキストに何らかの影響を与えることはなく、選択範囲や作成スパンにも影響しません。

がフラグとして指定されている場合 #GET_TEXT_WITH_STYLES 、エディターは、テキストに設定されているすべてのスパンを含む を返す android.text.Spanned 必要があります。

<強力な>IME 作成者:</strong> これは、時間がかかる IPC ラウンドトリップをトリガーすることを検討してください。 このメソッドが多くの時間を消費するとします。 これを使用してカーソルの周囲の最初のテキストを取得する場合は、、、 EditorInfo#getInitialTextAfterCursor(int, int) を使用EditorInfo#getInitialSelectedText(int)EditorInfo#getInitialTextBeforeCursor(int, int)して IPC のコストを回避することを検討してください。

の Java ドキュメント android.view.inputmethod.InputConnection.getSurroundingText(int, int, int)

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象