創建 WPF 工具箱控件

創建 WPF 工具箱控件

WPF (Windows Presentation Framework) 工具箱控件模板允許您創建 WPF 控件，會自動添加到 工具箱 安裝擴展的安裝。 本主題演示如何使用模板來創建 工具箱 可以分發給其他用戶的控件。

創建 WPF 工具箱控件

與 WPF 工具箱控件中創建的擴展

1. 創建一個名為的 VSIX 項目 MyToolboxControl。 您可以找到中的 VSIX 項目模板 新項目 下的對話框 Visual C# / 可擴展性。

2. 在打開該項目，添加 WPF 工具箱控件 項模板名為 MyToolboxControl。 在 解決方案資源管理器, ，用鼠標右鍵單擊項目節點並選擇 添加 / 新項。 在 添加新項 對話框中，轉到 Visual C# / 可擴展性 ，然后選擇 WPF 工具箱控件。 在 名稱 在窗口的底部字段中，命令文件名稱更改為 MyToolboxControl.cs。

   該解決方案現在包含一個用戶控件， ProvideToolboxControlAttribute RegistrationAttribute ，將控件添加到工具箱, ，和一個 Microsoft.VisualStudio.ToolboxControl 資產部署的 VSIX 清單中的條目。

若要創建控件用戶界面

1. 在設計器中打開 MyToolboxControl.xaml。

   此設計器顯示包含 Button 控件的 Grid 控件。

2. 排列網格布局。 當您選擇 Grid 控制，網格的頂部和左側邊緣上顯示藍色的控件條。 您可以添加到網格的行和列，方法是單擊標題欄。

3. 將子控件添加到網格。 您可以通過將其從拖動定位子控件 工具箱 部分的網格中，或通過設置其 Grid.Row 和Grid.Column 在 XAML 中的屬性。 下面的示例在網格中，然后第二行上的按鈕的頂行上添加兩個標簽。

   <Grid>
       <Label Grid.Row="0" Grid.Column="0" Name="label1" />
       <Label Grid.Row="0" Grid.Column="1" Name="label2" />
       <Button Name="button1" Click="button1_Click" Grid.Row="1" Grid.ColumnSpan="2" />
   </Grid>

   重命名控件

默認情況下，您的控件將出現在 工具箱 作為 MyToolboxControl 中一個名為組MyToolboxControl.MyToolboxControl。 您可以更改這些名稱 MyToolboxControl.xaml.cs 文件中。

1. 在代碼視圖中打開 MyToolboxControl.xaml.cs。

2. 查找 MyToolboxControl 類並將它重命名為 TestControl。 (若要這樣做的最快方法是重命名類中，然后選擇 重命名從上下文菜單並完成的步驟。 (有關詳細信息 重命名 命令，請參閱 重命名重構 (C#)。)

3. 轉到 ProvideToolboxControl 屬性並更改的第一個參數的值 測試。 這是將包含控件中的組的名稱 工具箱。

   生成的代碼應如下所示︰

    

   [ProvideToolboxControl("Test", true)] 
   public partial class TestControl : UserControl 
   { 
       public TestControl() 
       { 
           InitializeComponent(); 
       } 
   }

    

    

    

生成、測試和部署

當調試項目時，您應會看到在安裝該控件 工具箱 的 Visual Studio 的實驗實例。

生成並測試控件

1. 重新生成項目並啟動調試。

2. 在 Visual Studio 的新實例中，創建 WPF 應用程序項目。 請確保 XAML 設計器處於打開狀態。

3. 在“工具箱”中查找控件，並將其拖動到設計圖面上。

4. 開始調試 WPF 應用程序。

5. 確認出現了您的控件。

部署控件

1. 生成測試的項目后，可以在項目的 \bin\debug\ 文件夾中找到的.vsix 文件。

2. 您可以安裝它在本地計算機上雙擊.vsix 文件並按照安裝過程。 若要卸載該控件，請轉到 工具 / 擴展和更新 並尋找控件擴展，然后單擊 卸載。

3. 將 .vsix 文件上載到網絡或網站。

   如果您將文件上載到 Visual Studio 庫 網站，其他用戶可以使用 工具 / 擴展和更新 在 Visual Studio 中查找聯機的控件並將其安裝。

創建 WPF 工具箱控件

創建 WPF 工具箱控件

 

WPF (Windows Presentation Framework) 工具箱控件模板允許您創建 WPF 控件，會自動添加到 工具箱 安裝擴展的安裝。 本主題演示如何使用模板來創建 工具箱 可以分發給其他用戶的控件。

啟動 Visual Studio 2015 中，您並不安裝 Visual Studio SDK 從下載中心獲得。 它將包括作為 Visual Studio 安裝程序中的可選功能。 您還可以在以后安裝 VS SDK。 有關更多信息，請參見 安裝 Visual Studio SDK。

創建 WPF 工具箱控件

與 WPF 工具箱控件中創建的擴展

1. 創建一個名為的 VSIX 項目 MyToolboxControl。 您可以找到中的 VSIX 項目模板 新項目 下的對話框 Visual C# / 可擴展性。

2. 在打開該項目，添加 WPF 工具箱控件 項模板名為 MyToolboxControl。 在 解決方案資源管理器, ，用鼠標右鍵單擊項目節點並選擇 添加 / 新項。 在 添加新項 對話框中，轉到 Visual C# / 可擴展性 ，然后選擇 WPF 工具箱控件。 在 名稱 在窗口的底部字段中，命令文件名稱更改為 MyToolboxControl.cs。

   該解決方案現在包含一個用戶控件， ProvideToolboxControlAttribute RegistrationAttribute ，將控件添加到工具箱, ，和一個 Microsoft.VisualStudio.ToolboxControl 資產部署的 VSIX 清單中的條目。

若要創建控件用戶界面

1. 在設計器中打開 MyToolboxControl.xaml。

   此設計器顯示包含 Button 控件的 Grid 控件。

2. 排列網格布局。 當您選擇 Grid 控制，網格的頂部和左側邊緣上顯示藍色的控件條。 您可以添加到網格的行和列，方法是單擊標題欄。

3. 將子控件添加到網格。 您可以通過將其從拖動定位子控件 工具箱 部分的網格中，或通過設置其 Grid.Row 和Grid.Column 在 XAML 中的屬性。 下面的示例在網格中，然后第二行上的按鈕的頂行上添加兩個標簽。

   <Grid> <Label Grid.Row="0" Grid.Column="0" Name="label1" /> <Label Grid.Row="0" Grid.Column="1" Name="label2" /> <Button Name="button1" Click="button1_Click" Grid.Row="1" Grid.ColumnSpan="2" /> </Grid>

重命名控件

生成、測試和部署