Choose Toolbox Items, WPF Components


For the latest documentation on Visual Studio 2017 RC, see Visual Studio 2017 RC Documentation.

This tab of the Choose Toolbox Items dialog box displays a list of Windows Presentation Foundation (WPF) controls available on your local computer. To display this list, select Choose Toolbox Items from the Tools menu to display the Choose Toolbox Items dialog box, and then select its WPF Components tab. To sort the components listed, select any column heading.

  • When the check box next to a component is selected, an icon for that component will be displayed in the Toolbox.

    System_CAPS_ICON_tip.jpg Tip

    To add an instance of a WPF control to a project document open for editing, drag its Toolbox icon onto the Design view surface. Default markup and code for the component are inserted into your project, ready for you to modify. For more information, see How to: Manage the Toolbox Window and How to: Manipulate Toolbox Tabs.

  • When the check box next to a component is cleared, the corresponding icon will be removed from the Toolbox.

    System_CAPS_ICON_note.jpg Note

    The .NET Framework components installed on your computer remain available whether or not icons for them are displayed in the Toolbox.

The columns on the WPF Components tab contain the following information:

Lists the names of WPF controls for which entries exist in your computer's registry.

Displays the hierarchy of the NIB: .NET Framework Class Library namespace that defines the structure of the component. Sort on this column to list the available components within each .NET Framework namespace installed on your computer.

Assembly Name
Displays the name of the .NET Framework assembly that includes the namespace for each component. Sort on this column to list the namespaces contained in each .NET Framework assembly installed on your computer.

Displays the location of the .NET Framework assembly. The default location for all assemblies is the Global Assembly Cache. For further information on the Global Assembly Cache, see Working with Assemblies and the Global Assembly Cache.

Filters the list of WPF controls based on the string you provide in the text box. All matches from any of the four columns are shown.

Clears the filter string.

Opens the Open dialog box, which lets you navigate to assemblies which contain WPF controls. Use this to load assemblies which are not located in the Global Assembly Cache.

Shows the localized language of the assembly which contains the selected WPF control.

Adding a custom control or UserControl to the Toolbox has the following limitations.

  • Works only for custom controls defined outside the current project.

  • Does not update correctly when you change the solution configuration from Debug to Release, or from Release to Debug. This is because the reference is not a project reference, but is for the assembly on disk instead. If the control is part of the current solution, when you change from Debug to Release, your project continues to reference the Debug version of the control.

In addition, if design-time metadata is applied to the custom control and this metadata specifies that the T:Microsoft.Windows.Design.ToolboxBrowsableAttribute is set to false, the control does not appear in the Toolbox.

You can reference your controls directly in XAML view by mapping the namespace and assembly for your control. For more information, see How to: Import a Namespace into XAML.

Choose Toolbox Items Dialog Box (Visual Studio)
How to: Use a Third-Party WPF Control in a WPF Application
WPF Designer