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

Revit二次开发之可停靠窗口_第1张图片

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

Revit二次开发之可停靠窗口_第2张图片

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

Revit二次开发之可停靠窗口_第3张图片

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

Revit二次开发之可停靠窗口_第4张图片

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

Revit二次开发之可停靠窗口_第5张图片

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

Revit二次开发之可停靠窗口_第6张图片

到此,UserControl已经完成了。


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

Revit二次开发之可停靠窗口_第7张图片

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

Revit二次开发之可停靠窗口_第8张图片

到这里,代码已经完成。


运行这段代码,效果如下:

Revit二次开发之可停靠窗口_第9张图片

因为我们在SetupDockablePane函数中设置了DockPosition = Autodesk.Revit.UI.DockPosition.Bottom,即把窗口放在底部,所以在上图中可以看到,窗口是停靠在底部的。如果你把窗口移到其他地方,把它关闭后再打开,窗口会出现在关闭前的地方,即使把Revit关了再打开,再次打开这个可停靠窗口,它依然会出现在它被关闭前所在的地方。

本文的示例工程下载地址:http://download.csdn.net/detail/peng08303/9246619

你可能感兴趣的:(Revit二次开发基础)