Troubleshooting

Q. When I run my application, I get a XamlParseException. The inner exception is “An instance of type ‘Mindscape.WpfDiagramming.Foundation.DiagramSurface’ was being created, and a valid license could not be granted for the type ‘Mindscape.WpfDiagramming.Foundation.DiagramSurface’.”

A. If you receive this exception and you have a full licence or a trial licence which has not expired, check that your project contains a licences.licx file (in the Properties folder). This file should be automatically generated by the Visual Studio WPF designer when you add a DiagramSurface control either via the designer or the XAML editor. If Visual Studio has not generated this file, either: (a) drag a DiagramSurface from the toolbox onto the designer (and delete it again) to get Visual Studio to regenerate the licences.licx file; or (b) copy a licenses.licx file from one of the sample projects.

If you are building an application (EXE) which uses a library (DLL) which uses WPF Diagrams, you will also need to add a licenses.licx to the application project.

You will also receive this exception if you are using a trial licence which has expired.

Q. After installation, I don’t see a Mindscape tab in the Visual Studio toolbox.

This is an issue with the Visual Studio Toolbox Controls Installer. Use the normal Add Tab and Choose Items menu options to add the control to the toolbar, or if you prefer to work in XAML rather than the designer, just use Add Reference in your project. The diagramming assemblies are located in the Mindscape folder under your Program Files directory and a link is provided in the Start menu.