View.AnnounceForAccessibility メソッド

定義

名前空間:: Android.Views

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

Name	説明
AnnounceForAccessibility(ICharSequence)	アクセシビリティサービスが指定したテキストをユーザーに読み上げるよう提案する `AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent` を送信する便利な方法。
AnnounceForAccessibility(String)	アクセシビリティサービスが指定したテキストをユーザーに読み上げるよう提案する `AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent` を送信する便利な方法。

AnnounceForAccessibility(ICharSequence)

アクセシビリティサービスが指定したテキストをユーザーに読み上げるよう提案する AccessibilityEvent#TYPE_ANNOUNCEMENTAccessibilityEvent を送信する便利な方法。

[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

パラメーター

text: ICharSequence

アナウンステキスト。

属性: RegisterAttribute

注釈

注: この API で生成されるイベントはセマンティックな意味を持たせず、例外的な状況でのみ適切です。アプリは通常、UI のセマンティクスを正確に指定することで、アクセシビリティに対する正しい動作を実現できます。ユーザーに対して正確に通知される内容を指定する必要はありません。

一般に、画面切り替えを読み上げるだけで、ボタンを押すなどの簡単なアクションの確認メッセージは生成されません。コントロールに簡潔かつ正確にラベルを付け、ウィンドウの変更などの UI の大幅な変更には、 android.app.Activity#setTitle(CharSequence) と #setAccessibilityPaneTitle(CharSequence)を使用します。

#setAccessibilityLiveRegion(int)を使用して、ユーザーインターフェイス内の重要なビューに対する変更をユーザーに通知します。これらは、ビューが更新されるたびにお知らせが生成される可能性があるため、引き続き慎重に使用する必要があります。

"正しくないパスワード" 通知を表示するテキストを含むログイン画面などのエラーをユーザーに通知する場合、そのビューは AccessibilityEvent#CONTENT_CHANGE_TYPE_ERROR 型の AccessibilityEvent を送信し、代わりに AccessibilityNodeInfo#setError(CharSequence) 設定する必要があります。カスタムウィジェットでは、アクセシビリティを自動的にサポートするエラー設定メソッドを公開する必要があります。たとえば、TextView を使用するときにこのイベントを明示的に送信する代わりに、 android.widget.TextView#setError(CharSequence)を使用します。

#setStateDescription(CharSequence)を使用して、ユーザーインターフェイス内のビューに状態の変更を伝えます。ライブリージョンではビューによって生成されるさまざまな種類のイベントが送信される場合があります。状態の説明では、AccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGED型のイベントAccessibilityEvent#CONTENT_CHANGE_TYPE_STATE_DESCRIPTION送信されます。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

AnnounceForAccessibility(String)

public void AnnounceForAccessibility(string? text);

member this.AnnounceForAccessibility : string -> unit

パラメーター

text: String

アナウンステキスト。

注釈

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象