How to Read this Developer's Guide

When working with the yFiles WPF Viewer library component, the most important thing to understand is how the classes, and the functionality they provide, divide according to the Model-View-Controller paradigm.

Consequently, Chapter 2, Displaying and Editing Graphs is the most important chapter to read. It explains this division and describes the underlying graph structure implementation and the possibilities for the visual representation of all kinds of model items therein. It also presents the available view implementations that display a model, and discusses the comprehensive support for user interaction and how to customize it.

The remainder of the chapter presents high-level functionality for use in an application context, like printing support and option handler support for styles. The animation framework is discussed here, too. These sections can be equally skipped the first time in favor of Chapter 5, Architectural Concepts, for example. Read this chapter to learn about the essential look-up mechanism that is used by yFiles WPF and also about the concept for binding custom data to model items.

Additional functionality that is related to grouped graphs is presented in Chapter 3, Graph Hierarchies. Essentially, this chapter is an "extension" to Displaying and Editing Graphs, and hence should be read after it.

The I/O possibilities of yFiles WPF, including export to bitmap-based and vector graphics file formats, is described in Chapter 4, Input and Output. Note that this chapter is largely independent of any other parts of this document and can easily be skipped the first time.

Appendix A, Obfuscation is a must-read concerning the actual deployment of any product developed using the yFiles WPF library. It discusses the code protection requirements of the yFiles WPF license terms and helps in understanding how to fulfill them properly.

The information in Appendix B, License Mechanism is equally important, but relevant also for software development since it explains how to use yFiles WPF license files in yFiles WPF-based applications.

Figure 1.1. Developer's Guide structure

The structure of the yFiles WPF Developer's Guide.