Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Clarify documentation for notification a11y events" into oc-dev

Browse Source
This commit is contained in:
TreeHugger Robot
2017-05-11 01:57:04 +00:00
committed by Android (Google) Code Review
parent 33a030fa03 33c7136dde
commit 69a0f3f020
1 changed files with 8 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
core/java/android/view/accessibility/AccessibilityEvent.java
View File

@@ -365,8 +365,9 @@ import java.util.List;
* <b>NOTIFICATION TYPES</b></br>
* </p>
* <p>
* <b>Notification state changed</b> - represents the event showing
* {@link android.app.Notification}.</br>
* <b>Notification state changed</b> - represents the event showing a transient piece of information
* to the user. This information may be a {@link android.app.Notification} or
* {@link android.widget.Toast}.</br>
* <em>Type:</em> {@link #TYPE_NOTIFICATION_STATE_CHANGED}</br>
* <em>Properties:</em></br>
* <ul>
@@ -374,18 +375,12 @@ import java.util.List;
* <li>{@link #getClassName()} - The class name of the source.</li>
* <li>{@link #getPackageName()} - The package name of the source.</li>
* <li>{@link #getEventTime()} - The event time.</li>
* <li>{@link #getParcelableData()} - The posted {@link android.app.Notification}.</li>
* <li>{@link #getText()} - Text for providing more context.</li>
* <li>{@link #getParcelableData()} - The posted {@link android.app.Notification}, if
* applicable.</li>
* <li>{@link #getText()} - Displayed text of the {@link android.widget.Toast}, if applicable,
* or may contain text from the {@link android.app.Notification}, although
* {@link #getParcelableData()} is a richer set of data for {@link android.app.Notification}.</li>
* </ul>
* <em>Note:</em> This event type is not dispatched to descendants though
* {@link android.view.View#dispatchPopulateAccessibilityEvent(AccessibilityEvent)
* View.dispatchPopulateAccessibilityEvent(AccessibilityEvent)}, hence the event
* source {@link android.view.View} and the sub-tree rooted at it will not receive
* calls to {@link android.view.View#onPopulateAccessibilityEvent(AccessibilityEvent)
* View.onPopulateAccessibilityEvent(AccessibilityEvent)}. The preferred way to add
* text content to such events is by setting the
* {@link android.R.styleable#View_contentDescription contentDescription} of the source
* view.</br>
* </p>
* <p>
* <b>EXPLORATION TYPES</b></br>