revit API 實現可停靠窗口

---恢復內容開始---

1.新建類庫項目，項目中新建WPF用戶控件（UserControl）得到名為UserControl1的實例。

revit中可停靠窗口的父類為page類，同時也繼承了IDockablePaneProvider接口。

所以需要將相關地方改為圖中所示內容。

 2.接下來需要在隱藏代碼中實現接口中的SetupDockablePane（）函數以初始化窗口狀態。

public void SetupDockablePane(DockablePaneProviderData Data)
        {
            Data.FrameworkElement = this as FrameworkElement;

            Data.InitialState = new DockablePaneState();
            Data.InitialState.DockPosition = DockPosition.Bottom;
        
        }

這樣就完成了我們的UserControl1。

而且我們的窗口將出現在底部。

 3.接下來在revit中注冊一個可停靠窗口（順帶添加一個命令按鈕）

static string path = typeof(Panel).Assembly.Location;
        
        public Result OnStartup(UIControlledApplication application)
        {
            RibbonPanel ribbonPanel = application.CreateRibbonPanel("窗口");

            PushButton pushButton = ribbonPanel.AddItem(new PushButtonData
                ( "DockPanel1","可停靠",path,"DockPanel.Test")) as PushButton;

            string pageGuid = "2ab776b4-b3fc-4810-8f44-ab5f1c9f5fa8";
            Guid guid = new Guid(pageGuid);
            DockablePaneId id = new DockablePaneId(guid);
            UserControl1 panel1 = new UserControl1();
            application.RegisterDockablePane(id,"DockPanelTest",panel1 as IDockablePaneProvider);

            return Result.Succeeded;
        }

核心方法是

public void RegisterDockablePane(
    DockablePaneId id,
    string title,
    IDockablePaneProvider provider
)

panel1 為之前寫好的UserControl1 的一個實例，UserControl1繼承了IDockablePaneProvider接口。 

4.最后是按鈕命令代碼

 [Transaction(TransactionMode.Manual)]
    [Regeneration(RegenerationOption.Manual)]
    [Journaling(JournalingMode.NoCommandData)]
    public class Test : IExternalCommand
    {
        
        public Result Execute(ExternalCommandData commandData, ref string message, ElementSet element)
        {
            string pageGuid = "2ab776b4-b3fc-4810-8f44-ab5f1c9f5fa8";
            Guid guid = new Guid(pageGuid);
            DockablePaneId id = new DockablePaneId(guid);

            DockablePane panel = commandData.Application.GetDockablePane(id);
            panel.Show();

            return Result.Succeeded;
        }
    }

5.生成成功后編寫addin文件再打開revit即可看到可停靠窗口。