AutoCAD .net 二次开发官方教程及源码C#版(6.2)
为了使我们的用户界面和AutoCAD实现无缝链接,我们要尽可能在所有的地方使用同样的用户界面结构。这会使应用程序看起来与AutoCAD结合的很好,并有效地减少代码的重复。一个很好的例子是AutoCAD中的可停*面板。
使用.NET API,我们可以创建一个简单的窗体并把它放到面板中。我们可以实例化一个自定义的‘PaletteSet’对象来包含窗体,并可以把这个PaletteSet定义成我们喜欢的样式。
4) 在解决方案浏览器中通过右击工程来添加一个用户控件。给它命名为ModelessForm。使用控件工具箱,加入如下所示的编辑框和标签控件。
使用属性窗口设置三个编辑框的属性。设置如下:
<首先是最上面的编辑框>
(Name) = tb_Name
Text = <请输入一个名字>
<第二个编辑框>
(Name) = tb_Division
Text = Sales
<第三个编辑框>
(Name) = tb_Salary
Text = <请输入薪水>
要使用.NET API实例化一个面板对象,你必须要实例化用户控件对象(无模式窗体)和‘PaletteSet’对象。调用PaletteSet的成员函数Add来传递用户控件对象。
5) 接下来,我们要加入一个命令来创建面板。在类中加入一个名为CreatePalette的函数和CommandMethod属性来定义名为“PALETTE”的命令。
请看一下下面的代码块。这是实例化面板的代码。
ps = new Autodesk.AutoCAD.Windows.PaletteSet("Test Palette Set");
ps.MinimumSize = new System.Drawing.Size(300, 300);
System.Windows.Forms.UserControl myCtrl = new ModelessForm();
ps.Add("test", myCtrl);
ps.Visible = true;
6) 把上面的代码加入到CreatePalette()函数。‘ps’需要在函数的外部声明:
private Autodesk.AutoCAD.Windows.PaletteSet ps;
在函数的实例化面板代码之前加入检查ps是否为null的代码。
编译并运行工程。在AutoCAD中装载组件,运行‘PALETTE’命令来检查面板是否被装载。
使用PaletteSet.Style来看看PaletteSetStyles对象。例如:
ps.Style = PaletteSetStyles.ShowTabForSingle;
我们也可以试试诸如透明性的属性,例如:
ps.Opacity = 90;
注意:要使用PaletteSet 和PaletteSetStyles对象,你必须加入两个命名空间Autodesk.AutoCAD.Windows和Autodesk.AutoCAD.Windows.Palette
在我们继续之前,让我们执行一个快速的维护更新:请在AsdkClass1类中加入下列成员: public static string sDivisionDefault = "Sales";
public static string sDivisionManager = "Fiona Q. Farnsby";
这些值将被用作为部门和部门经理的缺省值。由于它们被声明为’static’,它们在每个程序中只实例化一次,并在组件装载的时候实例化。
第2a部分 在无模式窗体中加入拖放支持
在这部分,我们将加入允许我们使用面板窗体中编辑框的值来创建一个雇员。当用户从面板中拖动到AutoCAD中,将会提示输入职位,一个新的雇员实体将使用这些值来进行创建。
7) 为了支持拖放,我们首先需要一个对象来进行拖动。在编辑框的下面,另外加入一个名为Label4的标签控件,设置标签的文本为一些提示性的东西(‘Drag to Create Employee’)。通过这个标签,我们可以在AutoCAD中处理拖放。
要捕捉到什么时候拖动事件发生,我们必须要知道什么时候鼠标开始操作。
首先,我们要在类的构造函数中注册事件,代码如下:
Label4.MouseMove += new System.Windows.Forms.MouseEventHandler(Label4_MouseMove);
8) 在ModelessForm类中加入下面的函数声明:
private void Label4_MouseMove( object sender, System.Windows.Forms.MouseEventArgs e)
{
if (System.Windows.Forms.Control.MouseButtons == System.Windows.Forms.MouseButtons.Left)
{
// start dragDrop operation, MyDropTarget will be called when the cursor enters the AutoCAD view area.
Autodesk.AutoCAD.ApplicationServices.Application.DoDragDrop(this, this, System.Windows.Forms.DragDropEffects.All, new MyDropTarget());
}
}
通常事件处理器有2个输入参数,一个object类的sender和与事件有关的参数。对于MouseMove,我们也要做同样的事情。
运行这个工程,检查一下当鼠标经过文本的时候,函数是否被调用的。
我们还可以进一步知道是不是按了鼠标左键:
if (System.Windows.Forms.Control.MouseButtons == System.Windows.Forms.MouseButtons.Left)
{
}
我们需要一个方法来检测什么时候对象被拖入到AutoCAD。我们可以使用.NET的基类DropTarget来实现。要使用它,你只要创建从这个基类派生的类并实现你想要的函数。在我们这个例子中,我们需要的是OnDrop()。
9) 在工程中加入一个从Autodesk.AutoCAD.Windows.DropTarget派生的类‘MyDropTarget’。如果你把这个类加入到ModelessForm.cs文件中,请把这个类加入到ModelessForm类之后。 override public void OnDrop(System.Windows.Forms.DragEventArgs e)
{
}
在这个函数中,我们最后会调用AsdkClass1的成员CreateDivision() 和CreateEmployee,传入ModelessForm类中的编辑框的值。要实现这个功能,我们需要一个方法来连接ModelessForm实例。最佳的方法是通过DragEventArgs。但首先我们要把鼠标事件连接到MyDropTarget类。
10) 加入下面的代码到鼠标左键(MouseButtons.Left)处理函数中:
Autodesk.AutoCAD.ApplicationServices.Application.DoDragDrop(this, this, System.Windows.Forms.DragDropEffects.All, new MyDropTarget());
注意我们传入’this’两次。第一次是用于Control参数,第二次是用于传入用户自定义数据。因为我们传入的是ModelessForm 类的实例,所以我们可以在放下的时候使用它来获取编辑框的值。
11) 回到OnDrop处理函数,让我们使用参数来调用创建雇员的函数。首先,添加职位提示的代码。在AsdkClass1.Create()中已经有相关的代码了,位于‘Get Employees Coordinates…’.注释下面。添加此代码来提示输入职位。
12) 接下来,获取传入到DragEventArgs 参数的ModelessForm对象:
ModelessForm ctrl = (ModelessForm)e.Data.GetData(typeof(ModelessForm));
请注意一下怎样通过typeof关键字把参数强制转化为ModelessForm的实例。
13) 使用上面的实例来调用AsdkClass1成员:
AsdkClass1.CreateDivision(ctrl.tb_Division.Text, AsdkClass1.sDivisionManager);
AsdkClass1.CreateEmployee(ctrl.tb_Name.Text, ctrl.tb_Division.Text, Convert.ToDouble(ctrl.tb_Salary.Text), prPosRes.Value);
注意:AsdkClass1的方法要不通过AsdkClass1的实例来调用,那么方法必须被声明为’ public static’。因为public static 方法只能调用其它的public static 方法,你需要修改几个AsdkClass1类中的方法为’ public static’。请你进行相关的修改(应该至少有4项要修改)。
14) 最后,因为我们处理的事件位于AutoCAD命令之外,我们必须再次在会修改数据库的代码处锁住文档。请加入锁住文档的代码,加入的方法与前面的上下文菜单是一样的。
编译、装载并运行组件,使用PALETTE命令。你应该可以使用拖放操作来创建一个雇员了。