WinForms and WPF Apps Programming Discussion

WinForms and WPF Apps Programming Discussion - kaisu1986/ATF GitHub Wiki

Table of Contents Programming Overview Application's Common Code WinForms Application WPF Application Topics in this section

These two applications are very simplified versions of the ATF Simple DOM Editor Sample, whose coding is described in detail in Simple DOM Editor Programming Discussion. These samples are adapted somewhat along the lines of the application developed starting with the Simple DOM Editor, described in Creating an Application from an ATF Sample.

The main point of these samples is to show how to develop both WinForms and WPF samples using ATF. The same ATF techniques are used as in Simple DOM Editor, so these two samples don't illustrate anything additional about ATF, per se.

Programming Overview

This page discusses what the common code for the two samples has in common with and how it differs from the ATF Simple DOM Editor Sample's code. The page also mentions the two samples' individual code, which is much smaller than their common code.

Application's Common Code

The bulk of the code in both ATF Win Forms App Sample and ATF Wpf App Sample is in common in the WinGuiCommon folder in the applications' source. Their common code provides nearly all the functionality of the samples, and demonstrates that ATF works well in both WinForms and WPF. This common code was taken from the ATF Simple DOM Editor Sample.

What was kept from the Simple DOM Editor:

Data model definition, in both the XML Schema, Schema class, and SchemaLoader.
Main editor window with ListView control.
Document class and client.
DOM adapters for event, resource, and event sequence types.
Contexts for events and event sequences.
Editor for main ListView.

What was left out from the Simple DOM Editor:

Palette window.
Resources window.
DOM node search, including GenericSelectionContext.
Help.

In what remains, Simple DOM Editor was translated into these samples' common code mainly by changing from "EventSequence" to "WinGuiCommonData" in file names, type names, class names, and so forth. For example, the WinGuiCommonData class corresponds to the EventSequence DOM adapter.

There are other minor differences as well, such as changing the extension of documents to ".gad".

WinForms Application

The Win Forms App illustrates a typical WinForms application. It does the following:

Initialization, such as calling appropriate Application class methods.
Setting up MEF TypeCatalog, if using MEF.
Creating a MainForm and running it.

For more information on developing a WinForms application with ATF, see WinForms Application.

WPF Application

Similarly, Wpf App shows a typical WPF application. It has these things:

A WpfApp.App class, defined in App.xaml, derived from the ATF class AtfApp.
MEF initialization if using MEF, defined in App.xaml.cs.

For a fuller description of creating an ATF application for WPF, see WPF Application.

Topics in this section

ATF Code Samples Discussions

Circuit Editor Programming Discussion: Learn how ATF handles graphs, and provides editors for kinds of graphs, such as circuits.
Code Editor Programming Discussion: Shows how to interface third party software to an ATF application: the ActiproSoftware SyntaxEditor.
Diagram Editor Programming Discussion: Very simply combines the Circuit Editor, Fsm Editor, and State Chart Editor components into one application, with the abilities of all three, showing the power of components.
DOM Property Editor Programming Discussion: Shows how to use the ATF DOM with an XML Schema to define application data with a large variety of attribute types, whose values can be viewed and edited using the ATF PropertyEditor component, using various value editors to view and edit attributes.
DOM Tree Editor Programming Discussion: Shows how to edit DOM data using a tree control and display properties in a variety of value editors.
File Explorer Programming Discussion: Discusses the ATF File Explorer Sample using list and tree controls with adapters.
FSM Editor Programming Discussion: Tells you about how the ATF FSM Editor Sample edits simple graphs for state machines, using DOM adapters for contexts and validation.
Model Viewer Programming Discussion: Shows how the ATF Model Viewer Sample is written, discussing how ATGI and Collada model data is handled, using rendering components, and using a DesignControl as a canvas for rendering.
Simple DOM Editor Programming Discussion: Programming the ATF Simple DOM Editor Sample, creating a palette, using DOM adapters and contexts, editing application data, and searching DomNodes.
Simple DOM No XML Editor Programming Discussion: Programming the ATF Simple DOM No XML Editor Sample, which is very similar to ATF Simple DOM Editor Sample, except that it doesn't use XML for either its data model or persisting application data.
State Chart Editor Programming Discussion: Shows using ATF graph and other classes to create a statechart editor, using DOM adapters, documents, contexts, and validators.
Target Manager Programming Discussion: Description of how a Target Manager is implemented using ATF components to manage target devices, such as PlayStation®Vita or PS3™ consoles. A Target Manager is used in other tools, such as the StateMachine tool.
Timeline Editor Programming Discussion: Discusses how to create a fairly full-featured timeline editor using the ATF timeline facilities, such as the timeline renderer and the timeline control and its manipulators.
Tree List Editor Programming Discussion: Demonstrates how to use the ATF tree controls TreeListView and its enhancement, TreeListViewEditor. TreeListView uses TreeListViewAdapter, which adapts TreeListView to display data in a tree.
Using Dom Programming Discussion: Shows how to use the various parts of the ATF DOM: an XML Schema, a schema metadata class file generated by DomGen, DOM adapters for the data types, a schema loader, and saving application data to an XML file.
WinForms and WPF Apps Programming Discussion: Overview of programming in both ATF Win Forms App Sample and ATF Wpf App Sample, which are simplified versions of the ATF Simple DOM Editor Sample.