Revit二次开发之如何在addin文件定制资源【比目鱼原创】

如果想在Revit中调用你开发的插件，需要对插件进行注册。Revit通过识别后缀为“addin”的文件来加载插件。Revit会在启动时自动搜索相应目录中的• addin文件并进行加载。

(1) 如果希望该插件只有当前用户可以使用，需要将文件放入：

① （Windows XP)C:\Documents and Settings\<user>\Application Data\Autodesk\ Revit \Addins\<版本号>\

② （Window 7) C: \ Users\ < user>\ AppData\ Roaming\ Autodesk\Revit\ Addins\ <版本号>\

(2) 如果希望所有用户都可以使用，需要将文件放入：

① （Windows XP)C:\Documents and Setting\All Users\Application Data\Autodesk\Revit\Addins\<版本号>\

② （Window 7)C:\ProgramData\Autodesk\Revit\Addins\<版本号>\

addin文件示例：

<?xml version="1.0" encoding="utf-8"?>
<RevitAddins>
<Addin>
<Assembly> c:\MyRevitProgram.dll< /Assembly>
	<Addlnld>604B1052-F742-4951-8576-C261D1993188< /Addlnld>
	<FullClassName> Revit.Samples.SampleCommand< /FullClassName>
	<Text> Sample command< /Text>
	<VisibilityMode> NotVisibleInFamily< /VisibilityMode>
	<VisibilityMode> NotVisibleInMEP< /VisibilityMode>
	<AvailabilityClassName > Revit. Samples. SampleAccessibilityCheck </ AvailabilityClassName>
	<LongDescription> < p> This is the long description for my command < /p> < p> This is another descriptive paragraph， with notes about how to use the command properly.< /p>
	</LongDescription>
	<TooltipImage> c:\MyProgram\Autodesk,jpg< /TooltipImage>
	<Largelmage> c:\MyProgram\MyProgramIcon.png< /Largelmage>
	<VendorId> ADSK< /VendorId>
	<VendorDescription> Autodesk^ www.autodesk.com< /VendorDescription> < /Addin〉
< /RevitAddIns>

Addin标签属性详细说明如下：

XML标签	描 述
Assembly	表示程序集的路径位置•毎个ExternalCommand和ExternalApplication都必须要有这个值
FuIlClassNnme	表示实观了 IExtcmalCommand或者lExtemalApplication接口的插件程序集的类名。一定要包括完整的命名空间。每个ExtemalCommand和ExternalApplication都必须要有这个值
Addlnld	表示插件的全局GUID。每一个插件需要有一个GUID 。这 个GU1D位是唯一的。可以UlApplication.ActiveAddinId 这个属性来获取对应addin 文件和对应插件的GUID。
Name	为插件指定一个名字。类型为ExternalApplication的插件需要指定这个值。
Text	“附加模块”选项卡中显示的名字。类型为ExtemalCommrmd的插件可以指定这个值
Description	表示该插件简短的描述，这段描述将作为按钮的提示文本。这个标签不是必须的。如果没有这个描述，Revit会将默认显示名字作为提示文本。只有类型为ExternalCommond的插件可以使用这个标签
VisibilityModc	表示插件的可见性。默认为在任何悄况下都显示插件，包括没有Active Document的情况。只有类型为ExternalCommand的插件可以使用这个标签
Discipline	表示该插件产品的可见性。默认为所有产品下都显示。只有类型为 ExternalCommand的插件可以使用这个标签
Largelmage	表示在外部工具下拉菜单中显示的大图标。如不设将默认不显示图片。只有类型为 ExternalCommand的插件可以使用这个标签
Smalllmage	表示在外部工具下拉菜单中显示的小图标。只有类型为ExternalCommand的插件可以使 用这个标签
LongDescription	表示一段长的描述，这段描述将作为按钮的提示文本的扩展部分。只有类型为 ExternalCommand的描件可以使用这个标签
Tooltiplmage	为插件的提示文本提供一个图片，当鼠标在这个外部命令上停留时就会显示。只有类型为 ExternalCommand的描件可以使用这个标签
LanguageType	表示语言种类。Revit支持11种语言。设置该标签后，Revit会在对应语言资源包中为外部工具按钮加载对应的Text，Description，Largelmage， LongDescription 以 及Tooltiplmage等的本地化资源
AllowLoadlnto ExistingSession	将该标签的值设成faUe将阻止Revn®不巫启就自动加载新加入到.addin文件里而的插件。如 不设K，Revit®默认不IE启自动加载新加入到.addm文件里面的插件
Vendorld	表示插件提供商的名称。对于ExternalCommand和ExtcrnalApplication都必须 为该标签指定一个位。该标签的值：要遵循Autodesk的命名标准。可以在官网http://www.autodesk.com/symbreg 网址注册。
VendorDescription	表示插件提供商的描述

如果想加载多个插件，只需将它们的程序集路径放到同一个.addm文件中即可。

=========【更多高级应用请关注公众号】========

===================================