AccessibilityEvent Classe

Definição

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

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

Herança

Object

JavaObject

Object

AccessibilityRecord

AccessibilityEvent

Atributos

RegisterAttribute

Implementações

IParcelable IJavaObject IJavaPeerable IDisposable

Comentários

Essa classe representa eventos de acessibilidade que são enviados pelo sistema quando algo notável acontece na interface do usuário. Por exemplo, quando um android.widget.Button é clicado, um android.view.View é focado, etc.

Um evento de acessibilidade é acionado por uma exibição individual que preenche o evento com dados para seu estado e solicita de seu pai para enviar o evento às partes interessadas. Opcionalmente, o pai pode modificar ou até mesmo bloquear o evento com base em sua compreensão mais ampla do contexto da interface do usuário.

A principal finalidade de um evento de acessibilidade é comunicar as alterações na interface do usuário para um android.accessibilityservice.AccessibilityService. Se necessário, o serviço poderá inspecionar a interface do usuário examinando a hierarquia De exibição por meio do #getSource() sourceevento, conforme representado por uma árvore de AccessibilityNodeInfos (instantâneo de um estado de exibição) que pode ser usada para explorar o conteúdo da janela. Observe que o privilégio de acessar a origem de um evento, portanto, o conteúdo da janela, deve ser solicitado explicitamente. Para obter mais detalhes, consulte android.accessibilityservice.AccessibilityService. Se um serviço de acessibilidade não tiver solicitado recuperar o conteúdo da janela, o evento não conterá referência à sua origem. <Observação forte>: /strong< para eventos do tipo > que a origem nunca está disponível, e exibições definidas #TYPE_NOTIFICATION_STATE_CHANGED podem não preencher todas as propriedades de evento em eventos enviados de cima para cima na hierarquia android.view.View#isAccessibilityDataSensitive()de exibição.

Essa classe representa vários tipos de evento de acessibilidade semanticamente diferentes. Cada tipo de evento tem um conjunto associado de propriedades relacionadas. Em outras palavras, cada tipo de evento é caracterizado por meio de um subconjunto das propriedades expostas por essa classe. Para cada tipo de evento, há uma constante correspondente definida nesta classe. Segue uma especificação dos tipos de evento e suas propriedades associadas:

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

Para obter mais informações sobre como criar e processar AccessibilityEvents, leia o guia do desenvolvedor de acessibilidade .

</div>

<b>TIPOS DE EXIBIÇÃO</b></br>

<b>Exibição clicada</b> – representa o evento de clicar em um android.view.View likeandroid.widget.Button, android.widget.CompoundButtonetc.</br>em Type:</em><>/br#TYPE_VIEW_CLICKED<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li></ul>

<b>Exibir long clicked</b> - representa o evento de clicar longamente em um android.view.View likeandroid.widget.Button, android.widget.CompoundButtonetc </br><em>Type:</em>#TYPE_VIEW_LONG_CLICKED</br><em>Properties:</em></br><ul><li>#getEventType() - O tipo do evento.</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li></ul>

<b>Exibição selecionada</b> – representa o evento de selecionar um item geralmente no contexto de um android.widget.AdapterView.</br>em Type:</em><>/br#TYPE_VIEW_SELECTED<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li></ul>

<b>Exibição focada</b> – representa o evento de focalizar um android.view.View.</br>em Type:</em><>/br#TYPE_VIEW_FOCUSED<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li></ul>

<b>Exibir texto alterado</b> – representa o evento de alteração do texto de um android.widget.EditText.</br>em Type:</em><>/br#TYPE_VIEW_TEXT_CHANGED<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li><li>#getText() - O novo texto da origem.</li><li>#getBeforeText() - O texto da origem antes da alteração.</li><li>#getFromIndex() - O índice de início da alteração de texto.</li><li>#getAddedCount() - O número de caracteres adicionados.</li><li>#getRemovedCount() - O número de caracteres removidos.</li></ul>

<b>Exibir seleção de texto alterada</b> – representa o evento de alteração da seleção de texto de um android.widget.EditText.</br>em Type:</em><>/br#TYPE_VIEW_TEXT_SELECTION_CHANGED<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li></ul>

<b>Exibir texto percorrido na granularidade< de movimento/b> – representa o evento de atravessar o texto de uma exibição em uma determinada granularidade. Por exemplo, movendo-se para a próxima palavra.</br>em Type:</em><>/br#TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li><li>#getMovementGranularity() - Define a granularidade na qual o texto de uma exibição foi percorrido.</li><li>#getText() - O texto da subárvore da origem.</li><li>#getFromIndex() - O início do texto que foi ignorado nesse movimento. Esse é o ponto de partida ao avançar pelo texto, mas não ao voltar.</li><li>#getToIndex() - O final do texto que foi ignorado neste movimento. Esse é o ponto final ao avançar pelo texto, mas não ao voltar.</li><li>#getAction() - Obtém ação de passagem que especifica a direção.</li></ul></p>

<b>Exibição rolada</b> – representa o evento de rolar um modo de exibição. </br>em Type:</em><>/br#TYPE_VIEW_SCROLLED<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li><li>#getScrollDeltaX() - A diferença na posição horizontal.</li><li>#getScrollDeltaY() - A diferença na posição vertical.</li><li>#getMaxScrollX() ()} - O deslocamento de rolagem máximo da borda< esquerda de origem/li><li>#getMaxScrollY() ()} – o deslocamento de rolagem máximo da borda superior de origem.</li></ul>

<b>TIPOS< DE TRANSIÇÃO/b></br>

<b>Estado da janela alterado</b> – representa o evento de uma alteração para uma seção da interface do usuário que é visualmente distinta. Deve ser enviado do modo de exibição raiz de uma janela ou de um modo de exibição marcado como um painel android.view.View#setAccessibilityPaneTitle(CharSequence). Observe que as alterações nas janelas verdadeiras são representadas por #TYPE_WINDOWS_CHANGED.</br>em Type:</em><>/br#TYPE_WINDOW_STATE_CHANGED<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getContentChangeTypes() - O tipo de alteração de estado.</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li><li>#getText() - O texto da subárvore da origem, incluindo os títulos do painel.</li></ul>

<b>Conteúdo da janela alterado</b> – representa o evento de alteração no conteúdo de uma janela. Essa alteração pode estar adicionando/removendo o modo de exibição, alterando um tamanho de exibição etc.</br>

<em>Tipo:</em>#TYPE_WINDOW_CONTENT_CHANGED</br><em>Propriedades:</em></br><ul><li>#getEventType() - O tipo do evento.</li><li>#getContentChangeTypes() - O tipo de alteração de conteúdo.</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li></ul>

<b> Windows alterado</b> - representa uma alteração no windows mostrado na tela, como uma janela exibida, uma janela desapareceu, um tamanho de janela alterado, uma camada de janela alterada, etc. Esses eventos só devem vir do sistema, que é responsável pelo gerenciamento de windows. A lista de janelas está disponível em android.accessibilityservice.AccessibilityService#getWindows(). Para regiões da interface do usuário que são apresentadas como janelas, mas são controladas pelo processo de um aplicativo, use #TYPE_WINDOW_STATE_CHANGED.</br>em Type:</em><>/br#TYPE_WINDOWS_CHANGED<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getEventTime() - A hora do evento.</li><li>#getWindowChanges()</li> - A alteração específica para a janela <de origem /ul><em>Observação:</em> Você pode recuperar a AccessibilityWindowInfo origem da janela do evento examinando a lista retornada pela android.accessibilityservice.AccessibilityService#getWindows() janela cuja ID corresponde.#getWindowId()

<b>TIPOS< DE NOTIFICAÇÃO/b></br>

<b>Estado de notificação alterado</b> – representa o evento mostrando uma parte transitória das informações para o usuário. Essas informações podem ser um android.app.Notification ou android.widget.Toast.</br>em Type:</em><>/br#TYPE_NOTIFICATION_STATE_CHANGED<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li><li>#getParcelableData() - O postadoandroid.app.Notification, se aplicável.</li><li>#getText() - Texto exibido do android.widget.Toast, se aplicável, ou pode conter texto do android.app.Notification, embora #getParcelableData() seja um conjunto mais rico de dados para android.app.Notification.</li></ul>

<b>TIPOS< DE EXPLORAÇÃO/b></br>

<b>Exibir focalizar enter</b> – representa o evento de começar a passar o mouse sobre um android.view.View. O foco pode ser gerado por meio da exploração da tela por toque ou por meio de um dispositivo apontando.</br>em Type:</em><>/br#TYPE_VIEW_HOVER_ENTER<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li></ul>

<b>Exibir a saída< do mouse/b> – representa o evento de parar para passar o mouse sobre um android.view.View. O foco pode ser gerado por meio da exploração da tela por toque ou por meio de um dispositivo apontando.</br>em Type:</em><>/br#TYPE_VIEW_HOVER_EXIT<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li></ul></p>

<b>Exibição rolada para</b> – representa o evento de um nó de destino trazido na tela por ACTION_SCROLL_IN_DIRECTION. <em>Tipo:</em>#TYPE_VIEW_TARGETED_BY_SCROLL</br><em>Propriedades:</em></br><ul><li>#getEventType() - O tipo do evento.</li><li>#getSource() - As informações de origem (para clientes registrados). Isso representa o nó que é colocado na tela como resultado da rolagem.</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li></ul>

<b>Início da interação< por toque/b> – representa o evento de iniciar uma interação por toque, que é que o usuário começa a tocar na tela.</br>em Type:</em><>/br#TYPE_TOUCH_INTERACTION_START<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li></ul><em>Observação:</em> Esse evento é acionado apenas pelo sistema e não é passado para a árvore de exibição a ser preenchida.</br>

<b>Final de interação< por toque/b> – representa o evento de encerrar uma interação por toque, que é que o usuário para de tocar na tela.</br>em Type:</em><>/br#TYPE_TOUCH_INTERACTION_END<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li></ul><em>Observação:</em> Esse evento é acionado apenas pelo sistema e não é passado para a árvore de exibição a ser preenchida.</br>

<b>Início do gesto< de exploração de toque/b> – representa o evento de iniciar um gesto de exploração de toque.</br>em Type:</em><>/br#TYPE_TOUCH_EXPLORATION_GESTURE_START<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li></ul><em>Observação:</em> Esse evento é acionado apenas pelo sistema e não é passado para a árvore de exibição a ser preenchida.</br>

<b>Final do gesto< de exploração de toque/b> – representa o evento de encerrar um gesto de exploração de toque.</br>em Type:</em><>/br#TYPE_TOUCH_EXPLORATION_GESTURE_END<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li></ul><em>Observação:</em> Esse evento é acionado apenas pelo sistema e não é passado para a árvore de exibição a ser preenchida.</br>

<b>Inicialização de detecção< de gestos de toque/b> – representa o evento de iniciar uma detecção de gestos do usuário.</br>em Type:</em><>/br#TYPE_GESTURE_DETECTION_START<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li></ul><em>Observação:</em> Esse evento é acionado apenas pelo sistema e não é passado para a árvore de exibição a ser preenchida.</br>

<b>Extremidade de detecção< de gesto de toque/b> – representa o evento de encerrar uma detecção de gestos do usuário.</br>em Type:</em><>/br#TYPE_GESTURE_DETECTION_END<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li></ul><em>Observação:</em> Esse evento é acionado apenas pelo sistema e não é passado para a árvore de exibição a ser preenchida.</br>

<b>TIPOS< DIVERSOS/b></br>

<b>Comunicado</b> – representa o evento de um aplicativo solicitando que um leitor de tela faça um anúncio. Como o evento não tem nenhum significado semântico, esse evento é apropriado apenas em situações excepcionais em que a saída adicional do leitor de tela é necessária, mas outros tipos de serviços de acessibilidade não precisam estar cientes da alteração.</br>em Type:</em><>/br#TYPE_ANNOUNCEMENT<em>Properties:</em>/br<><ul><li>< - O tipo do evento.>#getEventType()</li><li>#getSource() - As informações de origem (para clientes registrados).</li><li>#getClassName() - O nome da classe da origem.</li><li>#getPackageName() - O nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li><li>#getText() - O texto do anúncio.</li></ul>

<b>speechStateChanged</b><em>Type:</em>#TYPE_SPEECH_STATE_CHANGE</br> Representa uma alteração no estado de fala definido pela máscara de bits dos tipos de alteração de estado de fala. Uma alteração no estado de fala ocorre quando um aplicativo deseja sinalizar que está falando ou escutando fala humana. Esse evento ajuda a evitar conflitos em que dois aplicativos desejam falar ou um escuta quando outro fala. Ao enviar esse evento, o remetente deve garantir que os tipos de alteração de estado que acompanham façam sentido. Por exemplo, o remetente não deve enviar #SPEECH_STATE_SPEAKING_START e #SPEECH_STATE_SPEAKING_END juntos. <em>Propriedades:</em></br><ul><li>#getSpeechStateChangeTypes() - O tipo de estado muda</li><li>#getPackageName() - o nome do pacote da origem.</li><li>#getEventTime() - A hora do evento.</li></ul>

Documentação Java para android.view.accessibility.AccessibilityEvent.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.