IInputConnectionExtensions.SetComposingText メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| Name | 説明 |
|---|---|
| SetComposingText(IInputConnection, String, Int32) |
現在作成中のテキストを特定のテキストに置き換え、新しいカーソル位置を設定します。 |
| SetComposingText(IInputConnection, String, Int32, TextAttribute) |
setComposingText(CharSequence,int) のバリアント。 |
SetComposingText(IInputConnection, String, Int32)
現在作成中のテキストを特定のテキストに置き換え、新しいカーソル位置を設定します。
public static bool SetComposingText(this Android.Views.InputMethods.IInputConnection self, string? text, int newCursorPosition);
static member SetComposingText : Android.Views.InputMethods.IInputConnection * string * int -> bool
パラメーター
- self
- IInputConnection
メソッドを呼び出す入力接続。
- text
- String
作成中のテキスト。 テキストを作成するための既定のスタイルが使用されます。
- newCursorPosition
- Int32
テキストの周囲の新しいカーソル位置。 > 0 の場合、これはテキストの末尾を基準にして 1 になります。<= 0 の場合、これはテキストの先頭を基準にしています。 したがって、値 1 は、常にフルテキストの挿入後の位置に進みます。 これは、指定したテキストをエディターが変更できるため、カーソルをテキスト内に配置できないことに注意してください。これにより、場所を正しく指定できません。
戻り値
成功した場合は true、入力接続が無効な場合は false。
注釈
現在作成中のテキストを特定のテキストに置き換え、新しいカーソル位置を設定します。 以前に作成したテキスト セットはすべて自動的に削除されます。
現在アクティブな構成スパンがある場合は、構成されているすべての文字が削除されます。 渡されたテキストがその場所に追加され、作成スパンがこのテキストに追加されます。 作成スパンがアクティブでない場合は、渡されたテキストがカーソル位置に追加され (存在する場合は、最初に選択した文字が削除されます)、新しいテキストに作成スパンが追加されます。 最後に、カーソルは newCursorPosition で指定された場所に移動されます。
これは通常、IME によって呼び出され、作成スパン内の文字を追加または削除または変更します。 このメソッドを呼び出すと、バッチ入力が終了した後、エディターは現在の IME で InputMethodService.onUpdateSelection(int, int, int, int, int, int, int) を呼び出します。
編集者: テキストは、呼び出し時に作成スパンにあった内容と非常に似ているか、まったく異なる場合や、作成スパンがない可能性があることに注意してください。 一般的な使用ではありませんが、文字列が空の場合があることに注意してください。 現在作成中のテキストを空の文字列に置き換えて、これを通常どおりに扱います。 また、カーソル位置には注意してください。 IME は、上記とまったく同じように、この動作に依存します。 これによりエディターの内容が変更されるため、InputMethodManager.updateSelection(android.view.View,int,int,int,int,int) を呼び出して入力メソッドに変更を反映させる必要がありますが、バッチ編集が進行中の場合は、バッチ編集が終了するまで待つよう注意してください。 このメソッドは、作成中のテキストの端または全体の外側にカーソル位置を設定できますが、IME は後続の呼び出しで作成テキスト内にカーソル位置を移動する場合もあります。そのため、作成テキストと選択範囲は完全に独立しています。
android.view.inputmethod.InputConnection.setComposingTextの Android リファレンス。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
SetComposingText(IInputConnection, String, Int32, TextAttribute)
setComposingText(CharSequence,int) のバリアント。
public static bool SetComposingText(this Android.Views.InputMethods.IInputConnection self, string text, int newCursorPosition, Android.Views.InputMethods.TextAttribute? textAttribute);
static member SetComposingText : Android.Views.InputMethods.IInputConnection * string * int * Android.Views.InputMethods.TextAttribute -> bool
パラメーター
- self
- IInputConnection
メソッドを呼び出す入力接続。
- text
- String
作成中のテキスト。 テキストを作成するための既定のスタイルが使用されます。 この値は null にすることはできません。
- newCursorPosition
- Int32
テキストの周囲の新しいカーソル位置。 > 0 の場合、これはテキストの末尾を基準にして 1 になります。<= 0 の場合、これはテキストの先頭を基準にしています。 したがって、値 1 は、常にフルテキストの挿入後の位置に進みます。 これは、指定したテキストをエディターが変更できるため、カーソルをテキスト内に配置できないことに注意してください。これにより、場所を正しく指定できません。
- textAttribute
- TextAttribute
テキストに関する追加情報。 この値は null である可能性があります。
戻り値
成功した場合は true、入力接続が無効な場合は false。
注釈
setComposingText(CharSequence,int) のバリアント。 このメソッドは、IME がテキストの作成中に追加情報を提供できるようにするために使用されます。
android.view.inputmethod.InputConnection.setComposingTextの Android リファレンス。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。