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

Commit 9c7fa9c0 authored by Andrew Solovay's avatar Andrew Solovay Committed by Android Git Automerger
Browse files

am 99aa0c17: am 5119f6e6: am 3f22f22a: am bff632c8: Merge "doc: Documented how... 

am 99aa0c17: am 5119f6e6: am 3f22f22a: am bff632c8: Merge "doc: Documented how to set notification priority." into klp-docs

* commit '99aa0c17':
  doc: Documented how to set notification priority.
parents 049803a0 99aa0c17

docs/html/guide/topics/ui/notifiers/notifications.jd

+21 −0
Original line number Diff line number Diff line
@@ -16,6 +16,7 @@ page.title=Notifications 
      <li><a href="#Required">Required notification contents</a></li>

      <li><a href="#Optional">Optional notification contents and settings</a></li>

      <li><a href="#Actions">Notification actions</a></li>

      <li><a href="#Priority">Notification priority</a></li>

      <li><a href="#SimpleNotification">Creating a simple notification</a></li>

      <li><a href="#ApplyStyle">Applying a big view style to a notification</a></li>

      <li><a href="#Compatibility">Handling compatibility</a></li>
@@ -290,6 +291,26 @@ page.title=Notifications 
    {@link android.support.v4.app.NotificationCompat.Builder}.

</p>

<!-- ------------------------------------------------------------------------------------------ -->

<h3 id="Priority">Notification priority</h3>

<p>

    If you wish, you can set the priority of a notification. The priority acts

    as a hint to the device UI about how the notification should be displayed.

    To set a notification's priority, call {@link

    android.support.v4.app.NotificationCompat.Builder#setPriority(int)

    NotificationCompat.Builder.setPriority()} and pass in one of the {@link

    android.support.v4.app.NotificationCompat} priority constants. There are

    five priority levels, ranging from {@link

    android.support.v4.app.NotificationCompat#PRIORITY_MIN} (-2) to {@link

    android.support.v4.app.NotificationCompat#PRIORITY_MAX} (2); if not set, the

    priority defaults to {@link

    android.support.v4.app.NotificationCompat#PRIORITY_DEFAULT} (0).

</p>

<p> For information about setting an appropriate priority level, see "Correctly

    set and manage notification priority" in the <a

    href="{@docRoot}design/patterns/notifications.html">Notifications</a> Design

    guide.

</p>

<!-- ------------------------------------------------------------------------------------------ -->

<h3 id="SimpleNotification">Creating a simple notification</h3>

<p>

    The following snippet illustrates a simple notification that specifies an activity to open when