assets/samples/Samples/ModelessDialog/ModelessForm_ExternalEvent/CS/README_extracted.txt

Application: ModelessForm_ExternalEvent
Revit Platform: All
Revit Version: 2013.0
First Released For: 2013.0
Programming Language: C#
Skill Level: Medium
Category: Basics
Type: ExternalCommand and ExternalApplication

Subject: Show Modeless Form (External Event)
Summary: 
This sample shows how to utilize an External Event object in order to communicate with the Revit API from an external modeless dialog.

Classes: 
Autodesk.Revit.DB;
Autodesk.Revit.UI;
Autodesk.Revit.UI.Events;

Project Files: 
Command.cs
It contains the class Command which inherits from interface IExternalCommand and implements the Execute method.

Application.cs
It contains the class Command which inherits from interface IExternalApplication and implements its methods.

Request.cs
The class around a variable holding the current request.

RequestHandler.cs
The class with methods to execute requests made by the dialog user.

ModelessForm.cs
The class of our modeless dialog.


Description: 
This sample shows how to utilize an External Event object in order to communicate with the Revit API from an external modeless dialog.

Instructions: 
1.      
Start Revit and create a new document
2.      
Create a few walls and add some doors to it - stay in a floor-plan view
3.      
Start the AddIn command - " Show Modeless Form (External Event)
4.      
When the dialog appears, select some of the doors
5.      
Use the command buttons in the modeless dialog to manipulate the doors