AccessibilityEvent Klasse

Definition

[Android.Runtime.Register("android/view/accessibility/AccessibilityEvent", DoNotGenerateAcw=true)]
public sealed class AccessibilityEvent : Android.Views.Accessibility.AccessibilityRecord, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/view/accessibility/AccessibilityEvent", DoNotGenerateAcw=true)>]
type AccessibilityEvent = class
    inherit AccessibilityRecord
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Vererbung

Object

Object

AccessibilityRecord

AccessibilityEvent

Attribute

RegisterAttribute

Implementiert

IParcelable IJavaObject IJavaPeerable IDisposable

Hinweise

Diese Klasse stellt Barrierefreiheitsereignisse dar, die vom System gesendet werden, wenn auf der Benutzeroberfläche etwas Bemerkenswertes geschieht. Wenn z. B. auf einen android.widget.Button Klick geklickt wird, ist ein android.view.View Fokus usw.

Ein Barrierefreiheitsereignis wird durch eine einzelne Ansicht ausgelöst, die das Ereignis mit Daten für den Status auffüllt und von seinem übergeordneten Element anfordert, das Ereignis an interessierte Parteien zu senden. Das übergeordnete Element kann das Ereignis optional ändern oder sogar blockieren, basierend auf seinem umfassenderen Verständnis des Kontexts der Benutzeroberfläche.

Der Hauptzweck eines Barrierefreiheitsereignisses besteht darin, Änderungen an der Benutzeroberfläche an eine android.accessibilityservice.AccessibilityServiceBarrierefreiheit zu kommunizieren. Bei Bedarf kann der Dienst die Benutzeroberfläche überprüfen, indem die Ansichtshierarchie über die Ereignishierarchie #getSource() sourceuntersucht wird, wie durch eine Struktur der AccessibilityNodeInfoEreignisse dargestellt (Momentaufnahme eines Ansichtszustands), die zum Untersuchen des Fensterinhalts verwendet werden kann. Beachten Sie, dass die Berechtigung für den Zugriff auf die Quelle eines Ereignisses, also der Fensterinhalt, explizit angefordert werden muss. Weitere Informationen finden Sie unter android.accessibilityservice.AccessibilityService. Wenn ein Barrierefreiheitsdienst nicht angefordert hat, den Fensterinhalt abzurufen, enthält das Ereignis keinen Verweis auf seine Quelle. <strong Note: </strong>> for events of type #TYPE_NOTIFICATION_STATE_CHANGED the source is never available, and Views that set android.view.View#isAccessibilityDataSensitive() may not populate all event properties on events sent from higher up in the view hierarchy.

Diese Klasse stellt verschiedene semantisch unterschiedliche Barrierefreiheitsereignistypen dar. Jeder Ereignistyp verfügt über einen zugeordneten Satz verwandter Eigenschaften. Mit anderen Worten, jeder Ereignistyp wird durch eine Teilmenge der Eigenschaften gekennzeichnet, die von dieser Klasse verfügbar gemacht werden. Für jeden Ereignistyp gibt es eine entsprechende Konstante, die in dieser Klasse definiert ist. Folgt einer Spezifikation der Ereignistypen und der zugehörigen Eigenschaften:

<div class="special reference"><h3>Developer Guides</h3>

Weitere Informationen zum Erstellen und Verarbeiten von AccessibilityEvents finden Sie im Entwicklerhandbuch für Barrierefreiheit .

</Div>

<b>ANSICHTSTYPEN</b></br>

<b>Ansicht geklickt</b> - stellt das Ereignis des Klickens auf ein android.view.View ähnliches android.widget.Button, android.widget.CompoundButtonusw. dar.</br><em>Type:</em/br><em><#TYPE_VIEW_CLICKED> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li></ul>

<b>Ansicht lang geklickt</b> - stellt das Ereignis des langen Klickens auf ein android.view.View ähnliches android.widget.Button, android.widget.CompoundButtonusw <.br><em>Type:</em/br><em<>>#TYPE_VIEW_LONG_CLICKED Properties:</em></br<>ul<>li>#getEventType() - Der Typ des Ereignisses dar.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li></ul>

<b>Ansicht ausgewählt</b> - stellt das Ereignis der Auswahl eines Elements in der Regel im Kontext eines android.widget.AdapterView.</br><em>Type:</em/br><em><#TYPE_VIEW_SELECTED> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li></ul>

<b>Ansicht fokussiert</b> - stellt das Ereignis der Konzentration eines android.view.View.</br><em>Type:</em/br><em><#TYPE_VIEW_FOCUSED> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li></ul>

<b>Ansicht text changed</b> - represents the event of changing the text of an android.widget.EditText.</br><em>Type:</em/br><em><#TYPE_VIEW_TEXT_CHANGED> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li li>#getText()<> - Der neue Text der Quelle.</li li>#getBeforeText()<> - Der Text der Quelle vor der Änderung.</li ->#getFromIndex()<> Der Textänderungs-Anfangsindex.</li li>#getAddedCount()<> - Die Anzahl der hinzugefügten Zeichen.</li li>#getRemovedCount()<> - Die Anzahl der entfernten Zeichen.</li></ul>

<b>Ansicht der geänderten Textauswahl</b> - stellt das Ereignis des Änderns der Textauswahl einer .android.widget.EditText</br><em>Type:</em/br><em><#TYPE_VIEW_TEXT_SELECTION_CHANGED> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li></ul>

<b>Ansichtstext, der bei der Bewegungs granularität durchlaufen wird/b> – stellt das Ereignis dar, dass der Text einer Ansicht bei einer bestimmten Granularität< durchlaufen wird. Beispiel: Wechseln zum nächsten Wort.</br><em>Type:</em/br><em><#TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li li>#getMovementGranularity()<> – Legt die Granularität fest, an der der Text einer Ansicht durchlaufen wurde.</li li>#getText()<> - Der Text der Unterstruktur der Quelle.</li li><>#getFromIndex() - Der Anfang des Texts, der in dieser Bewegung übersprungen wurde. Dies ist der Ausgangspunkt, wenn der Text vorwärts bewegt wird, aber nicht beim Zurückwechseln.</li li><>#getToIndex() - Das Ende des Texts, der in dieser Bewegung übersprungen wurde. Dies ist der Endpunkt beim Vorwärtswechsel durch den Text, aber nicht beim Zurückwechseln.</li li>#getAction()<> - Ruft die Traversalaktion ab, die die Richtung angibt.</li></ul></p>

<b>Ansicht scrolled</b> – stellt das Ereignis des Bildlaufs einer Ansicht dar. </br><em>Type:</em/br><em><#TYPE_VIEW_SCROLLED> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li ->#getScrollDeltaX()<> Der Unterschied in der horizontalen Position.</li li>#getScrollDeltaY()<> - Der Unterschied in der vertikalen Position.</li></ul>

<b>ÜBERGANGSTYPEN</b></br>

<b>Fensterzustand geändert</b> – stellt das Ereignis einer Änderung in einen Abschnitt der Benutzeroberfläche dar, der visuell eindeutig ist. Sollte entweder aus der Stammansicht eines Fensters oder aus einer Ansicht gesendet werden, die als Bereich android.view.View#setAccessibilityPaneTitle(CharSequence)markiert ist. Beachten Sie, dass Änderungen an true Fenstern durch #TYPE_WINDOWS_CHANGEDdargestellt werden.</br><em>Type:</em/br><em><#TYPE_WINDOW_STATE_CHANGED> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li ->#getContentChangeTypes()<> Die Art der Zustandsänderungen.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li li>#getText()<> - Der Text der Unterstruktur der Quelle, einschließlich der Bereichstitel.</li></ul>

<b>Fensterinhalt geändert</b> – stellt das Ereignis einer Änderung im Inhalt eines Fensters dar. Diese Änderung kann das Hinzufügen/Entfernen der Ansicht, das Ändern einer Ansichtsgröße usw. sein.</Br>

<em>Type:</em/br><em><#TYPE_WINDOW_CONTENT_CHANGED> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li li>#getContentChangeTypes()<> - Die Art der Inhaltsänderungen.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li></ul>

<b>Windows changed</b> - represents a change in the windows shown on the screen such as a window appeared, a window disappeared, a window size changed, a window layer changed, etc. Diese Ereignisse sollten nur vom System stammen, das für die Verwaltung von Fenstern verantwortlich ist. Die Liste der Fenster ist verfügbar von android.accessibilityservice.AccessibilityService#getWindows(). Verwenden Sie #TYPE_WINDOW_STATE_CHANGEDfür Bereiche der Benutzeroberfläche, die als Fenster dargestellt werden, aber vom Prozess einer App gesteuert werden.</br><em>Type:</em/br><em><#TYPE_WINDOWS_CHANGED> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li li>#getEventTime()<> - Die Ereigniszeit.</li>>#getWindowChanges()<</li> - Die spezifische Änderung des Quellfensters </ul><em>Note:</em> Sie können die AccessibilityWindowInfo Für die Fensterquelle des Ereignisses abrufen, indem Sie die Liste durchsuchen, die von android.accessibilityservice.AccessibilityService#getWindows() dem Fenster zurückgegeben wird, dessen ID übereinstimmen.#getWindowId()

<b>BENACHRICHTIGUNGSTYPEN</b></br>

<b>Benachrichtigungszustand geändert</b> – stellt das Ereignis dar, das einen vorübergehenden Informationsabschnitt für den Benutzer anzeigt. Diese Informationen können ein android.app.Notification oder android.widget.Toastsein.</br><em>Type:</em/br><em><#TYPE_NOTIFICATION_STATE_CHANGED> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li li><#getParcelableData()> - Die geposteten android.app.Notification, falls zutreffend.</li -><>#getText() Angezeigter Text des android.widget.Toast, falls zutreffend, oder kann Text aus dem android.app.Notification, obwohl #getParcelableData() ein umfangreicherer Satz von Daten für .<android.app.Notification/li></ul>

<b>EXPLORATIONSTYPEN</b></br>

<b>View hover enter</b> - represents the event of beginning to hover over a android.view.View. Die Daraufzeigerung kann über toucheingabe oder über ein Zeigegerät durch Erkunden des Bildschirms generiert werden.</br><em>Type:</em/br><em><#TYPE_VIEW_HOVER_ENTER> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li></ul>

<b>View hover exit</b> - represents the event of stop to hover over a android.view.View. Die Daraufzeigerung kann über toucheingabe oder über ein Zeigegerät durch Erkunden des Bildschirms generiert werden.</br><em>Type:</em/br><em><#TYPE_VIEW_HOVER_EXIT> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li></ul></p>

<b>Ansicht mit Bildlauf nach</b> – stellt das Ereignis eines Zielknotens dar, der von ACTION_SCROLL_IN_DIRECTION auf dem Bildschirm angezeigt wird. <em>Type:</em/br><em><#TYPE_VIEW_TARGETED_BY_SCROLL> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li -><>#getSource() Die Quellinformationen (für registrierte Clients). Dies stellt den Knoten dar, der als Ergebnis des Bildlaufs auf dem Bildschirm angezeigt wird.</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li></ul>

<b>Touchinteraktion start</b> – stellt das Ereignis des Startens einer Touchinteraktion dar, bei der der Benutzer mit dem Berühren des Bildschirms beginnt.</br><em>Type:</em/br><em><#TYPE_TOUCH_INTERACTION_START> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li></ul><em>Hinweis:</em> Dieses Ereignis wird nur vom System ausgelöst und wird nicht an die Ansichtsstruktur übergeben, die aufgefüllt werden soll.</Br>

<b>Touchinteraktionsende</b> – stellt das Ereignis des Beendens einer Touchinteraktion dar, bei dem der Benutzer die Fingereingabe beendet.</br><em>Type:</em/br><em><#TYPE_TOUCH_INTERACTION_END> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li></ul><em>Hinweis:</em> Dieses Ereignis wird nur vom System ausgelöst und wird nicht an die Ansichtsstruktur übergeben, die aufgefüllt werden soll.</Br>

<b>Touch-Erkundungsgeste start</b> - stellt das Ereignis des Startens einer Touch-Erkundungsgeste dar.</br><em>Type:</em/br><em><#TYPE_TOUCH_EXPLORATION_GESTURE_START> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li></ul><em>Hinweis:</em> Dieses Ereignis wird nur vom System ausgelöst und wird nicht an die Ansichtsstruktur übergeben, die aufgefüllt werden soll.</Br>

<b>Touch-Erkundungsgeste Ende</b> - stellt das Ereignis des Beendens einer Touch-Erkundungsgeste dar.</br><em>Type:</em/br><em><#TYPE_TOUCH_EXPLORATION_GESTURE_END> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li></ul><em>Hinweis:</em> Dieses Ereignis wird nur vom System ausgelöst und wird nicht an die Ansichtsstruktur übergeben, die aufgefüllt werden soll.</Br>

<b>Touchgestenerkennung start</b> – stellt das Ereignis des Startens einer Benutzergestenerkennung dar.</br><em>Type:</em/br><em><#TYPE_GESTURE_DETECTION_START> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li></ul><em>Hinweis:</em> Dieses Ereignis wird nur vom System ausgelöst und wird nicht an die Ansichtsstruktur übergeben, die aufgefüllt werden soll.</Br>

<b>Touchgestenerkennung ende</b> – stellt das Ereignis des Beendens einer Benutzergestenerkennung dar.</br><em>Type:</em/br><em><#TYPE_GESTURE_DETECTION_END> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li></ul><em>Hinweis:</em> Dieses Ereignis wird nur vom System ausgelöst und wird nicht an die Ansichtsstruktur übergeben, die aufgefüllt werden soll.</Br>

<b>VERSCHIEDENE TYPEN</b></br>

<b>Announcement</b> – stellt das Ereignis einer Anwendung dar, die eine Sprachausgabe anfordert, eine Ankündigung zu erstellen. Da das Ereignis keine semantische Bedeutung hat, ist dieses Ereignis nur in ausnahmefällen Situationen geeignet, in denen zusätzliche Sprachausgabe erforderlich ist, andere Arten von Barrierefreiheitsdiensten jedoch nicht über die Änderung informiert werden müssen.</br><em>Type:</em/br><em><#TYPE_ANNOUNCEMENT> Properties:</em></br><ul><li>#getEventType() - Der Typ des Ereignisses.</li ->#getSource()<> Die Quellinformationen (für registrierte Clients).</li ->#getClassName()<> Der Klassenname der Quelle.</li ->#getPackageName()<> Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li li>#getText()<> - Der Text der Ankündigung.</li></ul>

<b>speechStateChanged</b><em>Type:</em>#TYPE_SPEECH_STATE_CHANGE</br> Represents a change in the speech state defined by the bit mask of the speech state change types. Eine Änderung des Sprachzustands tritt auf, wenn eine Anwendung signalisieren möchte, dass sie entweder spricht oder auf menschliche Sprache lauscht. Dieses Ereignis hilft dabei, Konflikte zu vermeiden, bei denen zwei Anwendungen sprechen möchten oder wenn eine andere spricht. Beim Senden dieses Ereignisses sollte der Absender sicherstellen, dass die zugehörigen Zustandsänderungstypen sinnvoll sind. Der Absender sollte z. B. nicht senden #SPEECH_STATE_SPEAKING_START und #SPEECH_STATE_SPEAKING_END zusammen sein. <em>Properties:</em></br><ul><li>#getSpeechStateChangeTypes() - Der Typ der Zustandsänderungen</li li>><#getPackageName() - Der Paketname der Quelle.</li li>#getEventTime()<> - Die Ereigniszeit.</li></ul>

Java-Dokumentation für android.view.accessibility.AccessibilityEvent.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

Felder

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für: