Language

AccessibilityNodeProvider クラス

定義

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

[Android.Runtime.Register("android/view/accessibility/AccessibilityNodeProvider", DoNotGenerateAcw=true)]
public abstract class AccessibilityNodeProvider : Java.Lang.Object
[<Android.Runtime.Register("android/view/accessibility/AccessibilityNodeProvider", DoNotGenerateAcw=true)>]
type AccessibilityNodeProvider = class
    inherit Object
継承
AccessibilityNodeProvider
属性

注釈

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。 仮想ビュー階層は、 AccessibilityService がウィンドウの内容を調べるときにビュー階層の一部として報告される架空のビューのツリーです。 仮想ビュー ツリーは存在しないため、このクラスは、そのツリーをアクセシビリティ サービスに記述する AccessibilityNodeInfoを管理する役割を担います。 /p< を >する

これらの API の主なユース ケースは、月単位のカレンダー グリッドなどの複雑なコンテンツを描画するカスタム ビューを論理ノードのツリー (たとえば、イベントを含む月日など) として表示し、その論理構造を伝えるようにすることです。

一般的なユース ケースは、仮想ビュー階層のルートであるビューの View#getAccessibilityNodeProvider() をオーバーライドして、このクラスのインスタンスを返します。 このような場合、このインスタンスは、ビュー自体を表すものも含め、ビューに根ざした仮想サブツリーを記述する AccessibilityNodeInfoを管理します。 同様に、返されるインスタンスは、任意の仮想ビューまたはルート ビュー自体に対してアクセシビリティ アクションを実行します。 例えば次が挙げられます。

"note"><b>Note:</b> AccessibilityNodeProvider のユーティリティ拡張機能である <c>androidx.customview.widget.ExploreByTouchHelper</c> を使用して、アクセシビリティ サービスに情報を提供し、アクセシビリティ フォーカスを管理する多くの側面を簡略化することを検討してください。 </aside><div><div class="ds-selector-tabs"><section><h3 id="kotlin">Kotlin</h3>

// "view" is the View instance on which this class performs accessibility functions.
            class MyCalendarViewAccessibilityDelegate(
                  private var view: MyCalendarView) : AccessibilityDelegate() {
                override fun getAccessibilityNodeProvider(host: View): AccessibilityNodeProvider {
                    return object : AccessibilityNodeProvider() {
                        override fun createAccessibilityNodeInfo(virtualViewId: Int):
                                AccessibilityNodeInfo? {
                            when (virtualViewId) {
<var>host-view-id</var> -&gt; {
                                    val node = AccessibilityNodeInfo.obtain(view)
                                    node.addChild(view, <var>child-view-id</var>)
                                    // Set other attributes like screenReaderFocusable
                                    // and contentDescription.
                                    return node
                                }
<var>child-view-id</var> -&gt; {
                                    val node = AccessibilityNodeInfo
                                            .obtain(view, virtualViewId)
                                    node.setParent(view)
                                    node.addAction(ACTION_SCROLL_UP)
                                    node.addAction(ACTION_SCROLL_DOWN)
                                    // Set other attributes like focusable and visibleToUser.
                                    node.setBoundsInScreen(
                                            Rect(<var>coords-of-edges-relative-to-screen</var>))
                                    return node
                                }
                                else -&gt; return null
                            }
                        }

                        override fun performAction(
                            virtualViewId: Int,
                            action: Int,
                            arguments: Bundle
                        ): Boolean {
                            if (virtualViewId == <var>host-view-id</var>) {
                                return view.performAccessibilityAction(action, arguments)
                            }
                            when (action) {
                                ACTION_SCROLL_UP.id -&gt; {
                                    // Implement logic in a separate method.
                                    navigateToPreviousMonth()

                                    return true
                                }
                                ACTION_SCROLL_DOWN.id -&gt;
                                    // Implement logic in a separate method.
                                    navigateToNextMonth()

                                    return true
                                else -&gt; return false
                            }
                        }
                    }
                }
            }

</section><section><h3 id="java">Java</h3>

final class MyCalendarViewAccessibilityDelegate extends AccessibilityDelegate {
                // The View instance on which this class performs accessibility functions.
                private final MyCalendarView view;

                MyCalendarViewAccessibilityDelegate(MyCalendarView view) {
                    this.view = view;
                }

                &#64;Override
                public AccessibilityNodeProvider getAccessibilityNodeProvider(View host) {
                    return new AccessibilityNodeProvider() {
                        &#64;Override
                        &#64;Nullable
                        public AccessibilityNodeInfo createAccessibilityNodeInfo(int virtualViewId) {
                            if (virtualViewId == <var>host-view-id</var>) {
                                AccessibilityNodeInfo node = AccessibilityNodeInfo.obtain(view);
                                node.addChild(view, <var>child-view-id</var>);
                                // Set other attributes like screenReaderFocusable and contentDescription.
                                return node;
                            } else if (virtualViewId == <var>child-view-id</var>) {
                                AccessibilityNodeInfo node =
                                    AccessibilityNodeInfo.obtain(view, virtualViewId);
                                node.setParent(view);
                                node.addAction(ACTION_SCROLL_UP);
                                node.addAction(ACTION_SCROLL_DOWN);
                                // Set other attributes like focusable and visibleToUser.
                                node.setBoundsInScreen(
                                    new Rect(<var>coordinates-of-edges-relative-to-screen</var>));
                                return node;
                            } else {
                                return null;
                            }
                        }

                        &#64;Override
                        public boolean performAction(int virtualViewId, int action, Bundle arguments) {
                            if (virtualViewId == <var>host-view-id</var>) {
                                return view.performAccessibilityAction(action, arguments);
                            }

                            if (action == ACTION_SCROLL_UP.getId()) {
                                // Implement logic in a separate method.
                                navigateToPreviousMonth();

                                return true;
                            } else if (action == ACTION_SCROLL_DOWN.getId()) {
                                // Implement logic in a separate method.
                                navigateToNextMonth();

                                return true;
                            } else {
                                return false;
                            }
                        }
                    };
                }
            }

</section></div></div>

Javaドキュメント。

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

コンストラクター

Name 説明
AccessibilityNodeProvider()
AccessibilityNodeProvider(IntPtr, JniHandleOwnership)

JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。

フィールド

Name 説明
HostViewId

ホスティング ビューの仮想 ID。

プロパティ

Name 説明
Class

この Objectのランタイム クラスを返します。

(継承元 Object)
Handle

基になる Android インスタンスへのハンドル。

(継承元 Object)
JniIdentityHashCode

相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。

(継承元 Object)
JniManagedPeerState

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

(継承元 JavaObject)
JniPeerMembers

このJava バインドのメンバーにアクセスするために使用される JNI メタデータを取得します。

PeerReference

このJava ピアの JNI オブジェクト参照を取得します。

(継承元 Object)
ThresholdClass

この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

ThresholdType

この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

メソッド

Name 説明
AddExtraDataToAccessibilityNodeInfo(Int32, AccessibilityNodeInfo, String, Bundle)

追加データの明示的な要求に基づいて、 AccessibilityNodeInfo に追加データを追加します。

Clone()

このオブジェクトのコピーを作成して返します。

(継承元 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

(継承元 JavaObject)
CreateAccessibilityNodeInfo(Int32)

指定されたAccessibilityNodeInfoを持つホスト ビューの子孫などの仮想ビューを表すvirtualViewIdを返します。また、virtualViewIdが #HOST_VIEW_ID と等しい場合はホスト ビュー自体を返します。

Dispose()

このJava ピアによって保持されているリソースを解放します。

(継承元 Object)
Dispose(Boolean)

このJava ピアによって保持されているリソースを解放します。

(継承元 Object)
DisposeUnlessReferenced()

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

(継承元 JavaObject)
Equals(Object)

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

(継承元 JavaObject)
Equals(Object)

他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。

(継承元 Object)
FindAccessibilityNodeInfosByText(String, Int32)

テキストで AccessibilityNodeInfoを検索します。

FindFocus(NodeFocus)

指定したフォーカスの種類を持つ仮想ビュー (ホスト ビューの子孫など) を検索します。

GetHashCode()

オブジェクトのハッシュ コード値を返します。

(継承元 Object)
JavaFinalize()
古い.

オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。

(継承元 Object)
Notify()

このオブジェクトのモニターで待機している 1 つのスレッドを起動します。

(継承元 Object)
NotifyAll()

このオブジェクトのモニターで待機しているすべてのスレッドを起動します。

(継承元 Object)
PerformAction(Int32, Action, Bundle)

指定されたvirtualViewIdを持つホスト ビューの子孫や、ホスト ビュー自体 (virtualViewIdと等しい場合) #HOST_VIEW_ID、仮想ビューに対してアクセシビリティ アクションを実行します。

PerformAction(Int32, GlobalAction, Bundle)

仮想ビュー (ホスト ビューの子孫) に対して、指定された virtualViewId またはホスト ビュー自体 ( virtualViewId が HostViewId と等しい場合) に対してアクセシビリティ アクションを実行します。

SetHandle(IntPtr, JniHandleOwnership)

Handle プロパティを設定します。

(継承元 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

(継承元 JavaObject)
ToArray<T>()

このJava配列ラッパーからマネージド配列を作成します。

(継承元 Object)
ToString()

オブジェクトの文字列形式を返します。

(継承元 Object)
UnregisterFromRuntime()

相互運用ランタイムからこのJava ピアの登録を解除します。

(継承元 Object)
Wait()

現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。

(継承元 Object)
Wait(Int64, Int32)

現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。

(継承元 Object)
Wait(Int64)

現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。

(継承元 Object)

明示的なインターフェイスの実装

Name 説明
IJavaPeerable.Disposed()

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

(継承元 JavaObject)
IJavaPeerable.Finalized()

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

(継承元 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

(継承元 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

(継承元 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

(継承元 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

(継承元 JavaObject)

拡張メソッド

Name 説明
GetJniTypeName(IJavaPeerable)

インスタンス selfの型の JNI 名を取得します。

JavaAs<TResult>(IJavaPeerable)

selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。

JavaCast<TResult>(IJavaObject)

Android ランタイムチェック型変換を実行します。

JavaCast<TResult>(IJavaObject)

このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。

TryJavaCast<TResult>(IJavaPeerable, TResult)

selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。

適用対象