WPF Components Tab, Choose Toolbox Items Dialog Box
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.
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.
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:
Name
Lists the names of WPF controls for which entries exist in your computer's registry.Namespace
Displays the hierarchy of the .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 and version 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.Directory
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 and Deployment and the Global Assembly Cache.
Filter
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.Clear
Clears the filter string.Browse
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.Language
Shows the localized language of the assembly which contains the selected WPF control.Version
Shows the build version of the assembly which contains the selected WPF control.
Limitations
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 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.
See Also
Tasks
How to: Use a Third-Party WPF Control in a WPF Application
Reference
Choose Toolbox Items Dialog Box (Visual Studio)