起初对于这些名词不懂,后经查阅了解如下,希望对学习者能有所帮助。在Revil里大部分命令在没有打开文档的时候是禁用的,有的在没有打开文档也是可以使用的。而又一些在平面视图是禁用的如标高,有的在3D视图里是禁用的 如标高和轴网,类似于在revit中对于某些组文件进行相应的标注他们的长宽高等,在二维三维中使用则不同,并且会受到限制。而这些是否可用我们是可以自己控制的。在PushButton的属性里有一个AvailabilityClassName属性,通过这个就可实现命令在什么时候可用,禁用的控制。
这个属性是个string,它需要设置为一个实现了IExternalCommandAvailability接口的类的全类名
比如这样一个命令,它实现了IExternalCommand,IExternalCommandAvailability这两个接口
public class ExternalCommandAvailability : IExternalCommand,IExternalCommandAvailability { public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements) { TaskDialog.Show("test", "test ok"); return Result.Succeeded; } public bool IsCommandAvailable(UIApplication applicationData, CategorySet selectedCategories) { return true; } }
那在创建按钮的时候可以这样指定
application.CreateRibbonTab(tabName); RibbonPanel panel = application.CreateRibbonPanel(tabName, panelName); PushButtonData btnData=new PushButtonData("testcmd","cmd", this.GetType().Assembly.Location, "RevitApiTest.TestCommand"); PushButton btn =(PushButton)panel.AddItem(btnData); btn.AvailabilityClassName = "RevitApiTest.TestCommand";
如果在IsCommandAvailable里直接返回true,那这个命名就是任何时候都可以使用。
假设用户有一个命令需要在平面视图里禁用那可以如下实现
public bool IsCommandAvailable(UIApplication applicationData, CategorySet selectedCategories) { UIDocument uidoc = applicationData.ActiveUIDocument; if (uidoc.ActiveGraphicalView is ViewPlan) return false; return true; }