revit中的插件制作教程

我第一次的Revit插件概述您是欧特克Revit电力用户变得更具生产力感兴趣吗？你想实现自动化或扩展的Revit，但计算机编程的新功能吗？如果是这样，那么本指南旨在为您。我的第一个插件是自学教程指南为编程世界顺利引入。这是用户知道欧特克公司的产品，但绝对新的编程和想学正冒险的一站式商店学习路径。在本指南中，您将工作与欧特克Revit.NETAPI和C#编程语言，但是如果你更喜欢的编程语言VB.NET我们提供了这种语言中的代码示例。产品：AutodeskRevit*编程语言：C#（和VB.NET-不包括VB.NET代码样本的书面的解释）应用程序编程接口(API)：Revit.NETAPI*本指南是根据创建AutodeskRevit建筑。本指南中的所有步骤都都适用于任何的Revit三种口味的产品。本指南与2011或更高版本中，可以使用Revit结构或RevitMEP替换所有Revit建筑。版本2011和2012我们提供工作与VisualStudio工具的应用程序(VSTA)里面的存档教训的说明下载、VSTA已更换与SharpDevelop的Revit2013。概述有许多资源可用在web上为您了解AutodeskRevitAPI（应用编程接口），但是，这些资源往往为人已经知道编程设计。本指南是不同：它假定没有以前的编程知识，还可帮助您构建您的第一个插件快速，没有落得您的详细信息。你会在开始这种材料，不论您的编程专业的当前水平的一个小时内运行的应用程序。指南将开始通过审查进展到覆盖的AutodeskRevitAPI的使用经验教训上前自欧特克软件的好处。吸取的教训将开始通过建立工作的插件，才能覆盖更详细的解释的基本原则和进一步开发应用程序的功能。自定义AutodeskRevit的好处在今天的世界中，我们鼓励你变得更有效率。这是自定义的一个主要好处：定制软件您使用在日常基础上精简工作流程提高您的效率。欧特克公司提供了功能强大的Api和Sdk（软件开发工具包）使您可以通过定制它专门针对您的业务需要获得更大的价值，从您在欧特克软件的投资。欧特克Revit提供了一个丰富的API，可以用于自定义该产品的现有功能或通过添加全新的。可以自动执行重复性的、耗时的任务，无需离开AutodeskRevit环境扩展核心功能。可以使用API创建自定义工具和功能，直接插入AutodeskRevit，扩展其功能。欧特克Revit有一个.NETAPI，意味着您可以使用任何.NET兼容的编程语言（C#、VB.NET、F#等），开发插件。虽然每个语言都有自己的相对优势，C#是本指南的天然选择：它是很容易学习、容易使用和利用基本的.NET框架的力量。当你变得舒适与本指南-的内容和更熟练的C#-您将能够解决更为复杂的问题，在语言移动。有时尽管C#正在自然的选择，是何种语言，您可以在您的公司内工作与你控制范围之外的限制。编程语言VB.NET发生非常接近第二次到C#，所以以容纳读者希望与欧特克Revit；在VB.NET我们为您提供在VB.NET中的所有课代码。编程可以是非常有益的。我们希望你那种感觉太完成这些教训之后。玩得愉快！摘要插件我的第一个插件实现要复制一组（可以包含家具、隔断墙或机械电气水暖(MEP)元素）的命令从一个房间到另一个。它是很常见的建筑模型，以包含完全相同的家具布局和手动复制这些元素可以证明是耗时且乏味：它可以是有元素，例如保持相同的相对位置，很有挑战性。这种类型的任务非常适合用于AutodeskRevitAPI，通过自动化和本指南将带你通过这样做的过程。视频：完成插件该视频演示的最后插件你将在这一课6中创建我的第一个插件指南。在开始之前安装的软件•欧特克®Revit®体系结构本指南是适用的AutodeskRevit建筑2011年和后继版本。请替换'20xx'到您正在使用贯穿整个指南的产品版本。•Microsoft®VisualC#速成版这种材料的重点使用MicrosoftVisualC#2010年表示所需的步骤。使用其他版本的VisualStudio支持C#也是可能的。视频：如何安装VisualC#2010年快递经验教训总结第1课：基本插件在本课中，将创建您第一次基本AutodeskRevit插件复制到指定的位置，用户所选的组。第2课：编程概述在本课中，您将更仔细地审视执行插件代码，探索VisualC#速成版环境时，会发生什么。第3课：第一次看看代码在本课中，您将看您第一次深入AutodeskRevitAPI。我们会花时间在反过来理解的代码行中的每一课1，你看的C#代码键入到您的插件。此外，在探讨这种概念作为面向对象的编程、类、方法、变量声明、创建类的对象和属性。第4课：调试您的代码学习如何使用VisualStudio调试器逐句通过您的代码--逐行跟踪程序的执行；和观看的变量的值发生更改时由您的代码。第5课：简单选择的一组在本课中，您将提高插件选择功能，使它更容易为用户选择一个组，请确保您的插件预计有什么意外发生的可能。第6课：使用房间几何结构在本课中，您将扩展插件，将所选的组复制到它是在房间的中心位置。此外，探索这种RevitAPI和编程概念作为筛选与FilteredElementCollector和条件if语句。第7课：我的期末插件在本课中，您会通过扩展它以允许用户选择多个房间的组将被复制到完成插件的功能。第8课：学习更多在本课中，我们为您提供附加信息以创建AutodeskRevit插件时提高您的生产力。你会看看相关的API帮助、文件、样品和到哪里去下一步以继续您周围AutodeskRevitAPI的学习问题的信息。第1课：基本插件在本课中，将创建您第一次基本AutodeskRevit插件复制到指定的位置用户所选的组。视频：示范的课1步骤来创建您的第一个插件提供反馈：请提供关于这种Revit培训或通过电子邮件这一课的反馈：[e-mail]课下载lesson1_revit_2014_projects.zip(zip-20216Kb)lesson1_revit_2013_projects.zip(zip-28884Kb)lesson1_revit_2012_and_earlier_project_files.zip(zip-7283Kb)创建你的第一步骤插件1.启动VisualC#速成版开发环境：打开VisualC#2010年速成使用Windows开始菜单，选择所有程序，然后MicrosoftVisualStudio2010速成，然后MicrosoftVisualC#2010年速成的子菜单项。2.创建一个类库项目：里面VisualC#速成版，在文件菜单上单击新建项目。在已安装的模板选项卡的左侧窗口中，单击VisualC#。在中间的窗口中，单击类库。在名称框中输入Lab1PlaceGroup。然后单击确定.VisualC#速成版将会为您创建一个默认的代码项目并在代码窗口中显示的代码。3.保存项目：在文件菜单上单击全部保存。在显示窗口中键入C:\test在位置框中，然后单击保存。4.添加引用：在VisualC#速成版窗口右侧的解决方案资源管理器窗口中，右键单击引用，然后单击添加引用......5.单击浏览选项卡中的添加引用对话框和浏览到Revit产品安装的子文件夹。（子文件夹路径取决于在安装有Revit建筑201x。默认路径是C:\ProgramFiles\Autodesk\Revit体系结构201x\Program*).*路径可能随您使用AutodeskRevit的味道。您将从该文件夹中添加两个引用文件。选择RevitAPI.dll，在按住Ctrl键和选择RevitAPIUI.dll，然后单击确定。现在这两个接口在您的项目中引用的DLL文件。所有RevitApi都公开的这些接口文件和您的项目可以使用那些可用的Api，从他们的所有。6.设置引用的文件复制本地属性值：在解决方案资源管理器窗口中您看到在步骤5中，单击RevitAPI引用节点下。在属性窗口中，单击复制本地属性，然后单击下拉列表中，选择False。重复相同的步骤，RevitAPIUI复制本地属性值更改为False.7.设置目标.NET框架：注意:欧特克Revit2011支持.NETFramework3.5的使用。欧特克Revit2012以及更高支持.NET框架4.0，VisualC#2010年表示使用默认情况下的使用。需要以下步骤，以便使用正确的版本。如果您正在使用的Revit体系结构版本支持.NET框架4.0，你可以跳过步骤7、8和9。在解决方案资源管理器窗口中，右击Lab1PlaceGroup项目，然后单击属性.8.在显示项目属性表单中，请单击应用程序选项卡上的窗口左侧，单击目标框架，下方的下拉列表，然后单击列表中的.NETFramework3.5选项。9.下面的消息框会显示要求您确认。单击以确认更改。10.添加的代码：在解决方案资源管理器窗口中Class1.cs显示代码编辑窗口，请双击。删除在此窗口中的所有内容，然后键入下面的C#代码。要获得完整的VisualC#速成版——包括例如智能感知功能的使用——与开发经验我们建议您键入从本指南，而不是复制和粘贴代码。说，如果你也可以复制并粘贴到VisualC#速成版代码窗口中的时间约束：虽然这减少了从直接与代码工作获得的经验。11.usingSystem;12.usingSystem.Collections.Generic;13.usingSystem.Linq;14.15.usingAutodesk.Revit.DB;16.usingAutodesk.Revit.DB.Architecture;17.usingAutodesk.Revit.UI;18.usingAutodesk.Revit.UI.Selection;19.usingAutodesk.Revit.ApplicationServices;20.usingAutodesk.Revit.Attributes;21.22.[TransactionAttribute(TransactionMode.Manual)]23.[RegenerationAttribute(RegenerationOption.Manual)]24.publicclassLab1PlaceGroup:IExternalCommand25.{26.publicResultExecute(27.ExternalCommandDatacommandData,28.refstringmessage,29.ElementSetelements)30.{31.//Getapplicationanddocumentobjects32.UIApplicationuiApp=commandData.Application;33.Documentdoc=uiApp.ActiveUIDocument.Document;34.35.//DefineaReferenceobjecttoacceptthepickresult.36.ReferencepickedRef=null;37.38.//Pickagroup39.Selectionsel=uiApp.ActiveUIDocument.Selection;40.pickedRef=sel.PickObject(ObjectType.Element,Pleaseselectagroup);41.Elementelem=pickedRef.Element;42.Groupgroup=elemasGroup;43.44.//Pickapoint45.XYZpoint=sel.PickPoint(Pleasepickapointtoplacegroup);46.47.//Placethegroup48.Transactiontrans=newTransaction(doc);49.trans.Start(Lab);50.doc.Create.Plac