View.DispatchPopulateAccessibilityEvent(AccessibilityEvent) Método

[Android.Runtime.Register("dispatchPopulateAccessibilityEvent", "(Landroid/view/accessibility/AccessibilityEvent;)Z", "GetDispatchPopulateAccessibilityEvent_Landroid_view_accessibility_AccessibilityEvent_Handler")]
public virtual bool DispatchPopulateAccessibilityEvent(Android.Views.Accessibility.AccessibilityEvent? e);

[<Android.Runtime.Register("dispatchPopulateAccessibilityEvent", "(Landroid/view/accessibility/AccessibilityEvent;)Z", "GetDispatchPopulateAccessibilityEvent_Landroid_view_accessibility_AccessibilityEvent_Handler")>]
abstract member DispatchPopulateAccessibilityEvent : Android.Views.Accessibility.AccessibilityEvent -> bool
override this.DispatchPopulateAccessibilityEvent : Android.Views.Accessibility.AccessibilityEvent -> bool

Parâmetros

Retornos

True se a população de eventos foi concluída.

Atributos

RegisterAttribute

Comentários

Envia um AccessibilityEvent para adicionar o View conteúdo do texto do modo de exibição e seus filhos.

<b>Observação:</b> Esse método só deve ser usado com event.setText(). Evite alterar outro estado de evento neste método. Em geral, coloque os metadados da interface do usuário no nó para que os serviços consultem facilmente. <ul><li> Se você estiver modificando outras propriedades de evento, talvez esteja eliminando os serviços de acessibilidade semântica. Em vez disso, envie um evento separado usando #sendAccessibilityEvent(int) e substitua #onInitializeAccessibilityEvent(AccessibilityEvent). </li><li>Se você estiver verificando se há tipo AccessibilityEvent#TYPE_WINDOW_STATE_CHANGED para gerar anúncios de janela/título, você pode estar causando anúncios disruptivos (ou não fazendo nenhum anúncio). Em vez disso, siga as práticas descritas em View#announceForAccessibility(CharSequence). <b>Observação:</b> isso não sugere chamar announceForAccessibility(), mas usar as sugestões listadas em sua documentação. </li><li>Se você estiver fazendo alterações com base no estado de acessibilidade, como verificar um tipo de evento para disparar uma atualização da interface do usuário, embora bem-intencionado, você está criando um código mais frágil e menos bem mantido que funciona para alguns usuários, mas não para outros. Em vez disso, aproveite o código existente para experiências equitativas e menos dívida técnica. Veja AccessibilityManager#isEnabled() para um exemplo. </li></ul>

Observe que o texto do evento é preenchido em um caminho de expedição separado (#onPopulateAccessibilityEvent(AccessibilityEvent)) uma vez que adicionamos ao evento não apenas o texto da origem, mas também o texto de todos os seus descendentes.

Uma implementação típica chamará #onPopulateAccessibilityEvent(AccessibilityEvent) esse modo de exibição e chamará cada #dispatchPopulateAccessibilityEvent(AccessibilityEvent) filho ou o primeiro filho que estiver visível. Substitua esse método se a população personalizada do conteúdo do texto do evento for necessária.

Se um AccessibilityDelegate tiver sido especificado por meio da chamada #setAccessibilityDelegate(AccessibilityDelegate) , ele AccessibilityDelegate#dispatchPopulateAccessibilityEvent(View, AccessibilityEvent) será responsável por lidar com essa chamada.

Se esse modo de exibição definir #isAccessibilityDataSensitive() , esse modo de exibição só deverá acrescentar informações confidenciais a um evento que também define AccessibilityEvent#isAccessibilityDataSensitive().

<em>Observação:</em> Eventos de acessibilidade de determinados tipos não são expedidos para preencher o texto do evento por meio desse método. Para obter detalhes, AccessibilityEventconsulte .

Documentação Java para android.view.View.dispatchPopulateAccessibilityEvent(android.view.accessibility.AccessibilityEvent).

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