Autodesk.Revit.UI.PushButtonData

Autodesk.Revit.UI.PushButtonData是Revit API中用于创建Revit Ribbon中的按钮的类。它可以设置按钮的名称、图标、描述、操作等属性。

构造函数

public PushButtonData(string name, string text, string assemblyName, string className);

• name：按钮的名称，必填项，唯一标识该按钮。
• text：按钮的显示名称，必填项，用于在Revit界面上显示该按钮。
• assemblyName：包含按钮操作的程序集名称。可以使用typeof来引用。
• className：按钮操作的完全限定名称，包括命名空间和类名。

属性

• Applicatons：PushbuttonData属性的列表。这通常用于添加上下文菜单项目或使用相似的按钮应用程序。

• AvailabilityClassName：使用自定义类来检查按钮是否可用的名称。该类必须实现IAvailability接口。

• ToolTip：鼠标悬停在按钮上时显示的提示文本。

• LargeImage：大图标，大小为32x32。

• Image：标准大小的图标，大小为16x16。

• TextImageRelation：指示文本和图像之间的关系的按钮类型。

• Description：在Revit中显示的按钮描述。

方法

• SetContextualHelp(ContextualHelp contextualHelp)：设置上下文帮助。

• SetToolTip(string toolTip)：设置鼠标提示。

• SetLargeImage(ImageSource imageSource)：设置按钮的大图标。

• SetImage(ImageSource imageSource)：设置按钮的标准大小的图标。

• SetToolTipImage(ImageSource imageSource)：设置鼠标悬停时显示的图片。

• SetDescription(string description)：设置按钮的描述。

示例

PushButtonData buttonData = new PushButtonData(
    "MyButton", 
    "Click Me", 
    "MyAssembly.dll", 
    "MyNamespace.MyClass");

buttonData.LargeImage = new BitmapImage(new Uri("/MyImages/MyButtonLarge.png", UriKind.Relative));
buttonData.Image = new BitmapImage(new Uri("/MyImages/MyButton.png", UriKind.Relative));
buttonData.ToolTip = "This is my button";
buttonData.Description = "This button does something cool!";
PushButton button = panel.AddItem(buttonData) as PushButton;

上述代码创建了一个名为“MyButton”的按钮，该按钮将调用“MyNamespace.MyClass”类中的操作。它还设置了用于在Revit中显示的按钮各种属性。

结论

Autodesk.Revit.UI.PushButtonData是创建Revit中按钮的重要类。它可以设置按钮的各种属性，使其在Revit界面中以最佳方式显示，并为其指定操作。它是扩展Revit功能的关键类。