ATF Win Forms App Sample - kaisu1986/ATF GitHub Wiki

Table of Contents

Description

WinFormsApp is a a basic WinForms sample application. It illustrates how to compose a WinForms application with ATF components using MEF. It is a starting point for an application, such as an editor, though WinFormsApp does not offer any editing capabilities.

The WinFormsApp sample shares much code with the WpfApp sample, so the two provide a similar set of capabilities. In fact, the two applications differ by only a few files; the bulk of the application code is in common. This demonstrates the ease of developing an ATF application and converting it from WinForms to WPF or vice versa.

For details on programming in the sample, see WinForms and WPF Apps Programming Discussion.

ATF Features Demonstrated by WinFormsApp

  • Use of Managed Extensibility Framework (MEF) to put applications together.
  • Use of the application shell framework, including CommandService, SettingsService, ControlHostService and WindowLayoutService.
  • Show loading a schema with SchemaLoader.

Run WinFormsApp

  1. Double-click the WinFormsApp.exe in ATF\Samples\WinFormsApp\bin\Release.
  2. A dialog appears with a list box for application data.

Menu and Toolbar Options

  • File: create a new or open an existing Gui App Data (.gad) file, Save, Save as, Save all, Close and Exit WinFormsApp.
  • Edit:
    • Keyboard Shortcuts: use the Customize Keyboard Shortcuts window to set up keyboard shortcuts.
    • Load or Save Settings: use the Load and Save Settings window to save current WinFormsApp application settings or load application settings from a file.
    • Preferences: set application preferences, such as command icon size.
  • Window:
    • Tile Horizontal: tile window panes horizontally.
    • Tile Vertical: tile window panes vertically.
    • Tile Overlapping: overlap window panes horizontally.
    • Layouts:
      • Save Layout As...: associate the current layout with a name.
      • Manage Layouts...: show a list of layouts and manage the list.
    • Lock/Unlock UI Layout: lock/unlock window pane layout.
    • List of checked menu items; check to activate the corresponding control.
The toolbar offers a subset of these capabilities: Lock/Unlock UI Layout and File commands to save, save as, save all, create a new, or open existing Gui App Data (.gad) file.

How to Use WinFormsApp

WinFormsApp provides a schema with event, animation and other types; it also has the capability of loading a schema. WinFormsApp also has code to handle events and resources involving DomNodes. However, it does not provide editing capabilities for creating or changing application data.

WinFormsApp Modules

Modules perform these functions:

  • Program.cs: Contains the Main program. It creates a TypeCatalog listing the ATF and internal classes used.
  • Editors.cs: Implements IDocumentClient to open, show, save and close documents.
  • SchemaLoader.cs: Loads the event schema, registers data extensions on the DOM types, annotates the types with display information and PropertyDescriptors.
  • EventContext.cs and WinGuiCommonDataContext.cs: Provide a context for data.

Topics in this section

ATF Code Samples

  • Circuit Editor: Editor for circuits, consisting of modules with input and output pins and connections between them.
  • Code Editor: Code editor that uses the ActiproSoftare SyntaxEditor to provide an editing Control.
  • Diagram Editor: Combines the Circuit, Finite State Machine, and State Chart editors into a single application to show how multiple editors can share an application shell and editor components.
  • DOM Property Editor: Demonstrates property editing, with a large variety of property editing controls and property descriptors.
  • File Explorer: Shows how to build a simple Windows® Explorer-like application to view the contents of a disk.
  • FSM Editor: Finite state machine editor.
  • Model Viewer: Shows how to use the ATF's ATGI and Collada file loaders and OpenGL® rendering.
  • Simple DOM Editor: Demonstrates the use of the DOM (Document Object Model), including defining a data model.
  • Simple DOM No XML Editor: Very similar to the Simple DOM Editor sample, but does not use XML.
  • State Chart Editor: Editor for statecharts.
  • Target Manager: Shows how to use the TargetEnumerationService to discover, add, configure and select targets, which are network endpoints, such as TCP/IP addresses, PS3™ DevKits or PlayStation®Vita DevKits.
  • Timeline Editor: Relatively full-featured timeline editor whose components have been used in real production tools.
  • Tree List Editor: Shows how to create and add entries to various kinds of Tree lists, including a hierarchical list to display selected folders' underlying folders and files.
  • Using Direct2D: Demonstrates how to use Direct2D and ATF classes that support Direct2D.
  • Using Dom: Simple demo of basic DOM use.
  • Win Forms App: Basic WinForms sample application.
  • Wpf App: Basic WPF sample application.
⚠️ **GitHub.com Fallback** ⚠️