Revit API-WPF可停靠面板（Dockable Panel）高度设置异常问题

问题根源 #

Revit会自动保存上一次会话中可停靠面板的布局状态，单纯通过InitialState设置高度会被缓存的旧状态覆盖，导致启动时面板高度不符合预期。

解决步骤 #

1. 代码层面强制覆盖状态

不要仅依赖InitialState，在插件启动后直接获取面板实例并强制设置尺寸：

// 在插件OnStartup方法中，注册面板后执行
DockablePaneId paneId = new DockablePaneId(new Guid("你的面板GUID"));
DockablePane pane = application.GetDockablePane(paneId);

// 强制设置固定高度与布局
pane.SetState(new DockablePaneState
{
    DockPosition = DockPosition.Bottom,
    Width = application.MainWindow.Width, // 铺满主窗口宽度
    Height = 50, // 目标固定高度
    MinimumHeight = 50,
    MinimumWidth = 400
});

2. 绑定Idling事件延迟修正

如果启动时直接设置不生效，可借助Idling事件延迟执行（避开Revit缓存加载时机）：

public Result OnStartup(UIControlledApplication application)
{
    // 注册面板逻辑...

    application.Idling += Application_Idling;
    return Result.Succeeded;
}

private void Application_Idling(object sender, IdlingEventArgs e)
{
    UIControlledApplication app = sender as UIControlledApplication;
    DockablePaneId paneId = new DockablePaneId(new Guid("你的面板GUID"));
    DockablePane pane = app.ActiveApplication.GetDockablePane(paneId);

    // 检查当前高度是否符合预期，不符合则重置
    if (pane.State.Height != 50)
    {
        pane.SetState(new DockablePaneState
        {
            DockPosition = DockPosition.Bottom,
            Width = app.ActiveApplication.MainWindow.Width,
            Height = 50,
            MinimumHeight = 50,
            MinimumWidth = 400
        });
        // 只执行一次，避免重复触发
        app.Idling -= Application_Idling;
    }
}

3. WPF控件端限制尺寸

在面板对应的WPF UserControl中，直接固定控件高度，防止内容撑开面板：

<UserControl x:Class="YourNamespace.YourPanel"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             Height="50" MaxHeight="50"
             VerticalAlignment="Top">
    <!-- 面板内容 -->
</UserControl>

关键注意点 #

• 必须确保MinimumHeight与目标高度一致，防止用户拖拽调整；
• 若需要禁止用户修改高度，可结合DockablePaneState的IsResizable属性设为false；
• 测试时可手动清除Revit缓存文件（路径：%appdata%\Autodesk\Revit\Autodesk Revit [对应版本]\下的UI状态文件），避免旧缓存干扰。

内容的提问来源于stack exchange，提问作者M45