このページは Cloud Translation API によって翻訳されました。

テキストフィールドのタッチペン入力

Android 14（API レベル 34）以降では、ユーザーが任意のテキスト入力に書き込める通知を受け取ることができます。以下を含む Android のテキスト入力フィールド EditText コンポーネントと WebView テキストウィジェット、サポートタッチペン入力がデフォルトになりました。

ただし、アプリがカスタムテキスト入力フィールドを必要とする場合は（カスタムテキストエディタ）または描画サーフェスの上にテキスト入力フィールドが重なる複雑なレイアウトの場合は、アプリをカスタマイズする必要があります

図 1. タッチペンによる手書き入力。

`EditText`

Android 14 では、すべての EditText フィールドでタッチペン手書き入力がデフォルトで有効以上です。タッチペンを動かすと、EditText の手書き入力モードが開始されます。イベントが、ビューの手書き境界内で検出されます。

手書き入力の境界には、垂直方向のパディング 40 dp、水平方向のパディング 10 dp が含まれます。パディングされます。手書き入力の境界を調整する setHandwritingBoundsOffsets()。手書き入力を無効にする setAutoHandwritingEnabled(false)。

タッチペンのモーションイベントの検出範囲を示す周囲四角形を入力フィールド。 — **図 2.** `EditText` フィールドの手書き入力境界。

入力の委任

アプリは、テキスト入力フィールドのように見えるプレースホルダ UI 要素を表示できますが、実際には、テキスト入力機能のない静的な UI 要素です。検索一般的な例です。静的な UI 要素をタップすると遷移がトリガーされる入力用にフォーカスされた機能的テキスト入力フィールドを含む新しい UI です。

図 3. 静的 UI 要素からテキスト入力フィールドへの入力の委任。

タッチペン入力の委任

手書き入力委任 API を使用して、タッチペンの手書き入力をサポートするプレースホルダの入力フィールド（ setHandwritingDelegatorCallback() および setIsHandwritingDelegate()）。プレースホルダ UI 要素は、手書き入力を機能に委任するように設定されています。例:

Kotlin

if (Build.VERSION.SDK_INT >= 34) {
    placeholderInputField.setHandwritingDelegatorCallback {
        showAndFocusDelegateInputField()
    }
    delegateInputField.setIsHandwritingDelegate(true)
}

Java

if (Build.VERSION.SDK_INT >= 34) {
    placeholderInputField.setHandwritingDelegatorCallback(this::showAndFocusInputFieldDelegate);
    delegateInputField.setIsHandwritingDelegate(true);
}

プレースホルダのテキスト入力フィールドビュー上でタッチペンを動かすと、コールバックが呼び出されます。コールバックが UI 遷移をトリガーし、機能入力を表示してフォーカスする表示されます。コールバックの実装は通常、追加することをおすすめしますファンクション入力フィールドがが、 InputConnection タッチペン手書き入力モードが開始されます。

図 4. 静的 UI 要素からテキスト入力フィールドへのタッチペン入力の委任。

マテリアルデザイン

「 com.google.android.material.search ライブラリは、 SearchBar、 SearchView クラスプレースホルダ UI パターンを簡単に実装できます。

プレースホルダビューと機能検索ビューは、 setUpWithSearchBar()。

手書き入力の委任はマテリアルライブラリで設定でき、追加の操作は必要ありません開発する必要があります

描画サーフェスと重なっている

アプリに描画サーフェスがあり、そのサーフェスにテキストフィールドが重なっている場合は、ユーザーが描画できるように、タッチペンの手書き入力を無効にしなければならない場合があります。詳しくは、 setAutoHandwritingEnabled()。

テスト

タッチペンでの手書き入力は、以下を搭載した Android 14 以降のデバイスでサポートされています。対応するタッチペン入力デバイスと入力方法エディタ（IME）が起動され、 Android 14 のタッチペン手書き API をサポートしています。

タッチペン入力デバイスがない場合は、任意のデバイスでタッチペン入力をシミュレートします次の Android Debug Bridge を使用して、root アクセス権（エミュレータを含む）でアクセスできる（adb）コマンド:


// Android 14
adb shell setprop persist.debug.input.simulate_stylus_with_touch true && adb shell stop && adb shell start

// Android 15 and higher
// Property takes effect after screen reconfiguration such as orientation change.
adb shell setprop debug.input.simulate_stylus_with_touch true

対応していないデバイスを使用している場合、テストには Gboard のベータ版を使用してくださいタッチペン。

参考情報

マテリアルデザイン - テキストフィールド
カスタムテキストエディタ