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

Merge "Improve a11y pane title javadoc" into pi-dev

Browse Source
This commit is contained in:
Phil Weaver
2018-03-07 22:38:07 +00:00
committed by Android (Google) Code Review
parent a52ddd989e 37cc3c410a
commit f397f44756
1 changed files with 9 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
core/java/android/view/View.java
View File

@@ -7289,16 +7289,18 @@ public class View implements Drawable.Callback, KeyEvent.Callback,
}
/**
* If this view is a visually distinct portion of a window, for example the content view of
* a fragment that is replaced, it is considered a pane for accessibility purposes. In order
* for accessibility services to understand the views role, and to announce its title as
* appropriate, such views should have pane titles.
* Visually distinct portion of a window with window-like semantics are considered panes for
* accessibility purposes. One example is the content view of a fragment that is replaced.
* In order for accessibility services to understand a pane's window-like behavior, panes
* should have descriptive titles. Views with pane titles produce {@link AccessibilityEvent}s
* when they appear, disappear, or change title.
*
* @param accessibilityPaneTitle The pane's title.
* @param accessibilityPaneTitle The pane's title. Setting to {@code null} indicates that this
* View is not a pane.
*
* {@see AccessibilityNodeInfo#setPaneTitle(CharSequence)}
*/
public void setAccessibilityPaneTitle(CharSequence accessibilityPaneTitle) {
public void setAccessibilityPaneTitle(@Nullable CharSequence accessibilityPaneTitle) {
if (!TextUtils.equals(accessibilityPaneTitle, mAccessibilityPaneTitle)) {
mAccessibilityPaneTitle = accessibilityPaneTitle;
notifyViewAccessibilityStateChangedIfNeeded(
@@ -7313,7 +7315,7 @@ public class View implements Drawable.Callback, KeyEvent.Callback,
*
* {@see #setAccessibilityPaneTitle}.
*/
public CharSequence getAccessibilityPaneTitle() {
@Nullable public CharSequence getAccessibilityPaneTitle() {
return mAccessibilityPaneTitle;
}