Revit二次开发之添加选项卡和按钮

  我们日常在revit开发中经常会用到按钮，可以通过revitAPI提供的接口创建按钮，今天我简单介绍一下两种按钮，一种是单命令按钮，另一种是含下拉菜单的按钮，包括创建他们的方法。

实现方法

1.实现思路

  创建按钮的思路大体为：1、编写好自己的命令文件（一般就是继承IExteralCommand接口）；2、创建一个继承IExternalApplication接口的文件；3、编辑Addin文档，并将其放入C:\ProgramData\Autodesk\Revit\Addins\2020\路径下。

2.添加必要的引用

using Autodesk.Revit.UI;
using Autodesk.Revit.DB;
using System.Windows.Media.Imaging;
using Autodesk.Revit.Attributes;

3.示例代码

namespace HelloRevit
{
	[Transaction(TransactionMode.Manual)]
	public class CsAddPanel:IExternalApplication
	{
		public Result OnStartup(UIControlledApplication application)
		{
			//新建一个选项卡，并在该选项卡总新建一个命令栏（命令栏可以放多个命令按钮）
			application.CreateRibbonTab("NewTab");
			RibbonPanel ribbonPanel = application.CreateRibbonPanel("NewTab", "TabBar");
			//1、建立一个可下拉的命令栏
			//1.1、新建一个可下拉按钮
			SplitButtonData sbd1 = new SplitButtonData("Name", "Text");
			SplitButton sb1 = ribbonPanel.AddItem(sbd1) as SplitButton;
			//1.2、在该按钮添加两个按钮
			PushButtonData p1 = new PushButtonData("Helloworld1", "按钮1", @"E:\practice\Retrieve\CreateModelLine\bin\Debug\CreateModelLine.dll", "CreateModelLine.Class1");
			PushButton pushButton1 = sb1.AddPushButton(p1);
			PushButtonData p2 = new PushButtonData("Helloworld2", "按钮2", @"E:\practice\Retrieve\ClassLibrary4\bin\Debug\ClassLibrary4.dll", "ClassLibrary4.Class1");
			PushButton pushButton2 = sb1.AddPushButton(p2);
			//2、在选项卡栏添加一个普通按钮
			PushButtonData p3 = new PushButtonData("Helloworld3", "按钮3", @"E:\practice\Retrieve\Retrieve\bin\Debug\Retrieve.dll", "Retrieve.Document_Selection");
			PushButton pushButton3 = ribbonPanel.AddItem(p3) as PushButton;
			//3、先准备一张图片,后面给按钮加图片。（这里要引用PresentationCore程序集，再引用system.windows.media.imaging）
			Uri uriImage = new Uri(@"E:\practice\HelloRevit\HelloRevit\bin\Debug\1.jpg");
			BitmapImage largeImage = new BitmapImage(uriImage);
			//3.1、将图片赋值给按钮。PushButton有两个属性，当按钮是堆叠时，显示的是Image；当按钮是下拉或单个的时候显示的是LargeImage。
			pushButton1.LargeImage = largeImage;
			pushButton2.LargeImage = largeImage;
			pushButton3.LargeImage = largeImage;
			return Result.Succeeded;
		}
		public Result OnShutdown(UIControlledApplication application)
		{
			return Result.Succeeded;
		}
	}
}

注意：PushButtonData()内四个参数，第三个参数为外部命令文件所在。

4.编辑Addin文件

<?xml version="1.0" encoding="utf-8"?>
<RevitAddIns>
  <AddIn Type="Application">
    <Name>CreateButton</Name>
    <Assembly>D:\practice\HelloRevit\HelloRevit\bin\Debug\HelloRevit.dll</Assembly>
    <AddInId>6cdba932-c058-4ec1-b038-33ed590c41d3</AddInId>
    <FullClassName>HelloRevit.CsAddPanel</FullClassName>
    <VendorId>ADSK</VendorId>
  </AddIn>
</RevitAddIns>

注意将Addin文件放入上面所提位置，FullClassName就是该文件命名空间下的类（本文例子的命名空间为HelloRevit，类名为CsAddPanel）

5.Ribbon菜单插件介绍

  其他按钮创建方法与上面分享方法类似，希望对大家有所帮助。