Revit二次开发之可停靠窗口

环境：Revit2014+VS2010

关于Revit中可停靠窗口的开发，SDK sample中已经有了一个示例工程：DockableDialogs。不过这个工程做得比较复杂，学习起来比较费劲，所以在这里总结一下要点，并给出一个简单直观点的例子，方便上手。

首先，显示的可停靠窗口是一个UserControl，UserControl继承自Page类和IDockablePaneProvider接口。然后在UserControl中实现一个函数SetupDockablePane。

第二，要用RegisterDockablePane注册上一步实现的UserControl，并把这个UserControl跟一个GUID绑定。注意这一步要在Revit未打开文档的情况下操作。DockableDialogs工程示例中完成这一步是在Revit未打开文档的情况下用一个按钮来完成，不过这一步也可以在IExternalApplication的OnStartup函数中完成，对产品来说这样会更加人性化一点。

第三，通过上一步的GUID（要一样的），调用GetDockablePane，即可取得注册过的UserControl，然后调用它的Show来显示即可。

下面新建一个工程来演示。

首先，新建一个工程：DockablePaneTest，然后在工程中添加一个UserControl



在弹出的对话框中做如下操作



点击“添加”按钮，就添加了一个名为UserControl1的UserControl，并跳转到UserControl1的界面编辑。然后你可以在界面上布置任何控件。比如我们在上面放一个按钮：



不过最主要的，要把UserControl1的父类改为Page类。在XAML页面中，把UserControl改成Page,如图：





然后，打开UserControl1.xaml.cs文件，修改UserControl1类继承自Page类和Autodesk.Revit.UI.IDockablePaneProvider接口，如图：



接下来还要在UserControl1类中实现一个函数SetupDockablePane，如图：



到此，UserControl已经完成了。

接下来，我们打开工程中的Class.cs文件，首先往里面添加一个继承自IExternalApplication的类，UserControl的注册在这个类的OnStartup中完成，并且生成一个按钮，这样加载后Revit的界面上就有一按钮，只要点击这个按钮，上面做好的UserControl窗口就弹出来，并且是可停靠的。。。



下面是点击按钮后执行的命令代码：



到这里，代码已经完成。

运行这段代码，效果如下：



因为我们在SetupDockablePane函数中设置了DockPosition
= Autodesk.Revit.UI.DockPosition.Bottom，即把窗口放在底部，所以在上图中可以看到，窗口是停靠在底部的。如果你把窗口移到其他地方，把它关闭后再打开，窗口会出现在关闭前的地方，即使把Revit关了再打开，再次打开这个可停靠窗口，它依然会出现在它被关闭前所在的地方。
本文的示例工程下载地址：http://download.csdn.net/detail/peng08303/9246619