Revit API 创建模仿官方的实时显示的Dockablepanel

主要是使用了idling事件和dockablepane api

 

就像revit自带的属性面板一样，选择图元时自动切换成图元的属性，这里只显示了ElementID等基本信息

 

必须用WPF窗口，不能用winforms

 

Revit开发中的可停靠面板（DockablePanel）必须在IExternalApplication中注册。以下是具体原因：

注册要求

• 接口规定：DockablePane的注册是通过UIControlledApplication接口的RegisterDockablePane方法实现的。
• 生命周期管理：IExternalApplication提供了OnStartup和OnShutdown方法，分别在Revit启动和关闭时执行，适合进行可停靠面板的注册和清理。

其他方式注册的局限性

• 外部命令（IExternalCommand）：
  • 无法显示面板：虽然在IExternalCommand中可以注册DockablePane，但无法使其显示。调用Show()方法会报错。
  • 生命周期不匹配：IExternalCommand仅在命令执行期间有效，无法持续管理面板的生命周期。

 

话不多说直接上代码

 

using Autodesk.Revit.Attributes;
using Autodesk.Revit.DB;
using Autodesk.Revit.UI;
using Autodesk.Revit.UI.Events;
using System;
using System.Linq;
using System.Reflection;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;namespace RealTimeSelectionPanel
{// Ribbon 按钮：显示/隐藏面板[Transaction(TransactionMode.Manual)]public class ShowPaneCommand : IExternalCommand{public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements){DockablePane pane = commandData.Application.GetDockablePane(App.PaneId);if (pane.IsShown())pane.Hide();elsepane.Show();return Result.Succeeded;}}// 程序入口public class App : IExternalApplication{public static DockablePaneId PaneId = new DockablePaneId(new Guid("D8F6A921-3C5E-4B2A-9F1D-7E8B5C9A1F3E"));public static UIControlledApplication ControlledApp { get; private set; }public Result OnStartup(UIControlledApplication application){ControlledApp = application;// 创建 RibbonRibbonPanel rp = application.CreateRibbonPanel("实时面板");PushButtonData pbd = new PushButtonData("ShowRealTimePane","实时选中信息",Assembly.GetExecutingAssembly().Location,typeof(ShowPaneCommand).FullName);PushButton pb = rp.AddItem(pbd) as PushButton;pb.ToolTip = "打开右侧实时显示选中元素信息的面板";// 注册 DockablePane（关键：传入自己作为 provider）application.RegisterDockablePane(PaneId, "实时选中信息", new SelectionMonitorProvider());return Result.Succeeded;}public Result OnShutdown(UIControlledApplication application) => Result.Succeeded;}// 核心类：负责创建面板 + 监听 Idlingpublic class SelectionMonitorProvider : IDockablePaneProvider{private static TextBlock _infoTextBlock;public void SetupDockablePane(DockablePaneProviderData data){var root = new StackPanel{Background = new SolidColorBrush(System.Windows.Media.Color.FromRgb(250, 250, 250)),Margin = new Thickness(0)};root.Children.Add(new TextBlock{Text = "实时选中元素信息",FontSize = 18,FontWeight = FontWeights.Bold,Margin = new Thickness(0, 0, 0, 20),HorizontalAlignment = HorizontalAlignment.Center,Foreground = new SolidColorBrush(System.Windows.Media.Color.FromRgb(0, 110, 200))});_infoTextBlock = new TextBlock{Text = "请在视图中选择元素",FontSize = 15,TextWrapping = TextWrapping.Wrap,Foreground = Brushes.Gray,Background = Brushes.White,Padding = new Thickness(12),MinHeight = 120};var border = new Border{Child = _infoTextBlock,BorderBrush = Brushes.White,BorderThickness = new Thickness(1),CornerRadius = new CornerRadius(6),Background = Brushes.White};root.Children.Add(border);data.FrameworkElement = root;data.InitialState = new DockablePaneState { DockPosition = DockPosition.Right };App.ControlledApp.Idling += OnIdling;}// 每帧都会进来一次，非常快，非常安全private static void OnIdling(object sender, IdlingEventArgs e){if (_infoTextBlock == null) return;UIApplication uiApp = sender as UIApplication;if (uiApp?.ActiveUIDocument == null) return;UIDocument uidoc = uiApp.ActiveUIDocument;Document doc = uidoc.Document;var ids = uidoc.Selection.GetElementIds();string text;if (ids == null || ids.Count == 0){text = "未选中任何元素";}else if (ids.Count == 1){Element elem = doc.GetElement(ids.First());text = $"ID: {elem.Id.IntegerValue}\n" +$"类别: {elem.Category?.Name ?? "无"}\n" +$"名称: {elem.Name ?? "无"}\n" +$"类型: {doc.GetElement(elem.GetTypeId())?.Name ?? "无"}";}else{text = $"选中了 {ids.Count} 个元素\n第一个 ID: {ids.First().IntegerValue}";}// 直接更新 UI（因为 Idling 本来就在主线程）_infoTextBlock.Text = text;_infoTextBlock.Foreground = ids.Count > 0 ? new SolidColorBrush( System.Windows.Media.Color.FromRgb(0, 120, 0)) : Brushes.Gray;}}
}