使用 C++/CX 建立 "Hello, World!"UWP 應用程式 (XAML)

本教學課程會教您如何使用 XAML 和 C# 建立適用於 Windows 上通用 Windows 平台 (UWP) 的簡單 Hello, World應用程式。 使用 Microsoft Visual Studio 中的單一專案，您可以建置可在所有 Windows 10 和 Windows 11 版本上執行的應用程式。

您將在此處了解如何：

• 建立目標是 Windows 10 和 UWP 的新 Visual Studio 專案。
• 撰寫 XAML 以變更您開始頁面上的 UI。
• 在本機電腦上於 Visual Studio 中執行專案。
• 使用 SpeechSynthesizer 讓應用程式在您按下按鈕時說話。

在開始之前..

• 什麼是 Windows 通用應用程式？
• 下載 Visual Studio (和 Windows)。 如果您需要協助，請了解如何開始設定。
• 我們亦假設您使用的是 Visual Studio 中預設的視窗配置。 如果您變更預設配置，您可以在 [視窗] 功能表中使用 [重設視窗配置] 命令來重設它。

注意

本教學課程使用 Visual Studio Community 2017。 如果您使用不同版本的 Visual Studio，它的外觀可能會略有不同。

步驟 1：在 Visual Studio 中建立新專案

1. 啟動 Visual Studio。

2. 從 [檔案] 功能表，選取 [新增] > [專案] 來開啟 [新增專案] 對話方塊。

3. 從左邊的範本清單中，選擇 [已安裝] > [Visual C#] > [Windows 通用] 來查看 UWP 專案範本的清單。

   (如果您沒有看到任何「通用」範本，表示您可能遺失用於建立 UWP 應用程式的元件。您可以重複安裝程序並加入 UWP 支援，方法是按一下 [新增專案] 對話方塊上的 [開啟 Visual Studio 安裝程式]。請參閱開始設定。)

   

4. 選擇 [空白應用程式 (通用 Windows)] 範本，然後輸入 "HelloWorld" 作為 [名稱]。 選取 [確定]。

   

   注意

   如果這是您第一次使用 Visual Studio，您可能會看到 [設定] 對話方塊要求您啟用 [開發人員模式]。 開發人員模式是啟用某些功能的特殊設定，例如，直接執行應用程式的權限，而非只執行來自 Microsoft Store 的。 如需詳細資訊，請閱讀啟用您的裝置以進行開發。 若要繼續使用此指南，請選取 [開發人員模式]，按一下 [是]，並關閉對話方塊。

   

5. [目標版本/最小版本] 對話方塊隨即出現。 在這個教學課程中使用預設設定即可，因此請選取 [確定] 來建立專案。

   

6. 當您的新專案開啟時，其檔案會顯示在右邊的 [方案總管] 窗格中。 您可能需要選擇 [方案總管] 索引標籤 (而不是 [屬性] 索引標籤)，才能看到您的檔案。

   

雖然 [空白應用程式 (通用 Windows)] 是最基本的範本，它仍然包含許多檔案。 這些檔案對於所有使用 C# 的 UWP 應用程式都是必要的。 您在 Visual Studio 中建立的每個專案都包含這些檔案。

檔案提供哪些內容？

若要檢視和編輯您專案中的檔案，請在 [方案總管] 中按兩下該檔案。 像展開資料夾一樣展開 XAML 檔案，以檢視它的關聯程式碼檔案。 XAML 檔案會在分割檢視中開啟，同時顯示設計介面與 XAML 編輯器。

注意

何謂 XAML？ Extensible Application Markup Language (XAML) 是一種用來定義您應用程式使用者介面的語言。 您可以手動輸入它，或使用 Visual Studio 設計工具來建立它。 .xaml 檔案具有一個包含邏輯的 .xaml.cs 程式碼後置檔案。 XAML 與程式碼後置一起構成完整的類別。 如需詳細資訊，請參閱 XAML 概觀。

「App.xaml 和 App.xaml.cs」

• App.xaml 是宣告整個應用程式使用資源的檔案。
• App.xaml.cs 是 App.xaml 的程式碼後置檔案。 它就像所有程式碼後置頁面一樣，包含一個呼叫 InitializeComponent 方法的建構函式。 您不需要撰寫 InitializeComponent 方法。 它是由 Visual Studio 產生的，而且主要用途是初始化 XAML 檔案中宣告的元素。
• App.xaml.cs 是您應用程式的進入點。
• App.xaml.cs 也包含處理應用程式啟用和暫停的方法。

「MainPage.xaml」

• MainPage.xaml 是您為應用程式定義 UI 的地方。 您可以使用 XAML 標記直接新增元素，也可以使用 Visual Studio 提供的設計工具。
• MainPage.xaml.cs 是 MainPage.xaml 的程式碼後置頁面。 其正是您新增應用程式邏輯和事件處理常式的位置。
• 這兩個檔案一起定義名為 MainPage 的新類別，這是繼承自 HelloWorld 命名空間中的 Page。

「Package.appxmanifest」

• 一個描述您應用程式的資訊清單檔案：其名稱、描述、磚、開始頁面等。
• 包含您應用程式所包含的相依性、資源和檔案的清單。

一組標誌影像

• Assets/Square150x150Logo.scale-200.png 和 Wide310x150Logo.scale-200.png 會在 [開始] 功能表中代表您的應用程式 (無論是 [中] 還是 [寬] 大小)。
• Assets/Square44x44Logo.png 會在 [開始] 功能表的應用程式清單、工作列，以及工作管理員中代表您的應用程式。
• Assets/StoreLogo.png 會在 Microsoft Store 中代表您的應用程式。
• Assets/SplashScreen.scale-200.png 是您應用程式啟動時顯示的啟動顯示畫面。
• Assets/LockScreenLogo.scale-200.png 可以用來在系統鎖定時的鎖定畫面上代表應用程式。

步驟 2：新增按鈕

使用設計工具檢視

讓我們將按鈕新增到我們的頁面中。 在本教學課程中，您只處理先前所列的幾個檔案：App.xaml、MainPage.xaml 和 MainPage.xaml.cs。

1. 按兩下 MainPage.xaml 以在 [設計] 檢視中開啟它。

   您會注意到畫面上半部有一個圖形檢視，而 XAML 程式碼檢視則在下方。 您可以對任一檢視進行變更，但目前我們會使用圖形檢視。

   

2. 按一下左邊的垂直 [工具箱] 索引標籤來開啟 UI 控制項清單。 (您可以按一下其標題列中的釘選圖示來讓它保持可見。)

   

3. 展開 [通用 XAML 控制項]，然後將 [按鈕] 拖曳到設計畫布的中間。

   

   如果您看一下 XAML 程式碼視窗，您就會看到那裡也已新增該按鈕:

<Button x:Name="button" Content="Button" HorizontalAlignment="Left" Margin = "152,293,0,0" VerticalAlignment="Top"/>

4. 變更按鈕的文字。

   在 XAML 程式碼檢視中按一下，然後將內容從「按鈕」變更為 "Hello, world!"。

<Button x:Name="button" Content="Hello, world!" HorizontalAlignment="Left" Margin = "152,293,0,0" VerticalAlignment="Top"/>

請注意設計畫布中顯示的按鈕如何更新成顯示新的文字。

步驟 3：啟動應用程式

到目前為止，您已經建立了一個非常簡單的應用程式。 您可以趁現在建置、部署和啟動您的應用程式，並看看它的外觀。 您可以在本機電腦、模擬器或遠端裝置上進行應用程式的偵錯。 以下是在 Visual Studio 中的目標裝置功能表。

在傳統型裝置上啟動應用程式

根據預設，應用程式會在本機電腦上執行。 目標裝置功能表提供從傳統型裝置系列的裝置偵錯應用程式的數個選項。

• 模擬器
• 本機電腦
• 遠端電腦

在本機電腦上開始偵錯

1. 在 [標準] 工具列上的目標裝置功能表 () 上，確定已選取 [本機電腦]。 (這是預設選項。)
2. 按一下工具列上的 [開始偵錯] 按鈕 ()。

–或–

從 [偵錯] 功能表，按一下 [開始偵錯]。

–或–

按下 F5。

應用程式會在視窗中開啟，預設啟動顯示畫面會先顯示。 啟動顯示畫面是由影像 (SplashScreen.png) 和背景色彩 (在應用程式的資訊清單檔案中指定) 所定義。

啟動顯示畫面消失之後，接著就出現您的應用程式。 它的外觀如下。

按下 Windows 鍵以開啟 [開始] 功能表，然後顯示所有應用程式。 請注意，在本機部署應用程式會將其磚加入 [開始] 功能表。 若要在稍後再次執行該應用程式 (不使用偵錯模式)，請點選或按一下它在 [開始] 功能表中的磚。

應用程式還沒有太多功能，但是恭喜您，您已經建置您的第一個 UWP 應用程式了！

停止偵錯

按一下工具列中的 [停止偵錯] 按鈕 ()。

–或–

從 [偵錯] 功能表，按一下 [停止偵錯]。

–或–

關閉應用程式視窗。

步驟 4：事件處理常式

「事件處理常式」聽起來很複雜，但這只是事件發生時所呼叫之程式碼的另一個名稱 (例如使用者按一下您的按鈕)。

1. 如果您尚未停止應用程式執行，請停止應用程式執行。

2. 按兩下設計畫布上的按鈕控制項，讓 Visual Studio 為您的按鈕建立事件處理常式。

當然，您也可以手動建立所有的程式碼。 或者，您可以按一下按鈕來選取它，然後查看右下方的 [屬性] 窗格。 如果您切換到 [事件] (小閃電圖示)，則可以新增事件處理常式的名稱。

3. 編輯 MainPage.xaml.cs (程式碼後置頁面) 中的事件處理常式程式碼。 事情從這開始變得有趣。 預設的事件處理常式看起來會像這樣：

private void Button_Click(object sender, RoutedEventArgs e)
{

}

我們會變更它，讓它看起來像這樣：

private async void Button_Click(object sender, RoutedEventArgs e)
{
    MediaElement mediaElement = new MediaElement();
    var synth = new Windows.Media.SpeechSynthesis.SpeechSynthesizer();
    Windows.Media.SpeechSynthesis.SpeechSynthesisStream stream = await synth.SynthesizeTextToStreamAsync("Hello, World!");
    mediaElement.SetSource(stream, stream.ContentType);
    mediaElement.Play();
}

請確定方法簽章現在也包含 async 關鍵字，否則您在嘗試執行應用程式時將會收到錯誤。

我們剛剛做了什麼？

這個程式碼使用一些 Windows API 來建立語音合成物件，然後提供一些讓它說出的文字。 (如需有關使用 SpeechSynthesis 的詳細資訊，請參閱 SpeechSynthesis 命名空間文件。)

當您執行應用程式並按一下按鈕時，您的電腦 (或手機) 就會逐字說出 "Hello, World!"。

摘要

恭喜！您已經建立您的第一個適用於 Windows 和 UWP 的應用程式！

若要了解如何使用 XAML 來配置應用程式將使用的控制項，請嘗試進行格線教學課程，或是直接進行後續步驟？

另請參閱

• 您的第一個應用程式
• 發佈您的 UWP 應用程式。
• 開發 UWP 應用程式的操作說明文章
• 適用於 UWP 開發人員的程式碼範例
• 什麼是 Windows 通用應用程式？
• 註冊 Windows 帳戶