View.DispatchPopulateAccessibilityEvent(AccessibilityEvent) メソッド

定義

名前空間:

Android.Views

アセンブリ:

Mono.Android.dll

AccessibilityEventをViewにディスパッチして、ビューとその子のテキスト コンテンツを追加します。

[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

パラメーター

e

AccessibilityEvent

イベント。

返品

Boolean

イベントの作成が完了した場合は True。

属性

RegisterAttribute

注釈

AccessibilityEventをViewにディスパッチして、ビューとその子のテキスト コンテンツを追加します。

<b>Note:</b> このメソッドは event.setText() でのみ使用してください。 このメソッドでは、他のイベント状態を変更しないでください。 一般に、サービスが簡単にクエリを実行できるように、UI メタデータをノードに配置します。 <ul><li> 他のイベント プロパティを変更する場合は、セマンティクスのアクセシビリティ サービスが必要になる可能性があります。 代わりに、 #sendAccessibilityEvent(int) を使用して別のイベントを送信し、 #onInitializeAccessibilityEvent(AccessibilityEvent)をオーバーライドします。 </li><li>ウィンドウ/タイトルのお知らせを生成するために AccessibilityEvent#TYPE_WINDOW_STATE_CHANGED の種類を確認している場合は、中断を伴うアナウンスが発生している可能性があります (または、まったくお知らせを行わない)。 代わりに、 View#announceForAccessibility(CharSequence)で説明されているプラクティスに従ってください。 <b>Note:</b> announceForAccessibility() の呼び出しは推奨されませんが、ドキュメントに記載されている推奨事項を使用してください。 </li><li> UI の更新をトリガーするイベントの種類のチェックなど、アクセシビリティの状態に基づいて変更を加える場合は、適切な意図を持ちながら、一部のユーザーには機能するが、他のユーザーには機能しない、脆弱で保守性の低いコードを作成します。 代わりに、既存のコードを利用して、公平なエクスペリエンスと技術的負債を減らします。 例については、 AccessibilityManager#isEnabled() を参照してください。 </li></ul>

イベント テキストは、ソースのテキストだけでなく、そのすべての子孫のテキストにも追加されるため、別のディスパッチ パス (#onPopulateAccessibilityEvent(AccessibilityEvent)) に設定されることに注意してください。

一般的な実装では、このビューで #onPopulateAccessibilityEvent(AccessibilityEvent) を呼び出し、各子または表示される最初の子に対して #dispatchPopulateAccessibilityEvent(AccessibilityEvent) を呼び出します。 イベント テキスト コンテンツのカスタム作成が必要な場合は、このメソッドをオーバーライドします。

AccessibilityDelegateが呼び出し#setAccessibilityDelegate(AccessibilityDelegate)指定されている場合、そのAccessibilityDelegate#dispatchPopulateAccessibilityEvent(View, AccessibilityEvent)はこの呼び出しを処理します。

このビューが #isAccessibilityDataSensitive() 設定する場合、このビューは、 AccessibilityEvent#isAccessibilityDataSensitive()も設定するイベントにのみ機密情報を追加する必要があります。

<em>Note:</em> 特定の種類のアクセシビリティ イベントは、このメソッドを使用してイベント テキストを設定するためにディスパッチされません。 詳細は AccessibilityEventを参照してください。

Javaドキュメント。

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