View.AnnounceForAccessibility Método

[Android.Runtime.Register("announceForAccessibility", "(Ljava/lang/CharSequence;)V", "GetAnnounceForAccessibility_Ljava_lang_CharSequence_Handler")]
public virtual void AnnounceForAccessibility(Java.Lang.ICharSequence? text);

[<Android.Runtime.Register("announceForAccessibility", "(Ljava/lang/CharSequence;)V", "GetAnnounceForAccessibility_Ljava_lang_CharSequence_Handler")>]
abstract member AnnounceForAccessibility : Java.Lang.ICharSequence -> unit
override this.AnnounceForAccessibility : Java.Lang.ICharSequence -> unit

Parâmetros

Atributos

RegisterAttribute

Comentários

Método de conveniência para enviar um AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent para sugerir que um serviço de acessibilidade anuncie o texto especificado para seus usuários.

Observação: o evento gerado com essa API não tem nenhum significado semântico e é apropriado apenas em situações excepcionais. Os aplicativos geralmente podem obter o comportamento correto para acessibilidade fornecendo com precisão a semântica de sua interface do usuário. Eles não devem precisar especificar o que exatamente é anunciado aos usuários.

Em geral, apenas anuncie transições e não gere uma mensagem de confirmação para ações simples, como uma tecla de botão. Rotule seus controles de forma concisa e precisa e, em vez disso, para alterações significativas na interface do usuário, como alterações de janela, uso android.app.Activity#setTitle(CharSequence) e #setAccessibilityPaneTitle(CharSequence).

Use #setAccessibilityLiveRegion(int) para informar o usuário sobre alterações em exibições críticas dentro da interface do usuário. Elas ainda devem ser usadas com moderação, pois podem gerar anúncios sempre que um Modo de Exibição for atualizado.

Para notificar os usuários sobre erros, como em uma tela de logon com texto que exibe uma notificação de "senha incorreta", essa exibição deve enviar um AccessibilityEvent do tipo AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR e definir AccessibilityNodeInfo#setError(CharSequence) . Os widgets personalizados devem expor métodos de configuração de erro que dão suporte à acessibilidade automaticamente. Por exemplo, em vez de enviar explicitamente esse evento ao usar um TextView, use android.widget.TextView#setError(CharSequence).

Use #setStateDescription(CharSequence) para transmitir alterações de estado para exibições dentro da interface do usuário. Embora uma região dinâmica possa enviar diferentes tipos de eventos gerados pela exibição, a descrição do estado enviará AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGED eventos do tipo AccessibilityEvent#CONTENT_CHANGE_TYPE_STATE_DESCRIPTION.

Java documentação para android.view.View.announceForAccessibility(java.lang.CharSequence).

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.

public void AnnounceForAccessibility(string? text);

member this.AnnounceForAccessibility : string -> unit

Parâmetros

Comentários

Método de conveniência para enviar um AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent para sugerir que um serviço de acessibilidade anuncie o texto especificado para seus usuários.

Observação: o evento gerado com essa API não tem nenhum significado semântico e é apropriado apenas em situações excepcionais. Os aplicativos geralmente podem obter o comportamento correto para acessibilidade fornecendo com precisão a semântica de sua interface do usuário. Eles não devem precisar especificar o que exatamente é anunciado aos usuários.

Em geral, apenas anuncie transições e não gere uma mensagem de confirmação para ações simples, como uma tecla de botão. Rotule seus controles de forma concisa e precisa e, em vez disso, para alterações significativas na interface do usuário, como alterações de janela, uso android.app.Activity#setTitle(CharSequence) e #setAccessibilityPaneTitle(CharSequence).

Use #setAccessibilityLiveRegion(int) para informar o usuário sobre alterações em exibições críticas dentro da interface do usuário. Elas ainda devem ser usadas com moderação, pois podem gerar anúncios sempre que um Modo de Exibição for atualizado.

Para notificar os usuários sobre erros, como em uma tela de logon com texto que exibe uma notificação de "senha incorreta", essa exibição deve enviar um AccessibilityEvent do tipo AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR e definir AccessibilityNodeInfo#setError(CharSequence) . Os widgets personalizados devem expor métodos de configuração de erro que dão suporte à acessibilidade automaticamente. Por exemplo, em vez de enviar explicitamente esse evento ao usar um TextView, use android.widget.TextView#setError(CharSequence).

Use #setStateDescription(CharSequence) para transmitir alterações de estado para exibições dentro da interface do usuário. Embora uma região dinâmica possa enviar diferentes tipos de eventos gerados pela exibição, a descrição do estado enviará AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGED eventos do tipo AccessibilityEvent#CONTENT_CHANGE_TYPE_STATE_DESCRIPTION.

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.