View.AccessibilityLiveRegion Propriedade

public virtual Android.Views.AccessibilityLiveRegion AccessibilityLiveRegion { [Android.Runtime.Register("getAccessibilityLiveRegion", "()I", "GetGetAccessibilityLiveRegionHandler")] get; [Android.Runtime.Register("setAccessibilityLiveRegion", "(I)V", "GetSetAccessibilityLiveRegion_IHandler")] set; }

[<get: Android.Runtime.Register("getAccessibilityLiveRegion", "()I", "GetGetAccessibilityLiveRegionHandler")>]
[<set: Android.Runtime.Register("setAccessibilityLiveRegion", "(I)V", "GetSetAccessibilityLiveRegion_IHandler")>]
member this.AccessibilityLiveRegion : Android.Views.AccessibilityLiveRegion with get, set

Valor da propriedade

O modo de região dinâmica para o modo de exibição.

Atributos

RegisterAttribute

Comentários

Documentação do getter de propriedades:

Obtém o modo de região ao vivo para esta exibição.

Documentação Java para android.view.View.getAccessibilityLiveRegion().

Documentação do setter de propriedades:

Define o modo de região dinâmica para esse modo de exibição. Isso indica aos serviços de acessibilidade se eles devem notificar automaticamente o usuário sobre alterações na descrição ou texto do conteúdo da exibição ou nas descrições de conteúdo ou no texto dos filhos da exibição (quando aplicável).

Diferentes níveis de prioridade estão disponíveis: <ul><li>#ACCESSIBILITY_LIVE_REGION_POLITE: indica que as atualizações para a região devem ser apresentadas ao usuário. Adequado na maioria dos casos para atualizações proeminentes no conteúdo do aplicativo que não exigem a atenção imediata do usuário. </li><li>#ACCESSIBILITY_LIVE_REGION_ASSERTIVE: indica que as atualizações para a região têm a prioridade mais alta e devem ser apresentadas ao usuário imediatamente. Isso pode resultar em notificações disruptivas de um serviço de acessibilidade, o que pode potencialmente interromper outros comentários ou ações do usuário, portanto, ele geralmente deve ser usado apenas para informações críticas e sensíveis ao tempo. </li><li>#ACCESSIBILITY_LIVE_REGION_NONE: desabilita anúncios de alteração (o padrão para a maioria dos modos de exibição). </li></ul>

Exemplos: <ul><li> Selecionar uma opção em um menu suspenso atualiza um painel abaixo com o conteúdo atualizado. Esse painel pode ser marcado como uma região dinâmica para #ACCESSIBILITY_LIVE_REGION_POLITE notificar os usuários sobre a alteração. Um leitor de tela pode enfileirar alterações como anúncios que não interrompem a fala em andamento. </li li><> Um alerta de emergência pode ser marcado #ACCESSIBILITY_LIVE_REGION_ASSERTIVE para informar imediatamente os usuários sobre a emergência. </li></ul>

Para notificações de erro, como um aviso de "senha incorreta" em uma tela de logon, as exibições devem enviar um AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGEDAccessibilityEvent com um tipo AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR de alteração de conteúdo e definir AccessibilityNodeInfo#setError(CharSequence). Os widgets personalizados devem fornecer métodos de configuração de erro que dão suporte à acessibilidade. Por exemplo, use android.widget.TextView#setError(CharSequence) em vez de enviar eventos explicitamente.

Não use regiões dinâmicas para atualizar com frequência elementos de interface do usuário (por exemplo, barras de progresso), pois isso pode sobrecarregar o usuário com comentários de serviços de acessibilidade. Se necessário, use AccessibilityNodeInfo#setMinDurationBetweenContentChanges(Duration) para limitar os comentários e reduzir as interrupções.

<aside><b>Observação:</b> Use androidx.core.view.ViewCompat#setAccessibilityLiveRegion(View, int) para compatibilidade com versões anteriores. </aside>

Documentação Java para android.view.View.setAccessibilityLiveRegion(int).

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.

Confira também

• AccessibilityLiveRegion