TileUpdater.EnableNotificationQueue(Boolean) 方法

定义

命名空间:

Windows.UI.Notifications

使磁贴最多可以排队五个通知。 这将在所有磁贴大小上启用通知队列。

public:
 virtual void EnableNotificationQueue(bool enable) = EnableNotificationQueue;

void EnableNotificationQueue(bool const& enable);

public void EnableNotificationQueue(bool enable);

function enableNotificationQueue(enable)

Public Sub EnableNotificationQueue (enable As Boolean)

参数

enable

Boolean

bool

如果为 True ，则启用队列;否则 为 false。

示例

以下代码行为调用应用的磁贴启用通知队列。

Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

注解

启用队列后，最多可在磁贴上自动循环五个磁贴通知。 除非你的应用明确想要使用它，否则启用循环时要小心，否则可能会有过时的通知循环通过。 通常，队列是 FIFO (先入先出) ，这样，当队列已满且收到新通知时，将删除最早的通知。 但是，可以为通知提供 标记，这允许具有相同 Tag 的新通知替换其在队列中的旧通知，而不考虑其位置。

当磁贴基于速览模板时，通知循环将计时，以便始终在磁贴循环到下一个通知之前显示完整内容。

从Windows 8.1起，还可以仅为特定磁贴大小启用通知队列。 请参阅下列主题：

• EnableNotificationQueueForSquare150x150
• EnableNotificationQueueForSquare310x310
• EnableNotificationQueueForWide310x150 建议在将大型磁贴与以下模板之一结合使用时禁用通知队列，这些模板已同时显示三个通知。 这可以避免磁贴对用户产生干扰。 在这种情况下，可能需要使用特定于大小的 enable 方法，而不是 EnableNotificationQueue。
• TileSquare310x310SmallImagesAndTextList01
• TileSquare310x310SmallImagesAndTextList02
• TileSquare310x310SmallImagesAndTextList03
• TileSquare310x310SmallImagesAndTextList04
• TileSquare310x310TextList01
• TileSquare310x310TextList02
• TileSquare310x310TextList03

另请参阅

• 如何将通知队列与本地通知配合使用
• 应用磁贴和锁屏提醒示例
• 快速入门：发送磁贴更新
• 磁贴和磁贴通知概述
• 磁贴模板目录
• 磁贴指南和清单
• 如何计划磁贴通知
• 如何为磁贴设置定期通知
• 磁贴 XML 架构