View.AccessibilityLiveRegion プロパティ

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

プロパティ値

ビューのライブ領域モード。

属性

RegisterAttribute

注釈

プロパティ getter のドキュメント:

このビューのライブ領域モードを取得します。

Javaドキュメント。

プロパティ セッターのドキュメント:

このビューのライブ領域モードを設定します。 これは、ビューのコンテンツの説明またはテキスト、またはビューの子のコンテンツの説明またはテキスト (該当する場合) の変更についてユーザーに自動的に通知する必要があるかどうかをアクセシビリティ サービスに示します。

<ul><li>#ACCESSIBILITY_LIVE_REGION_POLITE: リージョンの更新プログラムをユーザーに提示する必要があることを示します。 ほとんどの場合、ユーザーの即時の注意を必要としないアプリ コンテンツ内の目立つ更新に適しています。 </li><li>#ACCESSIBILITY_LIVE_REGION_ASSERTIVE: リージョンの更新が最も優先度が高く、ユーザーにすぐに表示されることを示します。 これにより、アクセシビリティ サービスからの破壊的な通知が発生する可能性があり、他のフィードバックやユーザーの操作が中断される可能性があるため、通常は重要な時間の機密情報にのみ使用する必要があります。 </li><li>#ACCESSIBILITY_LIVE_REGION_NONE: 変更のお知らせを無効にします (ほとんどのビューの既定値)。 </li></ul>

例: <ul><li> ドロップダウン メニューでオプションを選択すると、以下のパネルが更新されたコンテンツで更新されます。 このパネルは、変更をユーザーに通知する #ACCESSIBILITY_LIVE_REGION_POLITE を持つライブ リージョンとしてマークされる場合があります。 スクリーン リーダーは、進行中の音声を中断しないアナウンスとして変更をキューに入れます。 </li><li> 緊急通知を #ACCESSIBILITY_LIVE_REGION_ASSERTIVE マークして、ユーザーに緊急通報をすぐに通知できます。 </li></ul>

ログイン画面の "正しくないパスワード" 警告などのエラー通知の場合、ビューはコンテンツ変更の種類がAccessibilityEvent#TYPE_WINDOW_CONTENT_CHANGEDAccessibilityEventAccessibilityEvent#CONTENT_CHANGE_TYPE_ERRORを送信し、AccessibilityNodeInfo#setError(CharSequence)設定する必要があります。 カスタム ウィジェットでは、アクセシビリティをサポートするエラー設定メソッドを提供する必要があります。 たとえば、明示的にイベントを送信するのではなく、 android.widget.TextView#setError(CharSequence) を使用します。

頻繁に更新される UI 要素 (進行状況バーなど) にはライブリージョンを使用しないでください。これにより、アクセシビリティ サービスからのフィードバックでユーザーが圧倒される可能性があります。 必要に応じて、 AccessibilityNodeInfo#setMinDurationBetweenContentChanges(Duration) を使用してフィードバックを調整し、中断を減らします。

<aside><b>Note:</b> 下位互換性のために androidx.core.view.ViewCompat#setAccessibilityLiveRegion(View, int) を使用します。 </aside>

Javaドキュメント。

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

関連項目

• AccessibilityLiveRegion