类名:IExternalCommandAvailability+IExternalCommand实现对某些控件的自定义使用

起初对于这些名词不懂,后经查阅了解如下,希望对学习者能有所帮助。在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;
        }

猜你喜欢

转载自blog.csdn.net/VS18703761631/article/details/88990353
今日推荐