Autodesk.Revit.UI.AddInCommandBinding

Autodesk.Revit.UI.AddInCommandBinding是Revit API中的一个类，用于将自定义命令（或称插件）绑定到Revit界面中的按钮或菜单项，使用户可以方便地使用插件。

构造函数

Autodesk.Revit.UI.AddInCommandBinding类有一个构造函数，用于创建一个新的AddInCommandBinding对象。它的语法如下：

public AddInCommandBinding(
    UIControlledApplication application,
    string addInId,
    Type commandType
)

其中，参数说明如下：

• application：UIControlledApplication对象，表示当前Revit应用程序的界面控制器。
• addInId：字符串，表示插件的唯一标识符，与插件清单文件（manifest）中的id属性对应。
• commandType：Type对象，表示自定义命令的类型，即实现IExternalCommand接口的类型。

方法

AddInCommandBinding类有一个方法，用于将自定义命令绑定到Revit界面中的按钮或菜单项。它的语法如下：

public bool Bind()

该方法返回一个布尔值，表示绑定是否成功。如果绑定成功，返回true；否则返回false。

示例

下面是一个示例，演示如何将自定义命令绑定到Revit界面中的按钮：

public class MyCommand : IExternalCommand
{
    public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)
    {
        // 实现插件功能
        return Result.Succeeded;
    }
}

public class MyAddIn : IExternalApplication
{
    public Result OnStartup(UIControlledApplication application)
    {
        AddInCommandBinding binding = new AddInCommandBinding(application, "myAddInId", typeof(MyCommand));
        if (binding.Bind())
        {
            TaskDialog.Show("My Add-In", "Binding succeeded.");
            return Result.Succeeded;
        }
        else
        {
            TaskDialog.Show("My Add-In", "Binding failed.");
            return Result.Failed;
        }
    }

    public Result OnShutdown(UIControlledApplication application)
    {
        return Result.Succeeded;
    }
}

在该示例中，MyCommand类是实现了IExternalCommand接口的自定义命令类型。MyAddIn类实现了IExternalApplication接口，其中的OnStartup方法中创建了一个AddInCommandBinding对象，并将其绑定到了Revit界面中的按钮。如果绑定成功，弹出一个对话框提示；否则也弹出一个对话框提示。