如何選擇加入快顯通知 (Windows 執行階段應用程式)
[ 本文的目標對象是撰寫 Windows 執行階段 App 的 Windows 8.x 和 Windows Phone 8.x 開發人員。如果您正在開發適用於 Windows 10 的 App，請參閱 最新文件 ]
注意 不是使用 JavaScript？請參閱如何選擇加入快顯通知 (XAML)。
這個主題說明如何指定讓應用程式能夠引發快顯通知。
您必須知道的事
技術
- Windows Runtime
先決條件
為了解這個主題，您需要：
- 快顯通知詞彙及概念的實用知識。如需詳細資訊，請參閱快顯通知概觀。
- 熟悉快顯通知 XML 結構描述並且大致熟悉 XML，以及其透過文件物件模型 (DOM) API 的操作方法。如需詳細資訊，請參閱快顯通知結構描述。
指示
步驟 1: 宣告快顯通知功能
引發快顯通知的功能是在應用程式的 package.appxmanifest 檔案中宣告的。如果您使用 Microsoft Visual Studio 資訊清單編輯器，只要在 [應用程式] 索引標籤的 [通知]**** 區段中，將 [支援快顯通知] 選項設定成 [是]。
下列範例說明選擇此選項後插入 package.appxmanifest 檔案的 XML。ToastCapable 屬性會新增至資訊清單的 VisualElements 元素中。
如果您在 Visual Studio 外部手動建立 package.appxmanifest 檔案，本範例也會顯示要新增的項目。如需詳細資訊，請參閱如何手動建立套件資訊清單。請注意，雖然 Visual Studio 選項為 [是]，不過寫入 package.appxmanifest 檔案為 "true"。
<VisualElements
...
ToastCapable="true">
</VisualElements>
步驟 2: 宣告快顯通知的背景和文字色彩 (僅適用於 Windows)
您可以宣告快顯通知的背景色彩和淺色或深色的文字。請注意，此設定也會套用到您的磚—快顯通知和磚通知的背景，而且文字色彩是永遠連結的。
如果您使用 Visual Studio 資訊清單編輯器，請選取 [視覺資產] 索引標籤中的 [前景文字]**** 選項。使用 W3DC 色彩字串 (例如，"#FFFFFF") 設定 [背景色彩] 選項。
注意 Windows Phone 市集應用程式不允許您設定文字或背景色彩。快顯通知的背景色彩就是系統輔色 (使用者可在 [設定] 中選取)，而文字一律為淺色。
下列範例說明選擇這些選項後插入 package.appxmanifest 檔案的 XML。ForegroundText 和 BackgroundColor 屬性會新增至資訊清單的 VisualElements 元素中。
<VisualElements
...
ForegroundText="dark"
BackgroundColor="#FFFFFF">
</VisualElements>
步驟 3: 指定標誌影像
應用程式的小標誌影像顯示在每個快顯通知的右下角，為使用者識別是哪個應用程式引發了快顯通知。
注意 Windows Phone 8.1 不會使用這個標誌影像。磚只會顯示應用程式的顯示名稱 (在資訊清單中註明)，或什麼都不顯示。
如果您使用 Visual Studio 資訊清單編輯器，請設定 [視覺資產] 索引標籤中的 [30x30 正方形標誌]**** (Windows) 或 [44x44 正方形標誌] (Windows Phone) 影像路徑。指定的影像必須包含在應用程式的套件中。
下列範例說明選擇這些選項後插入 package.appxmanifest 檔案的 XML。SmallLogo 屬性會新增至資訊清單的 VisualElements 元素中。
<VisualElements
...
SmallLogo="images\smallTile-sdk.png">
</VisualElements>
備註
完成上述步驟後，您的應用程式即可傳送快顯通知給使用者。
完整範例
下列範例顯示範例 Windows 應用程式 package.appxmanifest 檔案中 VisualElements 元素的完整 XML，包括這個主題中討論的屬性。
<VisualElements
DisplayName="ToastsSample"
Logo="images\squareTile-sdk.png"
SmallLogo="images\smallTile-sdk.png"
Description="SDK Sample"
ForegroundText="dark"
BackgroundColor="#FFFFFF"
ToastCapable="true">
<DefaultTile ShortName="ToastsSample" ShowName="allLogos"/>
<SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
</VisualElements>