[UWP]在應用退出時彈出確認提示框

1. 需求

在應用退出時（點擊右上角的關閉按鈕）彈出一個確認按鈕可以說是一個最常見的操作了，例如記事本的“你是否保存”：

但這個功能在UWP上居然有點小複雜。這篇文章將解釋如何實現這個功能。

2. CloseRequested

爲了監視應用退出事件，我本來使用了CoreApplication.Exiting，但好像並不起作用，後來我就沒再研究它的觸發機制了。在Windows 10 Creators Update (15063)以後UWP提供了一個新的API:SystemNavigationManagerPreview.CloseRequested事件。這個事件會在用戶點擊窗體右上角的關閉按鈕時觸發，開發者可以在這個事件裏處理保存數據、確認關閉等。最好在App.xaml.cs中的Window.Current.Activate();前後訂閱這個事件。

Window.Current.Activate();

SystemNavigationManagerPreview.GetForCurrentView().CloseRequested += (s, e) =>
{
    //DO STH
};

3. 彈出確認提示框

CloseRequested事件包含一個名爲SystemNavigationCloseRequestedPreviewEventArgs的EventArgs（名字真是超級長），它包含一個Handled屬性，如果要取消關閉事件，可以將Handled設置爲Ture，這點和WPF很像。SystemNavigationCloseRequestedPreviewEventArgs還提供了GetDeferral函數，它返回一個Deferral對象，它可以在異步操作中延遲UWP應用生命週期事件的執行，知道調用它的Complete方法。配合異步的ContentDialog，具體代碼如下：

Windows.UI.Core.Preview.SystemNavigationManagerPreview.GetForCurrentView().CloseRequested +=
async (sender, args) =>
{
    var deferral = args.GetDeferral();

    var messageDialog = new ContentDialog
    {
        Title = "記事本",
        Content = "你想要保存更改嗎?",
        PrimaryButtonText = "保存",
        SecondaryButtonText = "不保存",
        CloseButtonText = "取消"
    };

    messageDialog.DefaultButton = ContentDialogButton.Primary;

    var result = await messageDialog.ShowAsync();
    switch (result)
    {
        case ContentDialogResult.None:
            args.Handled = true;
            break;
        case ContentDialogResult.Primary:
            await SaveDataAsync();
            break;
        case ContentDialogResult.Secondary:
            break;
        default:
            break;
    }

    deferral.Complete();
};

private async Task SaveDataAsync()
{

}

在上面的代碼中，如果點擊取消按鈕，則將Handled設置爲true以取消關閉。點擊確認則保存數據再關閉應用。無論選擇哪個，最後都需要調用Deferral.Complete。最終運行效果應該如下（講真，ContentDialog真的醜）：

4. 添加應用功能聲明

有沒有發現上面"最終運行效果應該如下"中的應該兩字是粗體？因爲這時候上面的代碼還是沒有效果。究其原因，是因爲confirmAppClose是一個受限功能，必須修改應用程序包清單源文件（Package.appxmanifest），添加xmlns： rescap XML 命名空間聲明，並聲明受限功能。

<?xml version="1.0" encoding="utf-8"?>
<Package
    ...
    xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
    IgnorableNamespaces="... rescap">
...
<Capabilities>
    <rescap:Capability Name="confirmAppClose"/>
</Capabilities>
</Package>

這樣，在本地運行的時候，應用終於可以彈出確認提示框了。一旦使用了受限功能，應在提交應用到Microsoft Store的時候提供信息以便獲得批准，有一些功能只在極其特殊和有限的情況下才獲准在提交到 Microsoft Store 的應用中使用，幸好這裏時候的confirmAppClose很容易通過。在提交選項裏會出現受限的功能這一節，如實填寫就可以了，中文也可以。