语言

Notification.Builder 类

定义

Notification 对象的 Builder 类。

[Android.Runtime.Register("android/app/Notification$Builder", DoNotGenerateAcw=true)]
public class Notification.Builder : Java.Lang.Object
[<Android.Runtime.Register("android/app/Notification$Builder", DoNotGenerateAcw=true)>]
type Notification.Builder = class
    inherit Object
继承
Notification.Builder
特性

注解

Notification 对象的 Builder 类。 提供了一种便捷的方法,用于设置通知的各个字段,并使用平台的通知布局模板生成内容视图。 如果应用支持旧版本为 API 级别 4 的 Android,则可以改用 Android 支持库中提供的 NotificationCompat.Builder。 Example:

Notification noti = new Notification.Builder(mContext, CHANNEL_ID)
        .setContentTitle("New mail from " + sender.toString())
        .setContentText(subject)
        .setSmallIcon(R.drawable.new_mail)
        .setLargeIcon(aBitmap)
        .build();

Android 参考。android.app.Notification.Builder

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

构造函数

名称 说明
Notification.Builder(Context, String)

使用默认值构造新的生成器:

Notification.Builder(Context)

此构造函数已弃用。

Notification.Builder(IntPtr, JniHandleOwnership)

初始化现有 Java Native Interface 对象的托管表示形式。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Extras

获取此通知生成器使用的当前元数据捆绑包。

Handle

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

为 Android.App.Notification.Builder 提供 JNI 绑定基础结构。

Notification
已过时.

此方法在 API 级别 16 中已弃用。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
Style

返回 setStyle(Style) 设置的样式。

ThresholdClass

为 Android.App.Notification.Builder 提供 JNI 绑定基础结构。

ThresholdType

为 Android.App.Notification.Builder 提供 JNI 绑定基础结构。

方法

名称 说明
AddAction(Int32, ICharSequence, PendingIntent)
已过时.

此方法在 API 级别 23 中已弃用。

AddAction(Int32, String, PendingIntent)
已过时.

此方法在 API 级别 23 中已弃用。

AddAction(Notification+Action)

向此通知添加操作。

AddExtras(Bundle)

将其他元数据合并到此通知中。

AddPerson(Person)

添加与此通知相关的人员。

AddPerson(String)

此方法在 API 级别 28 中已弃用。

Build()

合并已设置的所有选项并返回新的 Notification 对象。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
CreateBigContentView()

此方法在 API 级别 35 中已弃用。

CreateContentView()

此方法在 API 级别 35 中已弃用。

CreateHeadsUpContentView()

此方法在 API 级别 35 中已弃用。

Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
Extend(Notification+IExtender)

向此通知生成器应用扩展程序。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
RecoverBuilder(Context, Notification)

从现有通知创建生成器,以便可以进行进一步的更改。

SetActions(Notification+Action[])

更改附加到此通知的操作的完整列表。

SetAllowSystemGeneratedContextualActions(Boolean)

确定平台是否可以为通知生成上下文操作。

SetAutoCancel(Boolean)

当用户触摸此通知时,会自动消除此通知。

SetBadgeIconType(NotificationBadgeIconType)

设置要显示为此通知的锁屏提醒的图标。

SetBubbleMetadata(Notification+BubbleMetadata)

设置将用于在现有前台活动的浮动窗口中显示应用内容的 BubbleMetadata。

SetCategory(String)

设置通知类别。

SetChannelId(String)

指定通知应传送到的通道。

SetChronometerCountDown(Boolean)

将计时计设置为倒计时,而不是倒计时。

SetColor(Int32)

设置 Notification.color。

SetColorized(Boolean)

设置此通知是否应着色。

SetContent(RemoteViews)
已过时.

提供要使用的自定义 RemoteViews,而不是平台模板。

SetContentInfo(ICharSequence)
已过时.

此方法在 API 级别 24 中已弃用。

SetContentInfo(String)
已过时.

此方法在 API 级别 24 中已弃用。

SetContentIntent(PendingIntent)

提供在单击通知时要发送的 PendingIntent。

SetContentText(ICharSequence)

在平台通知模板中设置第二行文本。

SetContentText(String)

在平台通知模板中设置第二行文本。

SetContentTitle(ICharSequence)

在平台通知模板中设置第一行文本。

SetContentTitle(String)

在平台通知模板中设置第一行文本。

SetCustomBigContentView(RemoteViews)

提供自定义 RemoteViews 以使用,而不是扩展窗体中的平台模板。

SetCustomContentView(RemoteViews)

提供要使用的自定义 RemoteViews,而不是平台模板。

SetCustomHeadsUpContentView(RemoteViews)

在“头起”对话框中提供自定义 RemoteViews,而不是平台模板。

SetDefaults(NotificationDefaults)

此方法在 API 级别 26 中已弃用。

SetDeleteIntent(PendingIntent)

提供在用户显式清除通知时要发送的 PendingIntent。

SetExtras(Bundle)

设置此通知的元数据。

SetFlag(Int32, Boolean)

设置通知标志的值

SetForegroundServiceBehavior(Int32)

为与前台服务关联的通知指定所需的可见性策略。

SetFullScreenIntent(PendingIntent, Boolean)

要启动的意向,而不是将通知发布到状态栏。

SetGroup(String)

将此通知设置为共享同一密钥的一组通知的一部分。

SetGroupAlertBehavior(NotificationGroupAlertBehavior)

设置此通知的组警报行为。

SetGroupSummary(Boolean)

将此通知设置为一组通知的组摘要。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetHasSummarizedContent(Boolean)

设置此通知是否包含从其他源进行计算汇总的文本。

SetLargeIcon(Bitmap)

向通知内容视图添加一个大图标。

SetLargeIcon(Icon)

向通知内容视图添加一个大图标。

SetLights(Int32, Int32, Int32)

此方法在 API 级别 26 中已弃用。

SetLocalOnly(Boolean)

设置此通知是否不应桥接到其他设备。

SetLocusId(LocusId)

设置与此通知关联的 LocusId。

SetNumber(Int32)

设置此通知表示的项数。

SetOngoing(Boolean)

设置此通知是否为“持续”通知。

SetOnlyAlertOnce(Boolean)

如果只希望播放声音、振动和滴答声(如果通知尚未显示),请设置此标志。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
SetPriority(Int32)

此方法在 API 级别 26 中已弃用。

SetProgress(Int32, Int32, Boolean)

设置此通知表示的进度。

SetPublicVersion(Notification)

提供一个替换通知,其内容应在不安全的上下文中显示(即安全锁屏上方)。

SetRemoteInputHistory(ICharSequence[])

设置远程输入历史记录。

SetRemoteInputHistory(String[])

设置远程输入历史记录。

SetRequestPromotedOngoing(Boolean)

设置此通知是否请求成为正在升级的正在进行的通知。

SetSettingsText(ICharSequence)

提供将显示为应用程序设置链接的文本。

SetSettingsText(String)

提供将显示为应用程序设置链接的文本。

SetShortCriticalText(String)

设置一个非常简短的字符串,用于汇总通知中包含的最关键信息。

SetShortcutId(String)

从 Android 11 开始,使用此方法链接到已发布的长期共享快捷方式的消息通知(那些使用 MessagingStyle)可能会显示在阴影的专用对话部分中,并可能显示特定于对话的配置选项。

SetShowWhen(Boolean)

控制是否在内容视图中显示带有 setWhen 的时间戳集。

SetSmallIcon(Icon)

设置小图标,用于表示状态栏中的通知。

SetSmallIcon(Int32, Int32)

setSmallIcon(int)的变体,在图标为 LevelListDrawable 时采用其他级别参数。

SetSmallIcon(Int32)

设置小图标资源,该资源将用于表示状态栏中的通知。

SetSortKey(String)

设置排序键,以便将此通知与其他通知从同一包排序。

SetSound(Uri, AudioAttributes)

此方法在 API 级别 26 中已弃用。

SetSound(Uri, Stream)
已过时.

此方法在 API 级别 21 中已弃用。

SetSound(Uri)

此方法在 API 级别 26 中已弃用。

SetStyle(Notification+Style)

添加要在生成时应用的丰富通知样式。

SetSubText(ICharSequence)

这提供了通知中显示的一些附加信息。

SetSubText(String)

这提供了通知中显示的一些附加信息。

SetTicker(ICharSequence, RemoteViews)
已过时.

setTicker(CharSequence)的过时版本。

SetTicker(ICharSequence)

设置发送到辅助功能服务的“ticker”文本。

SetTicker(String, RemoteViews)
已过时.

setTicker(CharSequence)的过时版本。

SetTicker(String)

设置发送到辅助功能服务的“ticker”文本。

SetTimeoutAfter(Int64)

指定一个持续时间(以毫秒为单位),之后应取消此通知(如果尚未取消)。

SetUsesChronometer(Boolean)

将 Notification.when 字段显示为秒表。

SetVibrate(Int64[])

此方法在 API 级别 26 中已弃用。

SetVisibility(NotificationVisibility)

指定 Notification.visibility 的值。

SetWhen(Int64)

添加与通知相关的时间戳(通常是事件发生的时间)。

ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于