逐步解說：設計階段期間在 Windows Form 上建立新的 Windows Presentation Foundation 內容

發行項
08/21/2008

更新：2007 年 11 月

本主題會示範如何建立 Windows Presentation Foundation (WPF) 控制項以便在 Windows Forms 架構應用程式中使用。

在這個逐步解說中，您會執行下列工作：

建立專案。
建立新的 WPF 控制項。
將新的 WPF 控制項加入到 Windows Form。WPF 控制項會裝載到 ElementHost 控制項中。

注意事項：
根據您目前使用的設定或版本，您所看到的對話方塊與功能表命令可能會與 [說明] 中描述的不同。若要變更設定，請從 [工具] 功能表中選擇 [匯入和匯出設定]。如需詳細資訊，請參閱 Visual Studio 設定。

必要條件

您需要下列元件才能完成此逐步解說：

Visual Studio 2008。

建立專案

第一步是建立 Windows Form 專案。

注意事項：
裝載 WPF 內容時，只支援 C# 和 Visual Basic 專案。

若要建立專案

在 Visual Basic 或 Visual C# 中，建立名為 HostingWpf 的新 Windows Form 應用程式專案。如需詳細資訊，請參閱 HOW TO：建立 Windows 應用程式專案。

建立新的 WPF 控制項

建立新的 WPF 控制項並將其加入到專案中，就像將其他任何項目加入到專案中一樣容易。Windows Form 設計工具搭配一種特定的控制項運作，這種控制項稱為「複合控制項」(Composite Control) 或「使用者控制項」(User Control)。如需 WPF 使用者控制項的詳細資訊，請參閱 UserControl。

注意事項：
WPF 的 System.Windows.Controls.UserControl 型別不同於 Windows Form 所提供的使用者控制項型別，該型別又稱為 System.Windows.Forms.UserControl。

若要建立新的 WPF 控制項

在 [方案總管] 中，將新的 [使用者控制項 (WPF)] 項目加入至專案中。使用控制項型別的預設名稱 UserControl1。如需詳細資訊，請參閱 HOW TO：新增及移除方案項目。使用預設名稱 UserControl1.xaml。

加入控制項會具有下列效果。
- UserControl1.xaml 檔案會加入到專案中。
- UserControl1.xaml.cs 或 UserControl1.xaml.vb 的其中一個檔案會加入到專案中。這個檔案包含事件處理常式和其他實作的程式碼後置 (Code-Behind)。
- WPF 組件的參考會加入到專案中。
- UserControl1.xaml 檔案會在 Windows Presentation Foundation (WPF) Designer for Visual Studio 中開啟。
在 [設計] 檢視下，確定已選取 UserControl1。如需詳細資訊，請參閱 HOW TO：在設計介面上選取並移動項目。
在 [屬性] 視窗中，將 Width 和 Height 屬性的值設定為 200。
從 [工具箱]，將 System.Windows.Controls.TextBox 控制項拖曳到設計介面。
在 [屬性] 視窗中，將 Text 屬性的值設定為 Hosted Content。

注意事項：

一般而言，您應該裝載更為複雜的 WPF 內容。System.Windows.Controls.TextBox 控制項在此僅供說明用途使用。
建置專案。

注意事項：
一般而言，您應該裝載更為複雜的 WPF 內容。System.Windows.Controls.TextBox 控制項在此僅供說明用途使用。

將 WPF 控制項加入至 Windows Form

您的新 WPF 控制項已經準備好在表單上使用。Windows Form 會使用 ElementHost 控制項裝載 WPF 內容。

若要將 WPF 控制項加入至 Windows Form

在 Windows Form 設計工具中開啟表單 Form1。
在 [工具箱] 中，找到標記為 [HostingWpf WPF 使用者控制項] 的索引標籤。
將 UserControl1 的執行個體拖曳到表單上。
- 便會自動在表單上建立 ElementHost 控制項以裝載 WPF 控制項。
- ElementHost 控制項的名稱為 elementHost1，而且在 [屬性] 視窗中，您可以看到其 Child 屬性已設定為 [UserControl1]。
- WPF 組件的參考會加入到專案中。
- elementHost1 控制項具有智慧標籤面板，顯示可用的裝載選項。
在 [ElementHost 工作] 智慧標籤面板中，選取 [停駐於父容器中]。
按 F5 建置並執行應用程式。