AccessibilityNodeProvider クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。
[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
- 継承
- 属性
注釈
このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。 仮想ビュー階層は、 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> -> {
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> -> {
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 -> 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 -> {
// Implement logic in a separate method.
navigateToPreviousMonth()
return true
}
ACTION_SCROLL_DOWN.id ->
// Implement logic in a separate method.
navigateToNextMonth()
return true
else -> 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;
}
@Override
public AccessibilityNodeProvider getAccessibilityNodeProvider(View host) {
return new AccessibilityNodeProvider() {
@Override
@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;
}
}
@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>
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
コンストラクター
| Name | 説明 |
|---|---|
| AccessibilityNodeProvider() | |
| AccessibilityNodeProvider(IntPtr, JniHandleOwnership) |
JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。 |
フィールド
| Name | 説明 |
|---|---|
| HostViewId |
ホスティング ビューの仮想 ID。 |
プロパティ
| Name | 説明 |
|---|---|
| Class |
この |
| 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) |
追加データの明示的な要求に基づいて、 |
| Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。 (継承元 JavaObject) |
| CreateAccessibilityNodeInfo(Int32) |
指定された |
| Dispose() |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| Dispose(Boolean) |
このJava ピアによって保持されているリソースを解放します。 (継承元 Object) |
| DisposeUnlessReferenced() |
このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。 (継承元 JavaObject) |
| Equals(Object) |
このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。 (継承元 JavaObject) |
| Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
| FindAccessibilityNodeInfosByText(String, Int32) |
テキストで |
| FindFocus(NodeFocus) |
指定したフォーカスの種類を持つ仮想ビュー (ホスト ビューの子孫など) を検索します。 |
| GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
| JavaFinalize() |
古い.
オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
| Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
| NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
| PerformAction(Int32, Action, Bundle) |
指定された |
| PerformAction(Int32, GlobalAction, Bundle) |
仮想ビュー (ホスト ビューの子孫) に対して、指定された |
| 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) |
インスタンス |
| JavaAs<TResult>(IJavaPeerable) |
|
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
このクラスは、ユーザー補助のために特定のビューをルートとする仮想ビュー階層のサポートを有効にするためにクライアントが実装する必要があるコントラクトです。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
|