この Visual Studio 統合開発環境 (IDE) の概要では、任意の Windows 10 以降のデバイスで実行される "Hello World" アプリを作成します。 これを行うには、Windows App SDK (WinUI 3) プロジェクト テンプレート、拡張アプリケーション マークアップ言語 (XAML)、および C# プログラミング言語を使用します。
手記
WinUI 3 は、 Windows App SDK に付属するネイティブ UI プラットフォーム コンポーネントです。 Windows SDK から完全に切り離されています。 詳細については、「WinUI 3 を参照してください。
前提 条件
- このチュートリアルを完了するには、Visual Studio 2026 または Visual Studio 2022 の最新バージョンが必要です。 無料版については、 Visual Studio のダウンロードを参照してください。
- WinUI と Windows App SDK を使用した開発に必要なワークロードとコンポーネント。 Visual Studio でワークロードを確認またはインストールするには、[ツール] >を選択します。 詳細については、「ワークロードまたは個々のコンポーネント変更する」を参照してください。
Visual Studio インストーラーの [ ワークロード ] タブで、次を選択します。
Windows App SDK を使用した C# アプリ開発の場合は、[ WinUI アプリケーション開発] を選択します。
Windows App SDK を使用した C# アプリ開発の場合は、[ WinUI アプリケーション開発] を選択します。
手記
Visual Studio 17.10 - 17.12 では、このワークロードは Windows アプリケーション開発と呼ばれます。
詳細については、「 Windows App SDK のインストール ツール」を参照してください。
プロジェクトを作成する
まず、WinUI 3 プロジェクトを作成します。 プロジェクトの種類には、何かを追加する前に、必要なすべてのテンプレート ファイルが付属しています。
Visual Studio を開き、スタート ウィンドウで [新しいプロジェクト の作成]選択します。
[ 新しいプロジェクトの作成 ] 画面で、検索ボックスに 「WinUI 」と入力し、 WinUI Blank App (Packaged) の C# テンプレートを選択して、[ 次へ] を選択します。
プロジェクトに HelloWorldという名前を付け、作成を選択します。
Visual Studio を開き、スタート ウィンドウで [新しいプロジェクト の作成]選択します。
[ 新しいプロジェクトの作成 ] 画面で、検索ボックスに 「winui 」と入力し、 空のアプリの C# テンプレートの C# テンプレート、パッケージ (デスクトップの WinUI 3) を選択し、[ 次へ] を選択します。
プロジェクトに HelloWorldという名前を付け、作成を選択します。
手記
この記事が Visual Studio を初めて使用して Windows App SDK アプリを作成する場合は、[ 設定] ダイアログが表示されることがあります。 [開発者モード ] を選択し、次に [はい ] を選択します。
Visual Studio によって、別の開発者モード パッケージがインストールされます。 パッケージのインストールが完了したら、[ 設定] ダイアログを閉じます。
アプリケーションを作成する
開発を始めましょう。 ここでは、ボタン コントロールを追加し、ボタンにアクションを追加してから、 Hello World アプリを実行して外観を確認します。
デザイン キャンバスにボタンを追加する
ソリューション エクスプローラーで、MainWindow.xaml ダブルクリックして XAML マークアップ エディターを開きます。
XAML エディター では、マークアップを追加または変更できます。 UWP プロジェクトとは異なり、WinUI 3 には デザイン ビューはありません。
<Grid>項目内で、<Buttonの入力を開始します。 Intellisense にはボタン オプションが用意されています。 Tab キーを押して同意します。
ソリューション エクスプローラーで、MainWindow.xaml ダブルクリックして XAML マークアップ エディターを開きます。
XAML エディター では、マークアップを追加または変更できます。 UWP プロジェクトとは異なり、WinUI 3 には デザイン ビューはありません。
ウィンドウのルートにある StackPanel にネストされた Button コントロールをレビューします。
ボタンのラベルを変更する
XAML エディターで、Button Content の値を現在の値から "Hello World!" に変更します。
<Button>要素の開始タグ (Contentなど、既存の属性の後) にカーソルを置き、「クリック」と入力します。 Intellisense には、Button_Clickと呼ばれる新しいイベント ハンドラーが用意 されます。 次のセクションでは、そのコードを操作します。
XAML エディターで、Button Content の値を現在の値から "Hello World!" に変更します。
ボタンに Click イベント ハンドラー myButton_Click 指定されていることにも注意してください。 次の手順では、この操作を行います。
イベント ハンドラーを変更する
イベント ハンドラー 複雑に思われますが、イベントが発生したときに呼び出されるコードの名前にすぎません。 この場合、Hello World によってトリガーされるアクションが追加されます。 ボタン
ソリューション エクスプローラー で、コードビハインド ページの MainWindow.xaml.csをダブルクリックします。
開いた C# エディター ウィンドウでイベント ハンドラー コードを編集します。
ここで興味深い情報が得られます。 既定のイベント ハンドラーは次のようになります。
これを変更してみましょう。次のようになります。
コピーして貼り付けるコードを次に示します。
private async void Button_Click(object sender, RoutedEventArgs e) { var welcomeDialog = new ContentDialog() { Title = "Hello from HelloWorld", Content = "Welcome to your first Windows App SDK app.", CloseButtonText = "Ok", XamlRoot = ((FrameworkElement)sender).XamlRoot }; await welcomeDialog.ShowAsync(); }
ソリューション エクスプローラー で、コードビハインド ページの MainWindow.xaml.csをダブルクリックします。
開いた C# エディター ウィンドウでイベント ハンドラー コードを編集します。
ここで興味深い情報が得られます。 既定のイベント ハンドラーは次のようになります。
これを変更してみましょう。次のようになります。
コピーして貼り付けるコードを次に示します。
private async void myButton_Click(object sender, RoutedEventArgs e) { var welcomeDialog = new ContentDialog() { Title = "Hello from HelloWorld", Content = "Welcome to your first Windows App SDK app.", CloseButtonText = "Ok", XamlRoot = myButton.XamlRoot }; await welcomeDialog.ShowAsync(); }
私たちは何をしましたか?
このコードでは、ContentDialog コントロールを使用して、現在のウィンドウ内のモーダル ポップアップ コントロールにウェルカム メッセージを表示します。
Microsoft.UI.Xaml.Controls.ContentDialogの使用方法の詳細については、「ContentDialog クラス」を参照してください。
アプリケーションを実行する
次に、Hello World Windows App SDK アプリをビルド、デプロイ、起動して、その外観を確認します。 その方法を次に示します。
[再生] ボタンを使用して、ローカル コンピューターでアプリケーションを起動します。 HelloWorld (パッケージ) というテキストが含まれています。
または、メニュー バーから [デバッグ] >選択するか、F5 キー 押してアプリを起動することもできます。
スプラッシュ画面が消えた直後に表示されるアプリを表示します。 アプリは次の画像のようになります。
Hello World ボタンを選択します。
Windows 10 以降のデバイスには、"Hello from HelloWorld" というタイトルの "最初の Windows App SDK アプリへようこそ" というメッセージが表示されます。[ OK] を 選択してメッセージを閉じます。
アプリを閉じるには、ツール バーの [デバッグの停止] ボタンを選択します。 または、メニュー バーから [デバッグ>ストップ デバッグ ] を選択するか、 Shift キーを押しながら F5 キーを押します。
関連するコンテンツ
このチュートリアルを完了しておめでとうございます。 Windows App SDK、WinUI 3、および Visual Studio IDE に関するいくつかの基本を学習していただければ幸いです。 詳細については、次のチュートリアルに進んでください。
チュートリアル: WinUI 3 を使用して簡単なフォト ビューアーを作成する
これらのリソースは、次の場合にも役立ちます。