共用方式為

How to： 建立使用 WPF 的工具箱控制項

  • 發行項

WPF 工具箱控制項範本中包含的Visual Studio 2010 SDK讓你能夠生產 Windows Presentation Foundation (WPF) 控制項，會自動加入至工具箱安裝擴充功能時。 本主題將說明如何使用範本來建立工具箱控制項，您可以發佈給其他使用者。WPF 工具箱控制項的完整實作，請參閱逐步解說： 建立 WPF 工具箱控制項。

注意事項注意事項

如需有關 Visual Studio 的 SDK 的詳細資訊，請參閱擴充 Visual Studio 的概觀。若要了解如何下載 Visual Studio 的 SDK，請參閱Visual Studio 擴充性開發人員中心 MSDN 網站上。

建立工具箱控制項

使用 WPF 工具箱控制項範本來建立專案，然後再行更新 「 可延伸應用程式標記語言 (XAML) 設計師 」 中的使用者介面 (UI)。

若要建立 WPF 工具箱控制項專案

  1. 在 [檔案] 功能表上，按一下 [新增]，然後按一下 [專案]。

  2. 在新的專案 對話方塊後，在 安裝的範本，按一下您偏好的程式設計語言的節點，然後按一下 擴充性。 在 [專案類型清單中，選取 [ WPF 工具箱控制項。

  3. 在名稱方塊中，輸入您想要用於專案的名稱。 按一下 [確定]。

    Visual Studio 建立的方案中包含使用者控制項的屬性，以將控制項放在工具箱，和部署資訊清單的 VSIX。

若要建置控制項的 UI

  1. 在方案總管] 中，連按兩下以開啟設計工具] 中的 ToolboxControl.xaml。

    設計工具會顯示Grid控制項，其中包含Button控制項。

  2. 排列格線版面配置。

    當您選取 [ Grid控制，藍色的控制項的欄將顯示在方格的上方和左側邊緣。 您可以加入列和欄格線列，即可。

  3. 將子控制項加入至方格中。

    您可以將子控制項，拖曳它從工具箱區段的方格中，或藉由設定其Grid.Row和Grid.Column在 XAML 中的屬性。 下列範例會將放入方格的第一列的兩個標籤，並將按鈕放在第二個資料列。

    <Button Content="Reset" Name="button1" Click="button1_Click" Grid.Row="1" Grid.ColumnSpan="2" />
<Label Content="{Binding Text}" Grid.Row="0" Grid.Column="0" Name="label1" />
<Label Content="{Binding Count}" Grid.Row="0" Grid.Column="1" Name="label2" />

控制項撰寫程式碼

預設情況下，您的控制項則會出現在工具箱 與 ToolboxControl1 在工具箱具有相同的名稱，做為您方案的項目群組。 您可以變更這些 ToolboxControl.xaml.cs 檔案中的名稱。

控制項的程式碼

  1. 在方案總管] 中ToolboxControl.xaml.cs 上按一下滑鼠右鍵，然後選擇 檢視程式碼在程式碼] 檢視中開啟檔案。

  2. 實作控制項的部分類別定義，請以滑鼠右鍵按一下類別名稱，請按一下重構，然後按一下 [ 重新命名。 將類別的名稱變更為您想要顯示在名稱工具箱安裝控制項時。

  3. 正上方的類別定義中，在ProvideToolboxControl在屬性宣告中，變更將會裝載該控制項中的項目群組的名稱的第一個參數值工具箱。

    下列範例所示ProvideToolboxControl屬性並調整過的類別定義控制項，名為計數器在一般項目群組。

    [ProvideToolboxControl("General", true)]
public partial class Counter : UserControl

  4. 實作屬性、 方法和事件的控制項。

建置、 測試和部署

按 F5 建置專案，包括.vsix 部署檔案，並開啟已安裝在該控制項的 Visual Studio 的第二個執行個體工具箱。

若要建置和測試控制項

  1. 按 F5。

  2. 在 Visual Studio 的新執行個體，建立 WPF 應用程式專案。

  3. 尋找您的控制項，在工具箱 ，並將其拖曳至設計介面。

  4. 在屬性 ] 視窗中，請確認您的內容可如預期般出現。

  5. 加入任何程式碼或測試您的方法及事件所需的其他控制項。

  6. 按 F5 以開啟 [WPF 應用程式。

  7. 請確認屬性、 方法和事件，控制項的行為表現如預期般運作。

若要將控制項部署

  1. 建置測試的專案之後，請在 Windows 檔案總管] 中開啟專案的 [\bin\debug\] 資料夾，然後找出.vsix 檔案。

  2. 上載.vsix 檔案，到網路或網站。

    如果您上載檔案到Visual Studio 庫 的網站，其他使用者可以使用 擴充管理員 Visual Studio，若要尋找的控制項，並將它安裝在。

請參閱

工作

逐步解說： 建立 WPF 工具箱控制項

How to： 建立使用 Windows Form 的工具箱控制項

其他資源

工具箱 (Visual Studio SDK)