站场图显示模块详细设计.docVIP

PAGE PAGE 46 站场图显示模块 详细设计  TOC \o 1-3 \h \z \u 1. 引言 4 1.1. 编写目的及背景 4 1.2. 定义 4 2. 站场图模块的结构 4 2.1. 物理结构 5 2.1.1. Inc目录 6 2.1.2. Res 目录 7 2.1.3. Src 目录 7 2.2. 概述 8 3. 站场图模块设计说明 9 3.1. CZctView 站场图视图类 9 3.1.1. 概述 9 3.1.2. 主要数据成员描述 9 3.1.3. 主要函数描述 10 3.2. CStation 站场类 12 3.2.1. 概述 12 3.2.2. 主要数据成员描述 12 3.2.3. 主要函数描述 13 3.3. CStationSet 站集类 19 3.3.1. 概述 19 3.3.2. 主要数据成员描述 19 3.3.3. 主要函数描述 19 3.4. 数据类型 24 3.4.1. ObjectType 设备类型枚举 24 3.5. CZctLoader_Ini载入站场图类 25 3.5.1. CZctLoader类 25 3.5.2. 概述 25 3.5.3. 主要数据成员描述 25 3.5.4. 主要函数描述 25 3.6. CZctSaver保存站场图类 28 3.7. CZctElement站场元素类 28 3.7.1. 概述 28 3.7.2. 主要数据成员描述 28 3.7.3. 主要函数描述 30 3.8. 各种站场图元素类 39 3.8.1. 道岔表示类 39 3.8.2. 道岔类 39 3.8.3. 信号机类 40 3.8.4. 无岔区段或股道类 41 3.8.5. 按钮类 41 3.8.6. 表示灯类 42 3.8.7. 文本类 42 3.8.8. 绝缘节类 42 3.8.9. 箭头类 43 3.8.10. 车次窗类 43 3.8.11. 脱轨器类 43 3.8.12. 信号楼类 44 3.8.13. 站台类 44 3.8.14. 桥梁类 44 4. 使用说明 44 站场图显示模块详细设计 引言 编写目的及背景 在CTC项目中，有多个模块需要显示站场图，且各个模块对站场图的显示和操作有不同需求，旧站场图模块抽象的功能较为单一，功能已经越来越不能满足各个模块的需求，各个模块各自实现了自己所需功能，各模块所实现的功能重复性较多，在此前提下，急需把各个模块所需功能提取出来，扩充旧站场图模块，编写新的站场图模块，新模块提取了各个模块需求的共性，且最大限度地满足各个模块的使用需求，在原有站场图模块的基础上，使其结构更加合理，条理清晰，易于扩充。 定义 站场图模块：如未特别说明，指新站场图模块。 站场视图：用来显示站场图的视图，其程序实现为CZctView类。 CZctView：显示站场图的视图类。 CStation：站场类，包含一个站的所有站场元素。 CStationSet：站集类，包含有一个或多个站场类。 CZctElement：所有站场图元素的基类，表示一个站场元素。 单站：一个站场所有元素的集合，在程序中用CStation类表示。 站集：单站的集合，在程序中由CStationSet类表示。 ZctElementList：站场图元素列表，其为双向链表结构。 站场图模块的结构 站场图模块编写的总体原则为，把各个子功能，在物理和逻辑上都划分清晰，一个逻辑上的功能在物理上有一个实现文件与之对应，这样便于理解和以后的扩充，整个模块可以分为3部分，现分别描述如下： 一：各个站场图元素，如“道岔”，“信号机”，“按钮”等，这部分主要是对站场图各个元素的抽象，不同的站场图元素用不同类进行抽象实现。这部分主要放置在Src/ZctElements文件夹下，每一类元素对应一个文件。现在实现的站场图元素有14种：“按钮”，“箭头”，“表示灯”，“桥梁”，“道岔”，“道岔表示”，“绝缘节”，“信号机”，“信号楼”，“站台”，“脱轨器”，“车次窗”，“区段”和“文本”。 二：站场元素的管理，即站和站集。站包含一个站的元素列表，主要来管理这个站的元素，在程序中由CStation类实现。站集包含一个或多个站，可以管理多个站。在程序中由CStationSet来实现。 三：站场和站集的显示。程序中的CZctView类实现了站场和站集的显示，并支持多种对站场图的操作。 物理结构 模块的物理组织，即文件和文件夹的组织，