public class Notification
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.app.Notification |
一个类,它表示如何使用 NotificationManager
向用户呈现持久通知。
已添加 Notification.Builder
以便更容易地构建通知。
有关创建通知的指导,请阅读 Status Bar Notifications开发人员指南。
Nested classes |
|
---|---|
class |
Notification.Action 结构来封装可作为此通知的一部分显示的命名操作。 |
class |
Notification.BigPictureStyle 帮助程序类用于生成包含大图像附件的大幅面通知。 |
class |
Notification.BigTextStyle 用于生成包含大量文本的大格式通知的助手类。 |
class |
Notification.Builder |
class |
Notification.CarExtender
Helper类将Android Auto扩展添加到通知。 |
class |
Notification.DecoratedCustomViewStyle 由系统装饰的自定义视图的通知样式 开发人员可以设置此风格,而不是提供完全自定义的通知,而是通过展开可供件和动作来获取系统装饰,例如通知标题。 |
class |
Notification.DecoratedMediaCustomViewStyle 媒体自定义视图的通知样式,由系统修饰 开发人员可以设置此风格,而不是提供完全自定义的媒体通知,而是通过扩展可供件和动作来获取系统装饰,例如通知标题。 |
interface |
Notification.Extender 与 |
class |
Notification.InboxStyle Helper类用于生成包含(最多5个)字符串列表的大型通知。 |
class |
Notification.MediaStyle 媒体播放通知的通知样式。 |
class |
Notification.MessagingStyle Helper类用于生成包含多个不同类型的多个来回消息的大格式通知。 |
class |
Notification.Style 可以将丰富的通知样式应用于 |
class |
Notification.WearableExtender 助手类为通知添加可穿戴扩展。 |
Inherited constants |
---|
From interface android.os.Parcelable
|
Fields |
|
---|---|
public static final AudioAttributes |
AUDIO_ATTRIBUTES_DEFAULT 默认值为 |
public static final Creator<Notification> |
CREATOR Parcelable.Creator实例化Notification对象 |
public Action[] |
actions 由 |
public AudioAttributes |
audioAttributes 播放声音时使用 |
public int |
audioStreamType 此字段在API级别21中已弃用。请改为使用 |
public RemoteViews |
bigContentView
|
public String |
category 其中一个最能描述此通知的预定义通知类别(请参阅 |
public int |
color 在呈现此通知时由标准样式模板应用的强调颜色(类似于 |
public PendingIntent |
contentIntent 点击展开状态条目时执行的意图。 |
public RemoteViews |
contentView 将在通知列表中显示此通知的视图(从状态栏中拉下来)。 |
public int |
defaults 指定应从默认值中获取哪些值。 |
public PendingIntent |
deleteIntent 意图在用户明确解除通知时执行,或者使用“全部清除”按钮或单独将其擦除。 |
public Bundle |
extras 使用此通知附带的附加语义数据。 |
public int |
flags |
public PendingIntent |
fullScreenIntent 意图启动而不是将通知发布到状态栏。 |
public RemoteViews |
headsUpContentView 一个中等格式的版本 |
public int |
icon 此字段在API级别23中已弃用。请改为使用 |
public int |
iconLevel 如果状态栏中的图标要具有多个级别,则可以对其进行设置。 |
public Bitmap |
largeIcon 此字段在API级别23中已弃用。请改为使用 |
public int |
ledARGB LED的颜色。 |
public int |
ledOffMS LED在闪烁时关闭的毫秒数。 |
public int |
ledOnMS 闪烁时LED亮起的毫秒数。 |
public int |
number 此字段在API级别24中已被弃用。此号码不再显示 |
public int |
priority 此通知的相对优先级。 |
public Notification |
publicVersion 该通知的替换版本,其内容将显示在不安全的上下文中,例如安全键盘保护程序之上。 |
public Uri |
sound 要播放的声音。 |
public CharSequence |
tickerText 汇总此无障碍服务通知的文本。 |
public RemoteViews |
tickerView 以前,一个视图显示 |
public long[] |
vibrate 振动的模式。 |
public int |
visibility 此通知的可见范围,它影响SystemUI如何以及何时在不受信任的情况下(即安全锁屏上)显示通知的存在和内容。 |
public long |
when 与此通知相关的时间戳,以时间为单位,以毫秒为单位。 |
Public constructors |
|
---|---|
Notification() 使用默认值构造一个Notification对象。 |
|
Notification(int icon, CharSequence tickerText, long when) 此构造函数在API级别11中已弃用。请改为使用 |
|
Notification(Parcel parcel) 从包裹解除通知。 |
Public methods |
|
---|---|
Notification |
clone() 创建并返回此对象的副本。 |
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
String |
getGroup() 获取用于将此通知分组到群集或堆栈中的密钥,以及支持此类呈现的设备上的其他通知。 |
Icon |
getLargeIcon() 此通知内容视图中显示的大图标。 |
Icon |
getSmallIcon() 在状态栏和内容视图中代表此通知的小图标。 |
String |
getSortKey() 获取一个排序关键字,可以从同一个包中的其他通知中排列此通知。 |
String |
toString() 返回对象的字符串表示形式。 |
void |
writeToParcel(Parcel parcel, int flags) 将此通知拼凑成一个包裹。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
String CATEGORY_RECOMMENDATION
通知类别:针对单一事物的特定及时推荐。 例如,新闻应用可能希望推荐一个它认为用户将要接下来要阅读的新闻报道。
常数值:“推荐”
int COLOR_DEFAULT
color
特殊值告诉系统不要用任何特殊颜色修饰此通知,而是在呈现此通知时使用默认颜色。
常量值:0(0x00000000)
int DEFAULT_LIGHTS
使用默认通知灯。 这将忽略FLAG_SHOW_LIGHTS
位,并ledARGB
, ledOffMS
,或ledOnMS
。
也可以看看:
常量值:4(0x00000004)
int DEFAULT_SOUND
使用默认通知声音。 这将忽略任何给定的sound
。
嘈杂的通知更有可能作为单挑通知呈现。
也可以看看:
常数值:1(0x00000001)
int DEFAULT_VIBRATE
使用默认通知振动。 这将忽略任何给定的vibrate
。 使用手机振动需要VIBRATE
权限。
振动通知更有可能作为单挑通知呈现。
也可以看看:
常量值:2(0x00000002)
String EXTRA_BACKGROUND_IMAGE_URI
extras
键:指向可在选择通知时在后台显示的图像的A content URI
。 URI必须指向适合传入BitmapFactory.decodeStream
的图像流; 所有其他内容类型将被忽略。 用于此目的的内容提供者URI不需要读取图像数据的权限。
常量值:“android.backgroundImageUri”
String EXTRA_BIG_TEXT
extras
键:这是 Notification.BigTextStyle
通知的大格式中显示的较长文本,提供给 bigText(CharSequence)
。
常量值:“android.bigText”
String EXTRA_CHRONOMETER_COUNT_DOWN
extras
键:在通知上设置的精密计时器是否应该倒数而不是倒计数。 仅当钥匙EXTRA_SHOW_CHRONOMETER
存在时才相关。 这额外是一个布尔值。 默认值是false。
常量值:“android.chronometerCountDown”
String EXTRA_COMPACT_ACTIONS
extras
键:提供给(例如) setShowActionsInCompactView(int)
的紧凑视图中要显示的动作的索引。
常量值:“android.compactActions”
String EXTRA_CONVERSATION_TITLE
extras
键:一个 CharSequence
被显示为由 Notification.MessagingStyle
表示的对话的标题
常量值:“android.conversationTitle”
String EXTRA_INFO_TEXT
extras
键:这是提供给 setContentInfo(CharSequence)
附加文本。
常量值:“android.infoText”
String EXTRA_LARGE_ICON
extras
键:显示提供给 setLargeIcon(android.graphics.Bitmap)
的通知有效载荷时,此位图将用于代替小图标。
常量值:“android.largeIcon”
String EXTRA_LARGE_ICON_BIG
extras
键:这是要代替所述一个的用于从位图 setLargeIcon(android.graphics.Bitmap)
当在其膨胀形式示出的通知时,作为供给到 bigLargeIcon(android.graphics.Bitmap)
。
常量值:“android.largeIcon.big”
String EXTRA_MEDIA_SESSION
extras
键:与 Notification.MediaStyle
通知关联的A MediaSession.Token
。
常量值:“android.mediaSession”
String EXTRA_MESSAGES
extras
键:由Notification.MessagingStyle
通知提供的Notification.MessagingStyle.Message
包的数组。 这个额外的包是一个parcelable数组。
常量值:“android.messages”
String EXTRA_PEOPLE
extras
key:一个包含此通知相关人员的字符串数组,每个数组都提供给 addPerson(String)
。
常量值:“android.people”
String EXTRA_PICTURE
extras
键:这是一个位图,显示在 Notification.BigPictureStyle
扩展通知中,提供给 bigPicture(android.graphics.Bitmap)
。
常量值:“android.picture”
String EXTRA_PROGRESS
extras
键:这是提供给 setProgress(int, int, boolean)
的进度值。
常量值:“android.progress”
String EXTRA_PROGRESS_INDETERMINATE
extras
键:进度条是否不确定,提供给 setProgress(int, int, boolean)
。
常量值:“android.progressIndeterminate”
String EXTRA_PROGRESS_MAX
extras
键:这是提供给 setProgress(int, int, boolean)
的最大值。
常量值:“android.progressMax”
String EXTRA_REMOTE_INPUT_HISTORY
extras
键:这是远程输入历史记录,提供给setRemoteInputHistory(CharSequence[])
。 应用程序可以通过setRemoteInputHistory(CharSequence[])
填写最新的输入,通过此通知的RemoteInput
发送最近的输入,并且一旦它不再相关(例如,一旦对方已响应,则发送聊天通知),应用程序将清除它。 此密钥的额外属性是CharSequence []类型,并且包含0索引处的最新条目,1索引处的最近第二条目,等等。
常量值:“android.remoteInputHistory”
String EXTRA_SELF_DISPLAY_NAME
extras
键:为用户发送的所有邮件显示的用户名,包括直接回复Notification.MessagingStyle
通知。 这额外是CharSequence
常量值:“android.selfDisplayName”
String EXTRA_SHOW_CHRONOMETER
extras
键: when
是否应显示为 when
计时器(特别是 Chronometer
)而不是时间戳,如提供给 setUsesChronometer(boolean)
。
常量值:“android.showChronometer”
String EXTRA_SHOW_WHEN
extras
键:是否应显示 when
,供应给 setShowWhen(boolean)
。
常量值:“android.showWhen”
String EXTRA_SMALL_ICON
extras
键:这是通知的主要小图标的资源ID,提供给 setSmallIcon(int)
。
常量值:“android.icon”
String EXTRA_SUB_TEXT
extras
键:这是提供给 setSubText(CharSequence)
的第三行文本。
常量值:“android.subText”
String EXTRA_SUMMARY_TEXT
extras
键:这是一行概要信息,旨在与提供给(例如) setSummaryText(CharSequence)
扩展通知一起显示。
常量值:“android.summaryText”
String EXTRA_TEMPLATE
extras
key:一个字符串,表示用于创建此通知的特定 Notification.Style
的名称。
常量值:“android.template”
String EXTRA_TEXT
extras
键:这是主要文本有效负载,提供给 setContentText(CharSequence)
。
常量值:“android.text”
String EXTRA_TEXT_LINES
extras
键:要在 Notification.InboxStyle
展开的通知中显示的CharSequence数组,其中每个提供给 addLine(CharSequence)
。
常量值:“android.textLines”
String EXTRA_TITLE
extras
键:这是提供给 setContentTitle(CharSequence)
的通知标题。
常量值:“android.title”
String EXTRA_TITLE_BIG
extras
键:这是以展开形式显示时通知的标题,例如提供给 setBigContentTitle(CharSequence)
。
常量值:“android.title.big”
int FLAG_AUTO_CANCEL
如果在用户单击通知时取消通知,应将该 flags
入应该设置的 flags
字段中。
常量值:16(0x00000010)
int FLAG_FOREGROUND_SERVICE
如果此通知表示当前正在运行的服务,则该位应该被设置到flags
字段中。 这通常会由您设置startForeground(int, Notification)
。
常量值:64(0x00000040)
int FLAG_GROUP_SUMMARY
如果此通知是一组通知的组摘要,则位应该被设置到应该设置的flags
字段中。 分组通知可以显示在支持这种呈现的设备上的群集或堆栈中。 还需要使用setGroup(String)
来设置组密钥。
常量值:512(0x00000200)
int FLAG_HIGH_PRIORITY
此常数在API级别16中已弃用。
以正值使用priority
。
指示高优先级通知的过时标志; 改用优先权字段。
常量值:128(0x00000080)
int FLAG_INSISTENT
要将位置位到 flags
字段中,如果设置了该字段,则会重复该音频,直到通知被取消或通知窗口打开。
常量值:4(0x00000004)
int FLAG_LOCAL_ONLY
如果此通知仅与当前设备相关,并且不建议它桥接到其他设备,则位应该被设置到应该设置的 flags
字段中。
常量值:256(0x00000100)
int FLAG_NO_CLEAR
如果在用户单击“全部清除”按钮时不应取消通知,应将位设置为应该设置的 flags
字段。
常量值:32(0x00000020)
int FLAG_ONGOING_EVENT
如果此通知参考正在进行的某些事件(例如电话呼叫),则应将该flags
位到应该设置的flags
字段中。 如果此通知是针对某个特定时间点发生的事件(例如未接电话),则不应设置。
常量值:2(0x00000002)
int FLAG_ONLY_ALERT_ONCE
如果通知尚未显示,您只需要播放声音,振动和滚动条即可播放 flags
字段,该位应该设置为 flags
字段。
常量值:8(0x00000008)
int FLAG_SHOW_LIGHTS
如果您希望指示灯开启此通知,则位应该设置到 flags
字段中。
由于硬件各不相同,因此不能保证您传递的任何值都完全符合。 如果可能,请使用系统默认值(TODO),因为它们将设置为适用于任何给定硬件的值。
Alpha通道必须设置为向前兼容。
常数值:1(0x00000001)
String INTENT_CATEGORY_NOTIFICATION_PREFERENCES
提供用户界面以调整其包含的应用程序的通知首选项的活动。 可选,但建议用于发布Notifications
应用。
常量值:“android.intent.category.NOTIFICATION_PREFERENCES”
int PRIORITY_DEFAULT
默认通知priority
。 如果您的应用程序未优先处理自己的通知,请将此值用于所有通知。
常量值:0(0x00000000)
int PRIORITY_HIGH
更高的priority
,用于更重要的通知或警报。 与您的应用的PRIORITY_DEFAULT
项目相比,用户界面可能选择显示这些项目更大,或者显示在通知列表中的不同位置。
常数值:1(0x00000001)
int PRIORITY_LOW
降低priority
,对于不太重要的项目。 与您的应用PRIORITY_DEFAULT
项目相比,用户界面可能会选择显示较小的项目,或列表中不同的位置。
常量值:-1(0xffffffff)
int PRIORITY_MAX
最高 priority
,为您的应用程序的最重要的项目,需要用户及时的关注或输入。
常量值:2(0x00000002)
int PRIORITY_MIN
最低priority
; 除特殊情况外,这些项目可能不会显示给用户,例如详细的通知日志。
常量值:-2(0xfffffffe)
int STREAM_DEFAULT
此常数在API级别21中已弃用。
改为使用audioAttributes
。
使用此常量作为audioStreamType的值来请求使用通知的默认流类型。 目前默认的流类型是STREAM_NOTIFICATION
。
常量值:-1(0xffffffff)
int VISIBILITY_PRIVATE
通知可见性:在所有锁屏上显示此通知,但隐藏安全锁屏上的敏感或隐私信息。
也可以看看:
常量值:0(0x00000000)
int VISIBILITY_PUBLIC
通知可见性:在所有锁屏上全部显示此通知。
也可以看看:
常数值:1(0x00000001)
int VISIBILITY_SECRET
通知可见性:请勿在安全锁屏上显示此通知的任何部分。
也可以看看:
常量值:-1(0xffffffff)
AudioAttributes AUDIO_ATTRIBUTES_DEFAULT
默认值为 audioAttributes
。
Action[] actions
由addAction(int, CharSequence, PendingIntent)
附加到此通知的所有Notification.Action
结构的addAction(int, CharSequence, PendingIntent)
。 对于提供用于调用动作的替代接口的实例NotificationListenerService
非常有用。
int audioStreamType
此字段在API级别21中已被弃用。
改为使用audioAttributes
。
播放声音时使用的音频流类型。 应该是来自AudioManager
的STREAM_常量AudioManager
。
RemoteViews bigContentView
contentView
的大幅面版本,为通知提供了展示更多细节的机会。 系统用户界面可以自行选择显示,而不是正常的内容视图。 从N开始,此字段可能为空。 展开的通知视图由Notification.Builder
的输入确定; 一个定制的RemoteViews可以随意提供setCustomBigContentView(RemoteViews)
。
int color
在呈现此通知时由标准样式模板应用的强调颜色(类似于Color
常量的ARGB整数)。 当前的模板设计通过将icon
图像(以白色icon
叠加在该颜色的字段icon
构造彩色标题图像。 Alpha组件被忽略。
PendingIntent contentIntent
点击展开状态条目时执行的意图。 如果这是一项活动,则它必须包含FLAG_ACTIVITY_NEW_TASK
标志,该标志要求您负责按照Tasks and Back Stack文档中的描述处理任务管理。 特别是,请务必阅读通知部分Handling Notifications以了解从通知启动应用程序的正确方法。
RemoteViews contentView
将在通知列表中显示此通知的视图(从状态栏中拉下来)。 从N开始,此字段可能为空。 通知视图由Notification.Builder
的输入确定; 一个定制的RemoteViews可以随意提供setCustomContentView(RemoteViews)
。
int defaults
指定应从默认值中获取哪些值。
要设置,还是从所需DEFAULT_SOUND
, DEFAULT_VIBRATE
, DEFAULT_LIGHTS
。 对于所有默认值,请使用DEFAULT_ALL
。
PendingIntent deleteIntent
意图在用户明确解除通知时执行,或者使用“全部清除”按钮或单独将其擦除。 这可能不应该启动一项活动,因为其中几项将同时发送。
Bundle extras
使用此通知附带的附加语义数据。
这里定义的额外密钥旨在将原始输入捕获到 Notification.Builder
API,并且旨在供 NotificationListenerService
实现从通知对象中提取详细信息。
PendingIntent fullScreenIntent
意图启动而不是将通知发布到状态栏。
在用户使用该设备时,系统UI可以选择显示抬头通知,而不是启动该意图。
RemoteViews headsUpContentView
中等格式的contentView
版本,为通知提供了向contentView添加动作按钮的机会。 系统用户界面可以自行选择将其显示为抬头通知,该通知会弹出,以便用户在不离开当前活动的情况下看到它。 从N开始,此字段可能为空。 抬头通知视图由Notification.Builder
的输入Notification.Builder
; 一个定制的RemoteViews可以随意提供setCustomHeadsUpContentView(RemoteViews)
。
Bitmap largeIcon
此字段在API级别23中已被弃用。
改为使用setLargeIcon(Icon)
。
要在通知内容区域中显示的大型位图。
int number
此字段在API级别24中已被弃用。
这个号码不再显示
此通知代表的事件数量。 例如,在新的邮件通知中,这可能是未读消息的数量。 系统可能会或可能不会使用此字段来修改通知的外观。 例如,在HONEYCOMB
之前,此编号叠加在状态栏中的图标上。 与开始HONEYCOMB
,所用的模板Notification.Builder
已经显示在展开的通知视图的数量。 如果数字为0或负数,则永不显示。
int priority
此通知的相对优先级。 优先级指示该通知应该消耗多少用户的有价值的关注。 在某些情况下,用户可能会隐藏低优先级通知,而用户可能因高优先级通知而被中断。 系统将在提交通知时确定如何解释此优先级。
至少 PRIORITY_HIGH
通知更有可能作为平视通知呈现。
Notification publicVersion
该通知的替换版本,其内容将显示在不安全的上下文中,例如安全键盘保护程序之上。 见visibility
和VISIBILITY_PUBLIC
。
CharSequence tickerText
汇总此无障碍服务通知的文本。 从L版本开始,此文本不再显示在屏幕上,但对无障碍服务(它充当通知外观的可听通告)仍然有用。
也可以看看:
int visibility
此通知的可见范围,它影响SystemUI如何以及何时在不受信任的情况下(即安全锁屏上)显示通知的存在和内容。 默认级别VISIBILITY_PRIVATE
行为与Android上的通知始终完全相同:通知的icon
和tickerText
(如果可用)在所有情况下都会显示,但只有在适当用户解锁设备时才会显示内容。 更宽松的政策可以用VISIBILITY_PUBLIC
表示; 即使在“不安全”情况下(即在安全锁屏上方)也可以读取这种通知。 要修改此通知的公共版本 - 例如,编辑一些部分 - 请参阅setPublicVersion(Notification)
。 最后,可以发出通知VISIBILITY_SECRET
,这将禁止其图标和滚动条,直到用户绕过VISIBILITY_SECRET
。
long when
与此通知相关的时间戳,以时间为单位,以毫秒为单位。 默认值: Now
。 选择一个与用户最相关的时间戳。 对于大多数有限事件,这对应于事件发生的时间(或者将发生,在事件尚未发生但用户被告知的情况下)。 无限期活动应该根据活动开始的时间加盖时间戳。 一些例子:
N
and above, this time is not shown anymore by default and must be opted into by using
setShowWhen(boolean)
Notification ()
使用默认值构造一个Notification对象。 您可能需要考虑使用Notification.Builder
。
Notification (int icon, CharSequence tickerText, long when)
此构造函数在API级别11中已弃用。
改为使用Notification.Builder
。
用没有标准展开视图的状态栏图标所需的信息构造一个Notification对象。
Parameters | |
---|---|
icon |
int : The resource id of the icon to put in the status bar. |
tickerText |
CharSequence : The text that flows by in the status bar when the notification first activates. |
when |
long : The time to show in the time field. In the System.currentTimeMillis timebase. |
Notification clone ()
创建并返回此对象的副本。 “复制”的确切含义可能取决于对象的类别。 一般意图是,对于任何对象x
,表达式:
will be true, and that the expression:x.clone() != x
will bex.clone().getClass() == x.getClass()
true
, but these are not absolute requirements. While it is typically the case that:
will bex.clone().equals(x)
true
, this is not an absolute requirement.
按照惯例,应该通过调用super.clone
获得返回的对象。 如果一个类和它的所有超类( Object
除外)都遵守这个约定,那么情况就是x.clone().getClass() == x.getClass()
。
按照惯例,这个方法返回的对象应该独立于这个对象(被克隆)。 为了实现这种独立性,可能需要在返回super.clone
之前修改对象的一个或多个字段。 通常,这意味着复制包含被克隆对象的内部“深层结构”的任何可变对象,并将这些对象的引用替换为对这些副本的引用。 如果一个类仅包含原始字段或对不可变对象的引用,那么通常情况下不需要修改由super.clone
返回的对象中的任何字段。
类Object
的方法clone
执行特定的克隆操作。 首先,如果该对象的类没有实现接口Cloneable
,则引发CloneNotSupportedException
。 请注意,所有数组都被视为实现接口Cloneable
并且数组类型T[]
的clone
方法的返回类型为T[]
,其中T是任何引用或基本类型。 否则,此方法创建该对象的类的新实例,并使用该对象的相应字段的内容来初始化其所有字段,就像通过赋值一样; 这些字段的内容本身并不克隆。 因此,此方法执行此对象的“浅拷贝”,而不是“深拷贝”操作。
类 Object
本身并不实现接口 Cloneable
,所以在类为 Object
的对象上调用 clone
方法将导致在运行时抛出异常。
Returns | |
---|---|
Notification |
a clone of this instance. |
int describeContents ()
描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象将在writeToParcel(Parcel, int)
的输出中包含writeToParcel(Parcel, int)
,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR
位。
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
String getGroup ()
获取用于将此通知分组到群集或堆栈中的密钥,以及支持此类呈现的设备上的其他通知。
Returns | |
---|---|
String |
Icon getSmallIcon ()
在状态栏和内容视图中代表此通知的小图标。
Returns | |
---|---|
Icon |
the small icon representing this notification. |
也可以看看:
String getSortKey ()
获取一个排序关键字,可以从同一个包中的其他通知中排列此通知。 如果已经应用了外部排序并且应用程序想要保留这一点,这可能很有用。 通知将按照字典顺序使用此值进行排序,但除了提供排序键之外,提供不同的优先级可能会导致忽略此值。
此排序关键字也可用于订购通知组的成员。 见setGroup(String)
。
Returns | |
---|---|
String |
也可以看看:
String toString ()
返回对象的字符串表示形式。 一般来说, toString
方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object
的toString
方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |
void writeToParcel (Parcel parcel, int flags)
将此通知拼凑成一个包裹。
Parameters | |
---|---|
parcel |
Parcel : The Parcel in which the object should be written. |
flags |
int : Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE . |