Application: RvtSamples
Revit Platform: All
Revit Version: 2010.0
First Released For: 2009.0
Last Modified: 02/26/2008
Modified By: LL Autodesk 
Programming Language: C#
Skill Level: Beginning
Category: Basics
Type: ExternalApplication

Subject: Add menu items of samples to Revit.
Summary:
This sample integrates all other samples excluding ExternalApplications into a panel named “RvtSamples” under menu “Add-Ins”.

Classes: 
Autodesk.Revit.ControlledApplication
Autodesk.Revit.RibbonPanel
Autodesk.Revit.PulldownButton
Autodesk.Revit.PushButton
Autodesk.Revit.PulldownButtonData

Project Files: 
Application.cs
It contains the class Application which implements interface IExternalApplication.

Description: 
This sample provides following functionalities.
-	Extract samples information from a provided text file named “RvtSamples.txt” and parse them into menu items. The file can be customized and it must follow the following fixed format. 
Every menu item consists of seven lines. 
1.	The first line represents the name of the pulldown menu that the sample belongs to.  This pulldown menu will be available on the Ribbon and the command(s) associated to it will be added as required.  There are 12 pulldown menus included by default for organizing the samples in the Revit SDK.  These 12 samples will have appropriate icons and will automatically appear in the Ribbon.  If you choose to enter the name of a pulldown other than one of these 12, your pulldown will be added without an icon to the far right of the panel.
2.	The second line represents the display name of sample.
3.	The third line represents the description of the menu item.
4.	The fourth line represents the “RibbonItem.LargeImage” property. This should be the path to a 32x32 pixel image file shown on the button for this command. Optional, leave this line blank if there is no image to show.
5.	The fifth line represents the “RibbonItem.Image” property.  This should be a path to a 16x16 pixel image file shown if the command is promoted to the Quick Access Toolbar.  Optional, leave this line blank if there is no image to show.
6.	The sixth line represents the path of the assembly location of the menu item. 
[NOTE] In the provided text file every item is provided a default path within drive Z. To run the sample successfully, the default path must be modified to the samples’ real paths on your local drive. Assuming your samples local path is C:\Revit\SDK2009, you can either replace all “Z:” in the text file with “C:\Revit” or create a virtual drive Z (via running the dos command “SUBST Z: C:\Revit\SDK2009”).
4.	The last line represents the class name of the menu item.
-    “RvtSamples.txt” can be customized to include other files contain sample list. The files must follow the above fixed format. Every file to be included in “RvtSamples.txt” should be added to “RvtSamples.txt” and the line should start with “#include” (case-sensitive free). The file path can be quoted in “”, <> or nothing.

Instructions: 
To use this sample, the external application item should be added into Revit.ini first. Once that is done, menu items of samples provided in the text file will be added to Revit automatically every time Revit starts up.