共用方式為


建立 WPF 工具箱控制項

使用 WPF (Windows Presentation Framework) 工具箱控制項範本,可讓您建立 WPF 控制項,在安裝延伸模組時自動新增到 [工具箱]。 本逐步解說說明如何使用範本建立可散發給其他使用者的 [工具箱] 控制項。

建立工具箱控制項

使用 WPF 工具箱控制項建立延伸模組

  1. 建立名為 MyToolboxControl 的 VSIX 應用程式專案。 您可以在 [新增專案] 對話方塊中搜尋「vsix」來尋找 VSIX 專案範本。

  2. 當專案開啟時,新增名為 MyToolboxControl 的 [WPF 工具箱控制項] 項目範本。 在 [方案總管] 中,以滑鼠右鍵按一下專案節點,並選取 [新增]>[新增項目]。 在 [新增專案] 對話方塊中,移至 [Visual C#]>[擴充性],然後選取 [WPF 工具箱控制項]。 在視窗底部的 [名稱] 欄位中,將命令檔名變更為 MyToolboxControl.cs

    方案現在包含一個使用者控制項、一個將控制項新增至 [工具箱]ProvideToolboxControlAttributeRegistrationAttribute,以及 VSIX 資訊清單中一個用於部署的 Microsoft.VisualStudio.ToolboxControl 資產專案。

建立控制項 UI

  1. 在設計工具中開啟 MyToolboxControl.xaml

    設計工具會顯示包含了 Button 控制項的 Grid 控制項。

  2. 排列方格配置。 當您選取 Grid 控制項時,藍色控制項橫條會出現在方格的上邊緣和左邊緣。 您可以按下橫條,將資料列和資料行新增至方格。

  3. 將子控制項新增至方格。 您可以將子控制項從 [工具箱] 拖曳至方格的區段,或在 XAML 中設定其 Grid.RowGrid.Column 屬性,來放置子控制項。 下列範例會在方格的頂端資料列加上兩個標籤,並在第二列新增一個按鈕。

    <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 屬性,並將第一個參數的值變更為 Test。 這是將在 [工具箱] 中包含該控制項的群組名稱。

    產生的程式碼應該如下所示:

    [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 Marketplace 網站,其他使用者就可以在 Visual Studio 中使用 [工具]>[延伸模組和更新] 在線上尋找並安裝控制項。