Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit e105cc29 authored by Phil Weaver's avatar Phil Weaver
Browse files

Update javadoc for accessibility announcements 

Trying to make it less appealing for developers to force
announcements.

Test: make
Change-Id: I95087c2f068ed5b6c36e4bff6a66bb6c48910f9c
parent 1b4ea3a1

core/java/android/view/View.java

+7 −4
Original line number Diff line number Diff line
@@ -7462,10 +7462,13 @@ public class View implements Drawable.Callback, KeyEvent.Callback, 














    /**















     * Convenience method for sending a {@link AccessibilityEvent#TYPE_ANNOUNCEMENT}













     * {@link AccessibilityEvent} to make an announcement which is related to some













     * sort of a context change for which none of the events representing UI transitions













     * is a good fit. For example, announcing a new page in a book. If accessibility













     * is not enabled this method does nothing.













     * {@link AccessibilityEvent} to suggest that an accessibility service announce the













     * specified text to its users.













     * <p>













     * Note: The event generated with this API carries no semantic meaning, and is appropriate only













     * in exceptional situations. Apps can generally achieve correct behavior for accessibility by













     * accurately supplying the semantics of their UI.













     * They should not need to specify what exactly is announced to users.















     *















     * @param text The announcement text.















     */