宏指令 (快顯通知 XML 架構)

指定快顯通知中顯示的按鈕。

元素階層

<吐 司>

<行動>

<輸入>

Syntax

<action content = string
    arguments = string
    activationType? = "foreground" | "background" | "protocol"
    afterActivationBehavior? = "default" | "pendingUpdate"
    placement? = "contextMenu"
    imageUri? = string
    hint-inputid = string
    hint-buttonStyle = "Success" | "Critical"
    hint-toolTip = string
/>

答案

? 選擇性 (零或一個)

屬性和項目

屬性

屬性	描述	資料類型	必要	預設值
內容	按鈕上顯示的內容。	字串	Yes	無
引數	App 定義的引數字串，如果使用者按一下此按鈕，App 稍後會收到該字串。	字串	Yes	無
類型	可傳遞至相關聯應用程式的自變數字串，以提供它應該執行以回應使用者動作之動作的特定數據。	字串	Yes	無
activationType	決定使用者以特定動作進行互動時使用的啟用類型。 “foreground” - 預設值。 啟動您的前景 App。 “background” - 觸發您對應的背景工作，而且您可以在背景中執行程序代碼，而不會中斷使用者。 “protocol” - 使用通訊協定啟用來啟動不同的應用程式。	字串	No	“前景”
afterActivationBehavior	指定當使用者對快顯通知採取動作時，快顯通知應該使用的行為。 “default” - 預設值。 當使用者對快顯通知採取動作時，將會關閉快顯通知。 “pendingUpdate” - 使用者按兩下快顯通知上的按鈕之後，通知會維持在「擱置更新」視覺狀態中。 您應該立即更新背景工作的快顯通知，讓使用者不會看到太久的這個「擱置中的更新」可見狀態。	字串	No	"default"
放置	當設定為 「contextMenu」 時，動作會變成新增至快顯通知操作功能表的內容功能表動作，而不是傳統快顯通知按鈕。	字串	No	無
imageUri	快顯通知按鈕圖示之影像來源的URI。 這些圖示是白色透明 16x16 像素影像，縮放比例為 100%，而且影像本身應該不包含邊框間距。 如果您選擇在快顯通知上提供圖示，您必須為通知中的所有按鈕都提供圖示，因為這會將按鈕樣式轉換為圖示按鈕。 使用下列其中一個通訊協定處理程式： http:// 或 https:// - Web 映像。 ms-appx：/// - 應用程式套件中包含的影像。 ms-appdata：///local/ - 儲存至本機記憶體的影像。 file:/// - 本機映射。 (僅支持傳統型應用程式。UWP app.) 無法使用此通訊協定	字串	No	無
hint-inputId	設定為 輸入旁邊的 [ 要定位] 按鈕的輸入識別碼。	字串	No	無
hint-buttonStyle	按鈕樣式。 useButtonStyle 必須在 快顯 通知元素中設定為 true。 “Success” - 按鈕為綠色 「重大」- 按鈕為紅色。 請注意，這些值區分大小寫。	字串	No	無
hint-toolTip	如果按鈕有空的內容字串，則按鈕的工具提示。	字串	No	無

子元素

無

父項目

Parent 項目	描述
actions	用於宣告最多五個輸入的容器元素，以及快顯通知最多五個按鈕動作。

另請參閱

• 快顯通知內容
• 通知視覺化工具