AccessibilityNodeProvider Classe

Definizione

[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

Ereditarietà

Object

JavaObject

Object

AccessibilityNodeProvider

Attributi

RegisterAttribute

Commenti

Questa classe è il contratto che un client deve implementare per abilitare il supporto di una gerarchia di viste virtuali rooted in una determinata visualizzazione a scopo di accessibilità. Una gerarchia di visualizzazione virtuale è un albero di visualizzazioni immaginarie segnalate come parte della gerarchia di visualizzazione quando un AccessibilityService oggetto esplora il contenuto della finestra. Poiché l'albero di visualizzazione virtuale non esiste, questa classe è responsabile della gestione dell'albero AccessibilityNodeInfoche descrive tale albero ai servizi di accessibilità. </p>

Il caso d'uso principale di queste API consiste nell'abilitare una visualizzazione personalizzata che disegna contenuto complesso, ad esempio una griglia di calendario mensile, da presentare come albero di nodi logici, ad esempio i giorni del mese, ognuno dei quali contiene eventi, trasmettendone così la struttura logica.

Un caso d'uso tipico consiste nell'eseguire l'override View#getAccessibilityNodeProvider() della vista che è una radice di una gerarchia di visualizzazione virtuale per restituire un'istanza di questa classe. In questo caso, questa istanza è responsabile della gestione AccessibilityNodeInfodi s che descrive il sottoalbero virtuale radicato nella visualizzazione, incluso quello che rappresenta la vista stessa. Analogamente, l'istanza restituita è responsabile dell'esecuzione di azioni di accessibilità in qualsiasi visualizzazione virtuale o nella visualizzazione radice stessa. Per esempio:

"nota"><b Nota:>/b<> Prendere in considerazione l'uso di un <c>androidx.customview.widget.ExploreByTouchHelper</c>, un'estensione dell'utilità di AccessibilityNodeProvider, per semplificare molti aspetti della fornitura di informazioni ai servizi di accessibilità e la gestione dell'accessibilità. </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>

per android.view.accessibility.AccessibilityNodeProvider.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.