AccessibilityNodeProvider Klasse

Definition

[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

Vererbung

Object

JavaObject

Object

AccessibilityNodeProvider

Attribute

RegisterAttribute

Hinweise

Diese Klasse ist der Vertrag, den ein Client implementieren sollte, um die Unterstützung einer virtuellen Ansichtshierarchie zu ermöglichen, die in einer bestimmten Ansicht für Barrierefreiheitszwecke verwurzelt ist. Eine virtuelle Ansichtshierarchie ist eine Struktur von imaginären Ansichten, die als Teil der Ansichtshierarchie gemeldet wird, wenn ein AccessibilityService Fensterinhalt untersucht wird. Da die virtuelle Ansichtsstruktur nicht vorhanden ist, ist diese Klasse für die Verwaltung der Struktur verantwortlich, die AccessibilityNodeInfodiese Struktur für Barrierefreiheitsdienste beschreibt. </p>

Der Hauptanwendungsfall dieser APIs besteht darin, eine benutzerdefinierte Ansicht zu ermöglichen, die komplexe Inhalte zeichnet, z. B. ein monatliches Kalenderraster, als Struktur von logischen Knoten dargestellt werden, z. B. Monatstage, die ereignisse enthalten, und so die logische Struktur vermitteln.

Ein typischer Anwendungsfall besteht darin, die Ansicht außer Kraft zu setzen View#getAccessibilityNodeProvider() , die ein Stamm einer virtuellen Ansichtshierarchie ist, um eine Instanz dieser Klasse zurückzugeben. In einem solchen Fall ist diese Instanz für die Verwaltung AccessibilityNodeInfovon Objekten verantwortlich, die die virtuelle Unterstruktur beschreiben, die in der Ansicht verwurzelt ist, einschließlich der Struktur, die die Ansicht selbst darstellt. Ebenso ist die zurückgegebene Instanz für das Ausführen von Barrierefreiheitsaktionen für jede virtuelle Ansicht oder die Stammansicht selbst verantwortlich. Beispiel:

"note">b Note:</b> Consider using a <c>androidx.customview.widget.ExploreByTouchHelper</c>, a utility extension of AccessibilityNodeProvider, to simplify many aspects of providing information to accessibility services and managing accessibility focus.<> </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><><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;
                            }
                        }

                        &#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 Dokumentation für android.view.accessibility.AccessibilityNodeProvider.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.