Share via


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)

Toolbox

Other Resources

WPF Designer