Usage via Assembly References
For WPF projects targeting the full .NET framework (4.x), you will find the ShellBrowser components in the "Jam Software" tab of the "ToolBox" in Visual Studio:
When dragging a component from here to your form, a reference to the ShellBrowser assemblies is added automatically:
Note: If you are targeting .NET Core 3.1 or .NET 5.0, you will most likely not find the components in the ToolBox after installation. Please use the local NuGet packages instead.
Usage of the NuGet Packages
If your project is targeting .NET Core 3.1 or .NET 5.0, the ShellBrowser WPF Components will only be available in Visual Studio's toolbox if you reference the NuGet package.
Also for .NET 4.x you might prefer usage of the nuget-package over referencing the assembly.
To include ShellBrowser WPF nuget-packages to your project:
•In Visual Studio configure NuGet packages for the project or the solution.
•In the dialog select "ShellBrowser.WPF packages" as NuGet source. It has automatically been added as package source during installation.
•Install both the ShellBrowser.Core and ShellBrowser.WPF packages for the projects.
•You should see the ShellBrowser components being added to the ToolBox in tab "ShellBrowser WPF Controls", and also see the references in Solution Explorer:
The ToolBox now dispays the components contained in the NuGet package:
SDK Format
If you are using the sdk format for the projects using ShellBrowser.WPF, depending on the .NET Framework you are targeting and also the components you are using, you might have to add
<UseWindowsForms>true</UseWindowsForms>
to your project file. This is because some of the WPF components use Windows Forms as base. Missing this, will result in build errors due to missing assemblies in projects targeting NET 4.x.
Use debug assemblies
•Remove the ShellBrowser reference from your project, might the NuGet packages or assemblies be used.
•Add new assembly references to the debug versions of <ShellBrowserWPF.dll> and <ShellBrowser.Core.dll> and <ShellBrowser.Winforms.dll> (if required).
By default they are located in <PROGRAM FILES>\JAM Software\ShellBrowser .WPF Edition\debug.
Note, that depending on the configuration of your project, ShellBrowser might appear in section "References" or "Assemblies".