OpenCASCADE Application Framework Data Framework Services

一、概述Overview

OpenCASCADE的数据框架对来自不同程序的数据提供了统一的处理环境。这就简化了数据交换、修改，也保证了数据统一性、稳定性。实现方法需要用到以下部分：

u 标号Tha tag

u 标签The label

u 属性The attribute

Figure 1. Contents of a document

如上图所示，框架树的第一个标签（label）是根标签（root）。每个标签（label）有个以整数表示的标号（tag）。由当前标签的标号到根标签的标号，可以得到一个惟一的标号列表，如：0:1:2:1。

每个标签（label）可以一些属性（attribute），这些属性可以包含数据。每个属性由GUID来区分。标签最重要的性质是其入口只是数据框架的一个地址。

二、标号The Tag

一个标号Tag就是一个整数，它用两种方式标示了一个label：

u 相对标示法 Relative identification：一个标签的标号只与其父标签有关系。如对于一个指定的标签，可能由四个子标签组成，其标号分别为2，7，18，100。使用相对标示方法，在设置属性时有安全的范围。

u 绝对标示法 Absolute identification：一个标签在数据框架中位置由无歧义的、从根标签的标号到当前标签的标号用冒号表示的标号列表（list of tags）来表示。

不管采用哪种方法，都要注意的是这些标号的值没什么实际的意义。只是用来确定每个标签在树结构的位置，都是为了使用文档支持Undo/Redo的功能。

创建标号Tag的两种方式：

u Random delivery 随机创建；

u User-defined delivery 用户自定义创建；

正如字面所说，随机创建标号时，标号是由系统随机生成。用户自定义创建标号时，标号的值是创建标号函数的参数。

1．随机创建标号法生成子标签 Creating child labels using random delivery of tags

使用TDF_TagSource::NewChild来添加标签。如下代码所示，函数NewChild的参数level2也是一个TDF_Label。

2．用户自定义创建标号法生成子标签 Creation of a child label by user delivery from a tag

创建子标签的另一种方式就是用户自定义创建。即在指定标号创建标签。可以使用TDF_Label::FindChild和TDF_Label::Tag来获得指定标号的子标签。

如上代码所示，3是需要查找的标签的标号，Standard_False用来表示若查找不到指定标号时是否创建子标签。

三、标签The Label

标号（Tag）给了标签（Label）一个唯一的地址。数据框架中的标签是包含属性，绑定数据的容器。数据框架的本质是一个标签树，如下图所示：

数据框架中的标签不能被删除，因此，当文档打开后已经的数据框架结构不能被删除。

1．创建标签 Label creation

可以在任意层次创建标签，也可以找到标签在数据框架中的深度（Depth）。TDF_Label提供上述功能。

2．创建子标签 Creating child labels

在数据框架中指定标签上创建子标签使用TDF_Label::FindChild。如下所示：

当把FindChilde的第二个参数设为Standard_True时，就确保了查找不到指定标号的标签时会创建一个标签。如下所示：

3．访问子标签 Retrieving child labels

可以使用遍历器来访问当前标签的第一层的子标签。如下所示：

也可以访问当前标签的所有子标签，如下所示：

使用TDF_Tool::Entry可以得到当前标签的入口字符串，如下所示：

4．访问父标签

访问当前标签的父标签：

四、属性The Attribute

标签本身不包含任何数据。所有数据，不管什么类型，程序的非程序的数据都是保存在属性中。属性是绑定在标签上，且属性可以是任意类型的数据。OCAF提供许多直接可以使用的属性如：整数、实数、轴、平面。也有用于拓朴、功能、可视化的属性。每种类型的属性由GUID来标识。这样做的好处就是所有类型的属性都以相同的方式处理。可以创建新的实例，访问、绑定到标签和从标签上删除等。

1．访问标签的属性

使用函数TDF_Label::FindAttribute来访问标签的属性。如下例所示，

2．使用GUID来标识属性 Identifying an attribute using a GUID

可以创建一个属性对象并得到其GUID。如下例所示，创建了一个整数属性，通过方法ID来得到GUID。

3．将属性绑定到标签 Attaching an attribute to a label

使用函数TDF_Label::Add来将属性绑定到标签。重复绑定相同GUID的属性到一个标签会出现错误。TDF_Attribute::Label可以得到绑定属性的标签。如下所示：

4．测试标签绑定状态 Testing the attachment to a label

可以使用函数TDF_Attribute::IsA来检验属性是否已经绑定到标签上，函数的参数是属性的GUID。在下例所示，是检测当前标签是否有整数属性，然后得出这个标签属性的数量。函数TDF_Tool::HasAttribute用来检测标签是否绑定的有属性，函数TDF_Tool::NbAttributes返回标签绑定属性的数量。

5． 删除标签的属性 Removing an attribute from a label

若要将属性从标签中删除，可以使用TDF_Label::Forget，函数参数为属性的GUID。若要删除标签所有属性，使用函数TDF_Label::ForgetAll。

6．特定属性的创建 Specific attribute creation

见《Application Framework User's Guide》。

五、示例程序 Sample Code

  1: //------------------------------------------------------------------------------

  2: //	Copyright (c) 2012 eryar All Rights Reserved.

  3: //

  4: //		File    : Main.cpp

  5: //		Author  : eryar@163.com

  6: //		Date    : 2012-11-4 21:25

  7: //		Version : 0.1v

  8: //

  9: //	Description : OpenCASCADE Application Framework sample code.

 10: //

 11: //==============================================================================

12:

 13: #include <iostream>

 14: using namespace std;

15:

 16: #include <TDF_Tool.hxx>

 17: #include <TDF_ChildIterator.hxx>

 18: #include <TDataStd_Integer.hxx>

 19: #include <TDocStd_Document.hxx>

20:

 21: // Use Toolkit: TKLCAF

 22: #pragma comment(lib, "TKernel.lib")

 23: #pragma comment(lib, "TKLCAF.lib")

24:

 25: int main(int argc, char* argv[])

 26: {

 27:     TCollection_AsciiString entry;

28:

 29:     Handle_TDocStd_Document myDF    = new TDocStd_Document("myDocument");

30:

 31:     // Main label and root label of the data framework.

 32:     TDF_Label   mainLabel   = myDF->Main();

 33:     TDF_Label   root        = mainLabel.Root();

34:

 35:     cout<<"Main label :";

 36:     mainLabel.EntryDump(cout);

37:

 38:     cout<<endl<<"Root label :";

 39:     root.EntryDump(cout);

40:

 41:     // Create a label with tag 10 at Root.

 42:     TDF_Label   myLabel    = root.FindChild(10);

43:

 44:     cout<<endl<<"Entry of the new label :";

 45:     myLabel.EntryDump(cout);

46:

 47:     // Retrieving child labels.

 48:     cout<<endl<<"Retrieving child labels: "<<endl;

 49:     for (TDF_ChildIterator it(root); it.More(); it.Next())

 50:     {

 51:         it.Value().EntryDump(cout);

 52:         cout<<endl;

 53:     }

54:

 55:     // Attaching an attribute to a label.

 56:     Handle_TDataStd_Integer INT = new TDataStd_Integer;

 57:     myLabel.AddAttribute(INT);

58:

 59:     // Testing of attribute attachment.

 60:     if (myLabel.IsAttribute(INT->GetID()))

 61:     {

 62:         cout<<"The attribute is attached to the label."<<endl;

 63:     }

 64:     else

 65:     {

 66:         cout<<"The attribute is not attached to the label."<<endl;

 67:     }

68:

 69:     // Removing an attribute from a label.

 70:     myLabel.ForgetAttribute(INT->GetID());

71:

 72:     // Testing of attribute attachment.

 73:     if (myLabel.IsAttribute(INT->GetID()))

 74:     {

 75:         cout<<"The attribute is attached to the label."<<endl;

 76:     }

 77:     else

 78:     {

 79:         cout<<"The attribute is not attached to the label."<<endl;

 80:     }

81:

 82:     return 0;

 83: }

输出结果如下所示：

  1: Main label :0:1

  2: Root label :0:

  3: Entry of the new label :0:10

  4: Retrieving child labels:

  5: 0:1

  6: 0:10

  7: The attribute is attached to the label.

  8: The attribute is not attached to the label.

  9: Press any key to continue . . .

PDF Version: OpenCASCADE Application Framework Data Framework Services

eryar@163.com

2012-11-06