[实体对象] .NET版本的OPM（属性管理器）

萧闫子

下面是C#代码：

1. 
   
2. using Autodesk.AutoCAD.ApplicationServices;
   
3. using Autodesk.AutoCAD.Runtime;
   
4. using Autodesk.AutoCAD.Windows.OPM;
   
5. using System;
   
6. using System.Reflection;
   
7. using System.Runtime.InteropServices;
   
8. namespace OPMNetSample
   
9. {
   
10.   #region Our Custom Property
    
11.   [
    
12.     Guid("F60AE3DA-0373-4d24-82D2-B2646517ABCB"),
    
13.     ProgId("OPMNetSample.CustomProperty.1"),
    
14.     // 这个类不会产生类接口，
    
15.     // 没有接口被标识为缺省的。
    
16.     // 要求用户通过此对象显式暴露的接口来暴露功能
    
17.     // 这也就是说此对象只能暴露我们定义的接口
    
18.     ClassInterface(ClassInterfaceType.None),
    
19.     // 设置用来自动化的缺省COM接口。
    
20.     // 类似于C#、C++和VB之类的语言允许你
    
21.     //查询你所感兴趣的接口，但类似于javascript之类的只关心自动化的语言
    
22.     //不允许查询接口并且只会产生缺省的接口。
    
23.     ComDefaultInterface(typeof(IDynamicProperty2)),
    
24.     ComVisible(true)
    
25.   ]
    
26.   public class CustomProp : IDynamicProperty2
    
27.   {
    
28.     private IDynamicPropertyNotify2 m_pSink = null;
    
29.     // 唯一的属性ID
    
30.     public void GetGUID(out Guid propGUID)
    
31.     {
    
32.       propGUID =
    
33.         new Guid("F60AE3DA-0373-4d24-82D2-B2646517ABCB");
    
34.     }
    
35.     // 属性显示的名字
    
36.     public void GetDisplayName(out string szName)
    
37.     {
    
38.       szName = "My integer property";
    
39.     }
    
40.     // 显示/隐藏OPM中的属性
    
41.     public void IsPropertyEnabled(object pUnk, out int bEnabled)
    
42.     {
    
43.       bEnabled = 1;
    
44.     }
    
45.     // 属性是否显示为只读
    
46.     public void IsPropertyReadOnly(out int bReadonly)
    
47.     {
    
48.       bReadonly = 0;
    
49.     }
    
50.     // 获取属性描述字符串
    
51.     public void GetDescription(out string szName)
    
52.     {
    
53.       szName =
    
54.         "This property is an integer";
    
55.     }
    
56.     // OPM通常会把这些显示在一个可编辑框中
    
57.     // 可选：表示属性类型名称的元数据，如ACAD_ANGLE
    
58.     public void GetCurrentValueName(out string szName)
    
59.     {
    
60.       throw new System.NotImplementedException();
    
61.     }
    
62.     // 属性类型What is the property type, ex. VT_R8
    
63.     public void GetCurrentValueType(out ushort varType)
    
64.     {
    
65.       // 对于动态属性，属性管理器支持下列类型的数据：
    
66.       // VT_I2, VT_I4, VT_R4, VT_R8,VT_BSTR, VT_BOOL
    
67.       // 和 VT_USERDEFINED.
    
68.       varType = 3; // VT_I4
    
69.     }
    
70.     // 获取属性值，输入参数为需要指定属性的对象
    
71.     public void GetCurrentValueData(object pUnk, ref object pVarData)
    
72.     {
    
73.       // 获取值并返回给AutoCAD
    
74.       // 因为我们上面说过值的类型是32位整数(VT_I4)
    
75.       pVarData = (int)4;
    
76.     }
    
77.     // 设置属性值，输入参数为需要指定属性的对象
    
78.     public void SetCurrentValueData(object pUnk, ref object varData)
    
79.     {
    
80.       // 保存返回给你值
    
81.       //因为我们上面说过值的类型是32位整数(VT_I4)
    
82.       int myVal = (int)varData;
    
83.     }
    
84.     // OPM传递实现自定义属性的IDynamicPropertyNotify接口，
    
85.     // 你通知OPM你的属性值改变了
    
86.     public void Connect(object pSink)
    
87.     {
    
88.       m_pSink = (IDynamicPropertyNotify2)pSink;
    
89.     }
    
90.     public void Disconnect() {
    
91.       m_pSink = null;
    
92.     }
    
93.   }
    
94.   #endregion
    
95.   #region Application Entry Point
    
96.   public class MyEntryPoint : IExtensionApplication
    
97.   {
    
98.     protected internal CustomProp custProp = null;
    
99.     public void Initialize()
    
100.     {
     
101.       Assembly.LoadFrom("asdkOPMNetExt.dll");
     
102.       // 添加动态属性
     
103.       Dictionary classDict = SystemObjects.ClassDictionary;
     
104.       RXClass lineDesc = (RXClass)classDict.At("AcDbLine");
     
105.       IPropertyManager2 pPropMan =
     
106.         (IPropertyManager2)xOPM.xGET_OPMPROPERTY_MANAGER(lineDesc);
     
107.       custProp = new CustomProp();
     
108.       pPropMan.AddProperty((object)custProp);
     
109.     }
     
110.     public void Terminate()
     
111.     {
     
112.       // 移除动态属性
     
113.       Dictionary classDict = SystemObjects.ClassDictionary;
     
114.       RXClass lineDesc = (RXClass)classDict.At("AcDbLine");
     
115.       IPropertyManager2 pPropMan =
     
116.         (IPropertyManager2)xOPM.xGET_OPMPROPERTY_MANAGER(lineDesc);
     
117.       pPropMan.RemoveProperty((object)custProp);
     
118.       custProp = null;
     
119.     }
     
120.   }
     
121.   #endregion
     
122. }
     

复制代码

代码中需要说明的一些问题：
代码定义了一个自定义动态属性（CustomProp),因此我们需要一个唯一的GUID，然后实现了不同的回调函数来表示属性的名字、类型、描述和可写性，也定义了获取和设置属性值的函数。对应于本例，我们的属性叫做“My integer property”，那么猜猜看它表示什么？——它是一个整型值，值被硬编码为4。当然我们没有通过这个属性来存储数据，但在初建的应用程序中，你可能会让它存储扩展数据、扩展记录或外部数据库。
在接下来的代码中，我们定义了一些函数，用于在这个模块被装载和AutoCAD退出时被调用。我们使用了Initialize()回调函数来装载我们的C++混合编程的模块(asdkOPMNetExt.dll)，然后初始化我们的属性并把它附加到直线对象上去。
编译程序并装载DLL，请确保属性面板是可见的（使用PROPS命令或者双击直线对象），选择一条直线，你会看到下图所示的动态属性。