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

Commit b2c69fb7 authored by Alexander Roederer's avatar Alexander Roederer
Browse files

Updates documentation on Action Button Icons 

Updates documentation on Action Button icons to note that icons
are not displayed as of Android 7.0.

Bug: 184243364
Test: Only documentation change
Change-Id: If301c9d5ca46b847be16a741d0aa3bb96b37499c
parent 60376531

core/java/android/app/Notification.java

+17 −0
Original line number Diff line number Diff line
@@ -1901,6 +1901,11 @@ public class Notification implements Parcelable 














            /**















             * Construct a new builder for {@link Action} object.













             * <p>As of Android {@link android.os.Build.VERSION_CODES#N},













             * action button icons will not be displayed on action buttons, but are still required













             * and are available to













             * {@link android.service.notification.NotificationListenerService notification listeners},













             * which may display them in other contexts, for example on a wearable device.















             * @param icon icon to show for this action















             * @param title the title of the action















             * @param intent the {@link PendingIntent} to fire when users trigger this action









@@ -1923,6 +1928,12 @@ public class Notification implements Parcelable













             * both are displayed or required, depends on where and how the action is used, and the















             * {@link Style} applied to the Notification.















             *













             * <p>As of Android {@link android.os.Build.VERSION_CODES#N}, action button icons













             * will not be displayed on action buttons, but are still required and are available













             * to {@link android.service.notification.NotificationListenerService notification













             * listeners}, which may display them in other contexts, for example on a wearable













             * device.













             *















             * <p>When the {@code title} is a {@link android.text.Spanned}, any colors set by a















             * {@link ForegroundColorSpan} or {@link TextAppearanceSpan} may be removed or displayed















             * with an altered in luminance to ensure proper contrast within the Notification.










@@ -4918,6 +4929,12 @@ public class Notification implements Parcelable













         * while processing broadcast receivers or services in response to notification action















         * clicks. To launch an activity in those cases, provide a {@link PendingIntent} to the















         * activity itself.













         * <p>













         * As of Android {@link android.os.Build.VERSION_CODES#N},













         * action button icons will not be displayed on action buttons, but are still required













         * and are available to













         * {@link android.service.notification.NotificationListenerService notification listeners},













         * which may display them in other contexts, for example on a wearable device.















         *















         * @param icon Resource ID of a drawable that represents the action.















         * @param title Text describing the action.