a
This commit is contained in:
coco
@@ -0,0 +1,230 @@
|
||||
# 实时数据监控
|
||||
|
||||
<cite>
|
||||
**本文档引用的文件**
|
||||
- [DialListRealTimeMeasuData.cpp](file://cpp/Views/DialListRealTimeMeasuData.cpp)
|
||||
- [DialListRealTimeMeasuData.h](file://h/DialListRealTimeMeasuData.h)
|
||||
- [DialListRealTimeMeasuGR.cpp](file://cpp/Views/DialListRealTimeMeasuGR.cpp)
|
||||
- [DialListRealTimeMeasuGR.h](file://h/DialListRealTimeMeasuGR.h)
|
||||
- [DialRealTimeMeasureData.cpp](file://cpp/Views/DialRealTimeMeasureData.cpp)
|
||||
- [DialRealTimeMeasureData.h](file://h/DialRealTimeMeasureData.h)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp)
|
||||
- [SComPort.cpp](file://cpp/Tools/SComPort.cpp)
|
||||
- [NetWorkOper.cpp](file://cpp/Tools/NetWorkOper.cpp)
|
||||
</cite>
|
||||
|
||||
## 目录
|
||||
1. [引言](#引言)
|
||||
2. [项目结构](#项目结构)
|
||||
3. [核心组件](#核心组件)
|
||||
4. [架构概述](#架构概述)
|
||||
5. [详细组件分析](#详细组件分析)
|
||||
6. [依赖关系分析](#依赖关系分析)
|
||||
7. [性能考虑](#性能考虑)
|
||||
8. [故障排除指南](#故障排除指南)
|
||||
9. [结论](#结论)
|
||||
|
||||
## 引言
|
||||
本文档深入探讨Geomative Studio软件中实时数据监控功能的实现机制。重点分析DialListRealTimeMeasuData和DialListRealTimeMeasuGR对话框如何实现测量数据的动态刷新与图形化展示，阐述DialRealTimeMeasureData对话框与设备通信模块（SComPort、NetWorkOper）的数据交互流程，包括数据帧解析、状态更新和异常处理。同时，文档将描述appdatatdlistview和appdatatdgrlistview组件在高频数据更新场景下的性能优化策略，并为用户提供操作指南，为开发者提供技术扩展路径。
|
||||
|
||||
## 项目结构
|
||||
实时数据监控功能主要分布在`cpp/Views`目录下的多个对话框实现文件中，这些文件与`cpp/Tools`目录下的通信模块紧密协作。核心的UI组件和数据处理逻辑被清晰地分离，形成了一个模块化的架构。
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
subgraph "UI 层"
|
||||
A[DialRealTimeMeasureData] --> B[DialListRealTimeMeasuData]
|
||||
A --> C[DialListRealTimeMeasuGR]
|
||||
end
|
||||
subgraph "通信层"
|
||||
D[NetWorkOper] --> E[SComPort]
|
||||
end
|
||||
subgraph "数据层"
|
||||
F[appdatatdlistview]
|
||||
G[appdatatdgrlistview]
|
||||
end
|
||||
A --> D
|
||||
B --> F
|
||||
C --> G
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [DialRealTimeMeasureData.cpp](file://cpp/Views/DialRealTimeMeasureData.cpp)
|
||||
- [DialListRealTimeMeasuData.cpp](file://cpp/Views/DialListRealTimeMeasuData.cpp)
|
||||
- [DialListRealTimeMeasuGR.cpp](file://cpp/Views/DialListRealTimeMeasuGR.cpp)
|
||||
- [NetWorkOper.cpp](file://cpp/Tools/NetWorkOper.cpp)
|
||||
- [SComPort.cpp](file://cpp/Tools/SComPort.cpp)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp)
|
||||
|
||||
**章节来源**
|
||||
- [cpp/Views](file://cpp/Views)
|
||||
- [cpp/Tools](file://cpp/Tools)
|
||||
|
||||
## 核心组件
|
||||
实时数据监控系统由多个核心组件构成，它们协同工作以实现数据的采集、处理和展示。DialRealTimeMeasureData作为主控对话框，负责协调数据流和用户交互；DialListRealTimeMeasuData和DialListRealTimeMeasuGR分别负责测量数据和接地电阻数据的列表展示；SComPort和NetWorkOper则构成了底层的通信基础设施。
|
||||
|
||||
**章节来源**
|
||||
- [DialRealTimeMeasureData.h](file://h/DialRealTimeMeasureData.h)
|
||||
- [DialListRealTimeMeasuData.h](file://h/DialListRealTimeMeasuData.h)
|
||||
- [DialListRealTimeMeasuGR.h](file://h/DialListRealTimeMeasuGR.h)
|
||||
- [SComPort.cpp](file://cpp/Tools/SComPort.cpp)
|
||||
- [NetWorkOper.cpp](file://cpp/Tools/NetWorkOper.cpp)
|
||||
|
||||
## 架构概述
|
||||
系统采用分层架构，将用户界面、业务逻辑和数据通信分离。主控对话框（DialRealTimeMeasureData）通过消息机制与子对话框（DialListRealTimeMeasuData/GR）进行通信，而通信模块（NetWorkOper）则通过异步线程处理网络和串口数据，确保UI的响应性。
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
A[用户界面] --> |用户操作| B[主控对话框]
|
||||
B --> |数据请求| C[通信模块]
|
||||
C --> |串口/网络| D[测量设备]
|
||||
D --> |实时数据| C
|
||||
C --> |数据包| B
|
||||
B --> |更新指令| E[数据展示组件]
|
||||
E --> |刷新UI| A
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [DialRealTimeMeasureData.cpp](file://cpp/Views/DialRealTimeMeasureData.cpp)
|
||||
- [NetWorkOper.cpp](file://cpp/Tools/NetWorkOper.cpp)
|
||||
- [SComPort.cpp](file://cpp/Tools/SComPort.cpp)
|
||||
|
||||
## 详细组件分析
|
||||
|
||||
### DialListRealTimeMeasuData 对话框分析
|
||||
该对话框负责实时测量数据的列表展示，支持动态数据刷新和多种更新模式。
|
||||
|
||||
#### 动态数据刷新机制
|
||||
DialListRealTimeMeasuData提供了三种数据更新方法，以适应不同的测量场景：
|
||||
- `OnShowTdData`: 用于初始化时的全量数据加载。
|
||||
- `OnShowTdDataAppend`: 用于在现有数据末尾追加新数据点。
|
||||
- `OnShowTdDataUpdate`: 用于单点测量或从当前位置开始测量时的增量更新。
|
||||
|
||||
```mermaid
|
||||
classDiagram
|
||||
class CDialListRealTimeMeasureData {
|
||||
+SetSptType(int)
|
||||
+SetTaskID(int)
|
||||
+SetMeasuStatus(const bool*)
|
||||
+ShowMeasuStatus(CString)
|
||||
+OnShowTdData(vector<STTaskDetailBasicData>)
|
||||
+OnShowTdDataAppend(vector<STTaskDetailBasicData>)
|
||||
+OnShowTdDataUpdate(vector<STTaskDetailBasicData>)
|
||||
-m_listData CListCtrl
|
||||
-m_iSptType int
|
||||
-m_strMeasuStatus CString
|
||||
-m_pMeasuStatus const bool*
|
||||
}
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [DialListRealTimeMeasuData.h](file://h/DialListRealTimeMeasuData.h)
|
||||
- [DialListRealTimeMeasuData.cpp](file://cpp/Views/DialListRealTimeMeasuData.cpp)
|
||||
|
||||
**章节来源**
|
||||
- [DialListRealTimeMeasuData.cpp](file://cpp/Views/DialListRealTimeMeasuData.cpp#L171-L343)
|
||||
|
||||
### DialRealTimeMeasureData 与通信模块交互分析
|
||||
该组件是实时数据监控的核心，负责与设备通信模块进行数据交互。
|
||||
|
||||
#### 数据交互序列图
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant UI as DialRealTimeMeasureData
|
||||
participant Net as NetWorkOper
|
||||
participant Dev as 测量设备
|
||||
participant SCom as SComPort
|
||||
UI->>Net : OnMeasureAll()
|
||||
Net->>SCom : SendCtrlMsgDirect()
|
||||
SCom->>Dev : 发送测量命令
|
||||
Dev-->>SCom : 返回实时数据
|
||||
SCom-->>Net : ReceiveDataDirectly()
|
||||
Net->>UI : WM_NET_RECV_REAL_TIME_DATA
|
||||
UI->>UI : 更新UI界面
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [DialRealTimeMeasureData.cpp](file://cpp/Views/DialRealTimeMeasureData.cpp)
|
||||
- [NetWorkOper.cpp](file://cpp/Tools/NetWorkOper.cpp)
|
||||
- [SComPort.cpp](file://cpp/Tools/SComPort.cpp)
|
||||
|
||||
**章节来源**
|
||||
- [DialRealTimeMeasureData.cpp](file://cpp/Views/DialRealTimeMeasureData.cpp#L485-L539)
|
||||
- [NetWorkOper.cpp](file://cpp/Tools/NetWorkOper.cpp#L185-L203)
|
||||
- [SComPort.cpp](file://cpp/Tools/SComPort.cpp#L527-L576)
|
||||
|
||||
### appdatatdlistview 高频数据更新优化分析
|
||||
该组件在处理高频数据更新时采用了多种性能优化策略。
|
||||
|
||||
#### 性能优化流程图
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start([开始数据更新]) --> CheckThread["检查是否在UI线程"]
|
||||
CheckThread --> |是| UseTimer["使用定时器延迟更新"]
|
||||
CheckThread --> |否| PostMessage["使用PostMessage跨线程通信"]
|
||||
UseTimer --> UpdateUI["批量更新UI"]
|
||||
PostMessage --> UpdateUI
|
||||
UpdateUI --> End([结束])
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp)
|
||||
|
||||
**章节来源**
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp#L72-L78)
|
||||
|
||||
## 依赖关系分析
|
||||
系统各组件之间存在明确的依赖关系，形成了一个稳定的调用链。
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
A[DialRealTimeMeasureData] --> B[DialListRealTimeMeasuData]
|
||||
A --> C[DialListRealTimeMeasuGR]
|
||||
A --> D[NetWorkOper]
|
||||
D --> E[SComPort]
|
||||
B --> F[appdatatdlistview]
|
||||
C --> G[appdatatdgrlistview]
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [DialRealTimeMeasureData.h](file://h/DialRealTimeMeasureData.h)
|
||||
- [DialListRealTimeMeasuData.h](file://h/DialListRealTimeMeasuData.h)
|
||||
- [DialListRealTimeMeasuGR.h](file://h/DialListRealTimeMeasuGR.h)
|
||||
|
||||
**章节来源**
|
||||
- [DialRealTimeMeasureData.cpp](file://cpp/Views/DialRealTimeMeasureData.cpp#L154-L169)
|
||||
|
||||
## 性能考虑
|
||||
在高频数据更新场景下，系统采用了多种性能优化策略来确保UI的流畅性。
|
||||
|
||||
### 性能优化策略表
|
||||
| 优化策略 | 实现方式 | 适用场景 |
|
||||
| :--- | :--- | :--- |
|
||||
| 双缓冲绘图 | 使用内存中的缓冲区进行绘制，完成后一次性刷新到屏幕 | 避免UI闪烁 |
|
||||
| 增量更新 | 只更新发生变化的数据项，而非全量刷新 | 减少UI重绘开销 |
|
||||
| UI线程分离 | 将数据接收和处理放在独立线程，通过消息机制更新UI | 保持UI响应性 |
|
||||
| 批量操作 | 将多个小的更新操作合并为一次大的更新 | 减少系统调用次数 |
|
||||
|
||||
**章节来源**
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp)
|
||||
|
||||
## 故障排除指南
|
||||
本节提供常见问题的解决方案和调试建议。
|
||||
|
||||
### 常见问题及解决方案
|
||||
| 问题现象 | 可能原因 | 解决方案 |
|
||||
| :--- | :--- | :--- |
|
||||
| 数据无法刷新 | 通信连接中断 | 检查设备连接状态，重新建立连接 |
|
||||
| UI卡顿 | 高频数据更新导致 | 检查是否启用了性能优化策略 |
|
||||
| 数据显示错误 | 数据帧解析异常 | 检查通信协议和数据格式 |
|
||||
| 按钮无响应 | 状态机异常 | 检查按钮状态逻辑和状态转换 |
|
||||
|
||||
**章节来源**
|
||||
- [DialRealTimeMeasureData.cpp](file://cpp/Views/DialRealTimeMeasureData.cpp#L484-L481)
|
||||
- [NetWorkOper.cpp](file://cpp/Tools/NetWorkOper.cpp#L157-L181)
|
||||
|
||||
## 结论
|
||||
Geomative Studio的实时数据监控功能通过精心设计的分层架构和高效的通信机制，实现了稳定可靠的数据采集和展示。系统通过DialListRealTimeMeasuData和DialListRealTimeMeasuGR对话框提供了直观的数据可视化界面，利用DialRealTimeMeasureData与SComPort、NetWorkOper等通信模块的紧密协作确保了数据的实时性。在性能方面，appdatatdlistview和appdatatdgrlistview组件通过双缓冲、增量更新和UI线程分离等策略，有效应对了高频数据更新的挑战。该系统为用户提供了完整的实时监控解决方案，同时也为开发者提供了清晰的扩展接口。
|
||||
@@ -0,0 +1,251 @@
|
||||
# 数据导出与导入
|
||||
|
||||
<cite>
|
||||
**本文档引用的文件**
|
||||
- [ioexpdlg.cpp](file://cpp/Views/ioexpdlg.cpp)
|
||||
- [ioexpdmsdlg.cpp](file://cpp/Views/ioexpdmsdlg.cpp)
|
||||
- [ioexpsptdlg.cpp](file://cpp/Views/ioexpsptdlg.cpp)
|
||||
- [IOManager.cpp](file://cpp/Managers/IOManager.cpp)
|
||||
- [DialMeasureData.cpp](file://cpp/Views/DialMeasureData.cpp)
|
||||
- [DownloadDataProgressDlg.cpp](file://cpp/Views/DownloadDataProgressDlg.cpp)
|
||||
- [OperTxtFile.cpp](file://cpp/Tools/OperTxtFile.cpp)
|
||||
- [OperUrfFile.cpp](file://cpp/Tools/OperUrfFile.cpp)
|
||||
- [excel.cpp](file://cpp/Tools/excel.cpp)
|
||||
- [ioexpdlg.h](file://h/ioexpdlg.h)
|
||||
- [ioexpdmsdlg.h](file://h/ioexpdmsdlg.h)
|
||||
- [ioexpsptdlg.h](file://h/ioexpsptdlg.h)
|
||||
</cite>
|
||||
|
||||
## 目录
|
||||
1. [引言](#引言)
|
||||
2. [数据导出功能架构](#数据导出功能架构)
|
||||
3. [导出对话框与用户交互](#导出对话框与用户交互)
|
||||
4. [IOManager协调机制](#iomanager协调机制)
|
||||
5. [文件操作工具实现](#文件操作工具实现)
|
||||
6. [导出流程与进度反馈](#导出流程与进度反馈)
|
||||
7. [用户操作指南](#用户操作指南)
|
||||
8. [开发者扩展指南](#开发者扩展指南)
|
||||
9. [结论](#结论)
|
||||
|
||||
## 引言
|
||||
|
||||
Geomative Studio软件提供了一套完整的数据导出与导入功能，旨在支持地质勘探数据在不同格式间的转换与共享。本系统化文档详细说明了`ioexpdlg`、`ioexpdmsdlg`和`ioexpsptdlg`三个核心对话框所支持的导出格式（包括Excel、CSV、TXT、URF）及其底层实现逻辑。文档深入解析了`IOManager`如何作为中央协调者，调用`OperTxtFile`、`OperUrfFile`和`excel`等专用文件操作工具来完成复杂的数据转换与文件生成任务。
|
||||
|
||||
此外，本文档阐述了从`DialMeasureData`对话框触发的完整导出流程，以及`DownloadDataProgressDlg`提供的实时进度反馈机制。为最终用户提供了关于如何选择导出范围、配置文件命名规则和验证导出完整性的详细操作说明。同时，为开发者提供了关于如何扩展支持新的导出格式（如JSON、PDF）、优化大数据量导出性能的缓冲策略，以及处理文件编码、跨平台换行符等兼容性问题的最佳实践。
|
||||
|
||||
**Section sources**
|
||||
- [ioexpdlg.cpp](file://cpp/Views/ioexpdlg.cpp#L1-L244)
|
||||
- [IOManager.cpp](file://cpp/Managers/IOManager.cpp#L1-L2064)
|
||||
|
||||
## 数据导出功能架构
|
||||
|
||||
Geomative Studio的数据导出功能采用分层架构设计，由用户界面层、业务逻辑层和数据访问层协同工作。核心组件`IOManager`位于业务逻辑层，负责协调整个导出流程。当用户通过`DialMeasureData`等界面组件发起导出请求时，控制权会传递给`IOManager`。
|
||||
|
||||
`IOManager`首先通过`CIOExpDlg`对话框收集用户的导出选项，包括选择要导出的项目、测区和测点数据。随后，它根据用户的选择，调用相应的数据提取和转换逻辑。对于数据库导出，`IOManager`使用ADOX库创建一个新的Access数据库文件（.accdb），并定义其表结构。然后，它将选定的数据从主数据库中提取出来，并插入到新创建的导出文件中。
|
||||
|
||||
对于其他格式（如TXT、URF、Excel），`IOManager`会实例化对应的文件操作工具类（如`OperTxtFile`、`OperUrfFile`、`excel`），并将数据流传递给它们进行格式化和写入。这种设计实现了关注点分离，使得`IOManager`可以专注于流程控制，而具体的文件格式实现则由专门的工具类负责。
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
A[用户界面] --> B[IOManager]
|
||||
B --> C[数据提取]
|
||||
C --> D[格式转换]
|
||||
D --> E[文件生成]
|
||||
E --> F[导出文件]
|
||||
B --> G[OperTxtFile]
|
||||
B --> H[OperUrfFile]
|
||||
B --> I[excel]
|
||||
G --> E
|
||||
H --> E
|
||||
I --> E
|
||||
```
|
||||
|
||||
**Diagram sources **
|
||||
- [IOManager.cpp](file://cpp/Managers/IOManager.cpp#L35-L98)
|
||||
- [OperTxtFile.cpp](file://cpp/Tools/OperTxtFile.cpp#L19-L35)
|
||||
- [OperUrfFile.cpp](file://cpp/Tools/OperUrfFile.cpp#L19-L29)
|
||||
- [excel.cpp](file://cpp/Tools/excel.cpp#L1-L800)
|
||||
|
||||
**Section sources**
|
||||
- [IOManager.cpp](file://cpp/Managers/IOManager.cpp#L35-L98)
|
||||
- [OperTxtFile.cpp](file://cpp/Tools/OperTxtFile.cpp#L19-L35)
|
||||
- [OperUrfFile.cpp](file://cpp/Tools/OperUrfFile.cpp#L19-L29)
|
||||
- [excel.cpp](file://cpp/Tools/excel.cpp#L1-L800)
|
||||
|
||||
## 导出对话框与用户交互
|
||||
|
||||
数据导出功能通过一系列对话框与用户进行交互，其中`CIOExpDlg`是主对话框，它整合了`CIOExpDmsDlg`和`CIOExpSptDlg`两个子对话框，分别用于选择数据（项目、测区、测点）和脚本。
|
||||
|
||||
### CIOExpDlg 主对话框
|
||||
|
||||
`CIOExpDlg`继承自`CDialog`，其主要职责是提供一个选项卡式界面，让用户在“数据”和“脚本”两个选项卡之间切换。当用户点击“确定”按钮时，该对话框会检查用户是否在任一选项卡中选择了要导出的项目。如果未选择任何项目，会弹出提示框要求用户选择。如果选择了项目，则会弹出文件保存对话框，让用户指定导出文件的路径和名称（默认为.accdb格式）。
|
||||
|
||||
```mermaid
|
||||
classDiagram
|
||||
class CIOExpDlg {
|
||||
+CString m_szFileName
|
||||
+CIOExpDmsDlg m_ioDmsDlg
|
||||
+CIOExpSptDlg m_ioSptDlg
|
||||
-INT_PTR* m_pRet
|
||||
+CIOExpDlg(CWnd* pParent)
|
||||
+CIOExpDlg(INT_PTR* pRet, CWnd* pParent)
|
||||
+virtual BOOL Create(UINT nID, CWnd* pParentWnd)
|
||||
+virtual void OnOK()
|
||||
+virtual void OnCancel()
|
||||
+virtual BOOL OnInitDialog()
|
||||
+afx_msg void OnSelchangeIoExpTab(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
}
|
||||
class CIOExpDmsDlg {
|
||||
+CTreeCtrl m_dmsTree
|
||||
+CIOExpDmsDlg(CWnd* pParent)
|
||||
+virtual BOOL OnInitDialog()
|
||||
+afx_msg void OnShowWindow(BOOL bShow, UINT nStatus)
|
||||
+afx_msg void OnClickTreeExpDms(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
+afx_msg void OnSelchangingTreeExpDms(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
}
|
||||
class CIOExpSptDlg {
|
||||
+CListCtrl m_sptList
|
||||
+CIOExpSptDlg(CWnd* pParent)
|
||||
+virtual BOOL OnInitDialog()
|
||||
+afx_msg void OnShowWindow(BOOL bShow, UINT nStatus)
|
||||
}
|
||||
CIOExpDlg --> CIOExpDmsDlg : "包含"
|
||||
CIOExpDlg --> CIOExpSptDlg : "包含"
|
||||
```
|
||||
|
||||
**Diagram sources **
|
||||
- [ioexpdlg.h](file://h/ioexpdlg.h#L16-L56)
|
||||
- [ioexpdmsdlg.h](file://h/ioexpdmsdlg.h#L13-L44)
|
||||
- [ioexpsptdlg.h](file://h/ioexpsptdlg.h#L13-L42)
|
||||
|
||||
### CIOExpDmsDlg 数据选择对话框
|
||||
|
||||
`CIOExpDmsDlg`使用一个`CTreeCtrl`（树形控件）来展示项目、测区和测点的层级结构。用户可以通过点击树节点旁的复选框来选择要导出的数据。该对话框在初始化时会设置树形控件的样式，使其显示连接线和按钮。`OnClickTreeExpDms`消息处理函数实现了智能的复选框逻辑：当用户选中一个父节点时，其所有子节点也会被自动选中；当用户取消选中一个父节点时，其所有子节点也会被取消选中。
|
||||
|
||||
### CIOExpSptDlg 脚本选择对话框
|
||||
|
||||
`CIOExpSptDlg`使用一个`CListCtrl`（列表控件）来展示所有可用的脚本。该控件被配置为支持全行选择、拖拽列头、网格线和复选框。在`OnInitDialog`函数中，它会动态地从资源文件中加载列标题（如“脚本编号”、“脚本名称”、“电极数量”等），并创建相应的列。
|
||||
|
||||
**Section sources**
|
||||
- [ioexpdlg.cpp](file://cpp/Views/ioexpdlg.cpp#L1-L244)
|
||||
- [ioexpdmsdlg.cpp](file://cpp/Views/ioexpdmsdlg.cpp#L1-L145)
|
||||
- [ioexpsptdlg.cpp](file://cpp/Views/ioexpsptdlg.cpp#L1-L115)
|
||||
- [ioexpdlg.h](file://h/ioexpdlg.h#L1-L62)
|
||||
- [ioexpdmsdlg.h](file://h/ioexpdmsdlg.h#L1-L50)
|
||||
- [ioexpsptdlg.h](file://h/ioexpsptdlg.h#L1-L48)
|
||||
|
||||
## IOManager协调机制
|
||||
|
||||
`IOManager`是整个数据导出功能的核心协调者。它通过`Export`方法启动导出流程。该方法首先创建并显示`CIOExpDlg`对话框，等待用户完成选择。一旦用户确认，`IOManager`会根据用户选择的文件路径，调用`CreateExpDatabase`方法创建一个新的Access数据库文件，并定义其表结构（如project、tz、td等）。
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant User as 用户
|
||||
participant CIOExpDlg as CIOExpDlg
|
||||
participant IOManager as IOManager
|
||||
participant Database as 数据库
|
||||
participant File as 文件系统
|
||||
User->>CIOExpDlg : 点击“导出”
|
||||
CIOExpDlg->>CIOExpDlg : 显示对话框
|
||||
User->>CIOExpDlg : 选择数据并点击“确定”
|
||||
CIOExpDlg->>IOManager : 返回文件路径
|
||||
IOManager->>IOManager : 创建导出数据库
|
||||
IOManager->>Database : 提取选定数据
|
||||
Database-->>IOManager : 返回数据
|
||||
IOManager->>File : 写入数据到.accdb文件
|
||||
File-->>IOManager : 写入完成
|
||||
IOManager-->>User : 显示成功消息
|
||||
```
|
||||
|
||||
**Diagram sources **
|
||||
- [IOManager.cpp](file://cpp/Managers/IOManager.cpp#L35-L98)
|
||||
- [IOManager.cpp](file://cpp/Managers/IOManager.cpp#L206-L656)
|
||||
|
||||
**Section sources**
|
||||
- [IOManager.cpp](file://cpp/Managers/IOManager.cpp#L35-L98)
|
||||
|
||||
## 文件操作工具实现
|
||||
|
||||
### OperTxtFile 文本文件操作
|
||||
|
||||
`OperTxtFile`类负责将数据导出为纯文本（TXT）格式。它提供了一个`SetParamWidth`方法来设置每个字段的宽度，确保导出的文本文件具有整齐的列对齐。`OpenFileforWrite`方法用于打开或创建一个文本文件。`WriteFileContent`方法接收一个`CStringArray`，将数组中的每个字符串按照设定的宽度填充空格后写入文件，不足宽度的部分用空格补齐，每个数组元素写入后会自动添加换行符。
|
||||
|
||||
### OperUrfFile URF文件操作
|
||||
|
||||
`OperUrfFile`类专门用于生成通用电阻率数据文件（URF）。它支持多种电极阵列类型，如温纳-施伦贝谢（Wenner-Schlumberger）、跨孔（Cross-Hole）等。`WriteElecByAR`方法是核心，它根据传入的阵列类型（iAR）参数，调用不同的私有方法（如`WriteElecByWenSch`、`WriteElecByCrossHole`）来生成符合特定阵列几何形状的电极坐标。URF文件的头部包含固定的注释和单位信息。
|
||||
|
||||
### Excel 文件操作
|
||||
|
||||
`excel.cpp`文件包含通过MFC的`COleDispatchDriver`包装类与Microsoft Excel应用程序进行交互的代码。这些包装类（如`_Application`、`_Workbook`、`_Worksheet`）允许程序以自动化的方式创建Excel工作簿、写入数据、设置单元格格式等。虽然具体的导出逻辑未在提供的代码片段中完全展示，但可以推断`IOManager`会使用这些类来将数据写入Excel的单元格中，并生成.xlsx或.xls文件。
|
||||
|
||||
**Section sources**
|
||||
- [OperTxtFile.cpp](file://cpp/Tools/OperTxtFile.cpp#L1-L166)
|
||||
- [OperUrfFile.cpp](file://cpp/Tools/OperUrfFile.cpp#L1-L800)
|
||||
- [excel.cpp](file://cpp/Tools/excel.cpp#L1-L800)
|
||||
|
||||
## 导出流程与进度反馈
|
||||
|
||||
### 从DialMeasureData触发导出
|
||||
|
||||
数据导出流程通常从`DialMeasureData`对话框开始，该对话框是用户进行测量操作的主要界面。当用户完成测量并希望导出数据时，可以通过菜单或按钮触发导出功能。`DialMeasureData`类本身不直接处理导出，而是通过调用`IOManager`的`Export`方法来启动整个流程。
|
||||
|
||||
### DownloadDataProgressDlg 进度反馈
|
||||
|
||||
在执行耗时较长的导出或导入操作时，系统会显示`DownloadDataProgressDlg`对话框来提供进度反馈。该对话框在初始化时会启动一个工作线程（`DownloadThread`或`UploadThread`），以避免阻塞主UI线程。工作线程会定期调用`ShowProcessPercent`方法，该方法根据已完成的工作量计算百分比，并更新对话框上的进度标签。这确保了用户界面的响应性，并让用户清楚地了解操作的进展情况。
|
||||
|
||||
**Section sources**
|
||||
- [DialMeasureData.cpp](file://cpp/Views/DialMeasureData.cpp#L1-L800)
|
||||
- [DownloadDataProgressDlg.cpp](file://cpp/Views/DownloadDataProgressDlg.cpp#L1-L479)
|
||||
|
||||
## 用户操作指南
|
||||
|
||||
### 选择导出范围
|
||||
|
||||
1. 在软件主界面，导航到需要导出数据的项目。
|
||||
2. 右键点击项目、测区或测点，选择“导出”选项。
|
||||
3. 在弹出的“数据导出”对话框中，切换到“数据”选项卡。
|
||||
4. 在树形结构中，勾选您想要导出的项目、测区和测点。勾选父节点会自动包含其所有子节点。
|
||||
5. 切换到“脚本”选项卡，勾选您想要导出的脚本。
|
||||
|
||||
### 配置文件命名规则
|
||||
|
||||
1. 完成选择后，点击“确定”。
|
||||
2. 系统会弹出“另存为”对话框。
|
||||
3. 在“文件名”输入框中，输入您希望的文件名。
|
||||
4. 系统默认的文件扩展名为`.accdb`，您也可以选择其他格式（如果功能支持）。
|
||||
5. 选择保存位置，然后点击“保存”。
|
||||
|
||||
### 验证导出完整性
|
||||
|
||||
1. 导出完成后，系统会显示“导出成功”的提示。
|
||||
2. 前往您指定的保存位置，找到导出的文件。
|
||||
3. 打开文件（例如，用Access打开.accdb文件，用文本编辑器打开.txt文件）。
|
||||
4. 检查文件内容是否与您在导出对话框中选择的数据范围一致，确保所有必要的数据都已包含在内。
|
||||
|
||||
## 开发者扩展指南
|
||||
|
||||
### 新增导出格式（如JSON、PDF）
|
||||
|
||||
要支持新的导出格式，开发者需要遵循以下步骤：
|
||||
1. **创建新的工具类**：创建一个名为`OperJsonFile`或`OperPdfFile`的新类，类似于`OperTxtFile`和`OperUrfFile`。
|
||||
2. **实现核心方法**：在新类中实现`OpenFile`、`WriteData`和`CloseFile`等核心方法。对于JSON，可以使用第三方库（如nlohmann/json）来构建和序列化JSON对象。对于PDF，可以使用库（如libHaru或PoDoFo）来创建PDF文档并写入表格数据。
|
||||
3. **扩展IOManager**：在`IOManager`类中添加新的导出方法（如`ExportToJSON`、`ExportToPDF`），并在`Export`方法中根据用户选择的格式调用相应的方法。
|
||||
4. **更新用户界面**：在“另存为”对话框的文件类型过滤器中添加新的格式选项（如`JSON Files (*.json)|*.json||`）。
|
||||
|
||||
### 优化大数据量导出性能
|
||||
|
||||
对于大数据量的导出，应采用缓冲和分块处理策略：
|
||||
1. **分批读取**：不要一次性将所有数据加载到内存中。使用数据库的分页查询（如`LIMIT`和`OFFSET`）或游标，分批读取数据。
|
||||
2. **缓冲写入**：在文件操作工具中，使用缓冲区（buffer）来累积一定量的数据后再写入磁盘，减少I/O操作次数。
|
||||
3. **异步处理**：将导出操作放在后台线程中执行，避免阻塞UI。`DownloadDataProgressDlg`的实现已经展示了如何使用`AfxBeginThread`来实现这一点。
|
||||
|
||||
### 处理兼容性问题
|
||||
|
||||
1. **文件编码**：对于文本文件（TXT、CSV），应明确指定编码格式（如UTF-8）。在`OperTxtFile`中，可以修改`fopen`调用，使用`"w+, ccs=UTF-8"`来确保文件以UTF-8编码保存，避免中文乱码。
|
||||
2. **跨平台换行符**：Windows使用`\r\n`，而Unix/Linux使用`\n`。在`OperTxtFile`的`WriteFileContent`方法中，可以根据目标平台动态选择换行符。可以通过编译宏（如`_WIN32`）来判断当前平台。
|
||||
|
||||
## 结论
|
||||
|
||||
Geomative Studio的数据导出与导入功能通过清晰的分层架构和模块化设计，实现了高效、可靠的数据交换。`IOManager`作为核心协调者，有效地整合了用户界面、数据访问和文件生成等多个组件。通过分析`ioexpdlg`系列对话框和`OperTxtFile`、`OperUrfFile`等工具类，我们理解了系统如何支持多种导出格式并提供良好的用户体验。
|
||||
|
||||
本文档不仅为用户提供了清晰的操作指南，也为开发者指明了扩展和优化的方向。通过遵循本文档中的最佳实践，可以确保新功能的顺利集成，并持续提升软件在处理复杂地质数据方面的专业性和可靠性。
|
||||
@@ -0,0 +1,250 @@
|
||||
# 数据管理界面
|
||||
|
||||
<cite>
|
||||
**本文档引用的文件**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp)
|
||||
- [datamngframe.h](file://h/datamngframe.h)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp)
|
||||
- [appdatatdlistview.h](file://h/appdatatdlistview.h)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp)
|
||||
- [appdatatdgrlistview.h](file://h/appdatatdgrlistview.h)
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp)
|
||||
- [DataOperator.h](file://h/DataOperator.h)
|
||||
- [navdataview.cpp](file://cpp/Views/navdataview.cpp)
|
||||
- [navdataview.h](file://h/navdataview.h)
|
||||
- [excel.cpp](file://cpp/Tools/excel.cpp)
|
||||
- [excel.h](file://h/excel.h)
|
||||
</cite>
|
||||
|
||||
## 目录
|
||||
1. [引言](#引言)
|
||||
2. [项目结构](#项目结构)
|
||||
3. [核心组件](#核心组件)
|
||||
4. [架构概述](#架构概述)
|
||||
5. [详细组件分析](#详细组件分析)
|
||||
6. [依赖分析](#依赖分析)
|
||||
7. [性能考虑](#性能考虑)
|
||||
8. [故障排除指南](#故障排除指南)
|
||||
9. [结论](#结论)
|
||||
|
||||
## 引言
|
||||
数据管理界面是Geomative Studio软件的核心功能模块，负责测量数据的浏览、实时监控、数据导出与导入等关键任务。该界面通过`datamngframe`框架集成多种数据视图，如`appdatatdlistview`和`appdatatdgrlistview`，实现数据列表、图形化展示与详细信息面板的联动。用户可以通过该界面执行数据查询、筛选、导出（支持Excel、CSV、TXT、URF格式）和诊断报告生成等操作。开发者可以扩展数据导出格式、集成新的数据可视化组件或优化大数据量下的界面响应性能。
|
||||
|
||||
## 项目结构
|
||||
数据管理界面的代码主要分布在`cpp/Views`和`h`目录下，核心文件包括`datamngframe.cpp`、`appdatatdlistview.cpp`、`appdatatdgrlistview.cpp`和`DataOperator.cpp`。这些文件共同构成了数据管理的框架和视图组件。
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
subgraph "数据管理界面"
|
||||
datamngframe[datamngframe.cpp]
|
||||
appdatatdlistview[appdatatdlistview.cpp]
|
||||
appdatatdgrlistview[appdatatdgrlistview.cpp]
|
||||
DataOperator[DataOperator.cpp]
|
||||
navdataview[navdataview.cpp]
|
||||
end
|
||||
datamngframe --> DataOperator
|
||||
appdatatdlistview --> DataOperator
|
||||
appdatatdgrlistview --> DataOperator
|
||||
navdataview --> DataOperator
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp)
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp)
|
||||
- [navdataview.cpp](file://cpp/Views/navdataview.cpp)
|
||||
|
||||
**Section sources**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp)
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp)
|
||||
- [navdataview.cpp](file://cpp/Views/navdataview.cpp)
|
||||
|
||||
## 核心组件
|
||||
数据管理界面的核心组件包括`CDataMngFrame`、`CAppDataTdListView`、`CAppDataTdGrListView`和`CDataOperator`。`CDataMngFrame`作为主框架，管理界面的布局和视图切换。`CAppDataTdListView`和`CAppDataTdGrListView`分别负责数据列表和图形化数据的展示。`CDataOperator`作为数据操作器，处理数据的加载、导出和删除等操作。
|
||||
|
||||
**Section sources**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp)
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp)
|
||||
|
||||
## 架构概述
|
||||
数据管理界面采用MVC（Model-View-Controller）架构，`CDataOperator`作为模型层，负责数据的存取和业务逻辑。`CDataMngFrame`作为控制器，管理视图的创建和切换。`CAppDataTdListView`和`CAppDataTdGrListView`作为视图层，负责数据的展示。
|
||||
|
||||
```mermaid
|
||||
classDiagram
|
||||
class CDataMngFrame {
|
||||
+CView* m_pAppDataView
|
||||
+CView* m_pNavDataView
|
||||
+bool ShowAppView(DWORD dwHandle, UINT uState)
|
||||
+bool ShowContentListByPageView(DWORD dwHandle, UINT uState, UINT uPage)
|
||||
}
|
||||
class CDataOperator {
|
||||
+_ConnectionPtr m_pConnection
|
||||
+CStateProcessor m_stateProcessor
|
||||
+CHandleProcessor m_handleProcessor
|
||||
+bool InitialNavDataView(CNavDataView* pNavDataView)
|
||||
+void ShowRsp2DTdInfo(DWORD dwTdHandle, CView* pAppDataView)
|
||||
+void ShowRspCETdInfo(DWORD dwTdHandle, CView* pAppDataView)
|
||||
+UINT ExportRsp2DTdToExcel(CNavDataView* pNavDataView, CString f_szFileName)
|
||||
}
|
||||
class CAppDataTdListView {
|
||||
+CMDIChildWnd* m_pMngFrm
|
||||
+void OnColumnclick(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
+void OnDblclk(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
+void OnBatchexport()
|
||||
+void OnBatchDelData()
|
||||
}
|
||||
class CAppDataTdGrListView {
|
||||
+CMDIChildWnd* m_pMngFrm
|
||||
+void OnColumnclick(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
+void OnCustomDrawList(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
}
|
||||
class CNavDataView {
|
||||
+CTreeCtrl m_dataTree
|
||||
+void Schedule()
|
||||
+void LoadByPageShedule()
|
||||
+void OnRclickNavDataTree(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
+void OnSelchangedNavDataTree(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
}
|
||||
CDataMngFrame --> CDataOperator : "uses"
|
||||
CDataMngFrame --> CAppDataTdListView : "creates"
|
||||
CDataMngFrame --> CAppDataTdGrListView : "creates"
|
||||
CDataOperator --> CNavDataView : "manages"
|
||||
CAppDataTdListView --> CDataOperator : "delegates"
|
||||
CAppDataTdGrListView --> CDataOperator : "delegates"
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp)
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp)
|
||||
- [navdataview.cpp](file://cpp/Views/navdataview.cpp)
|
||||
|
||||
## 详细组件分析
|
||||
|
||||
### 数据管理框架分析
|
||||
`CDataMngFrame`是数据管理界面的主框架，继承自`CMDIChildWnd`，负责管理界面的布局和视图切换。它通过`CSplitterWnd`将界面分为导航视图和应用视图两部分。
|
||||
|
||||
#### 数据管理框架类图
|
||||
```mermaid
|
||||
classDiagram
|
||||
class CDataMngFrame {
|
||||
+CView* m_pAppDataView
|
||||
+CView* m_pNavDataView
|
||||
+CSplitterWnd m_splitter
|
||||
+CDataOperator* m_pDataOperator
|
||||
+bool ShowAppView(DWORD dwHandle, UINT uState)
|
||||
+bool ShowContentListByPageView(DWORD dwHandle, UINT uState, UINT uPage)
|
||||
}
|
||||
CDataMngFrame --> CDataOperator : "owns"
|
||||
CDataMngFrame --> CView : "contains"
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp)
|
||||
- [datamngframe.h](file://h/datamngframe.h)
|
||||
|
||||
### 数据列表视图分析
|
||||
`CAppDataTdListView`负责展示测量数据的列表，支持列排序、双击跳转和批量导出/删除操作。
|
||||
|
||||
#### 数据列表视图类图
|
||||
```mermaid
|
||||
classDiagram
|
||||
class CAppDataTdListView {
|
||||
+CMDIChildWnd* m_pMngFrm
|
||||
+void OnColumnclick(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
+void OnDblclk(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
+void OnBatchexport()
|
||||
+void OnBatchDelData()
|
||||
}
|
||||
CAppDataTdListView --> CDataMngFrame : "belongs to"
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp)
|
||||
- [appdatatdlistview.h](file://h/appdatatdlistview.h)
|
||||
|
||||
### 图形化数据视图分析
|
||||
`CAppDataTdGrListView`负责展示电极的图形化数据，支持自定义绘制，根据电极状态显示不同颜色。
|
||||
|
||||
#### 图形化数据视图类图
|
||||
```mermaid
|
||||
classDiagram
|
||||
class CAppDataTdGrListView {
|
||||
+CMDIChildWnd* m_pMngFrm
|
||||
+void OnColumnclick(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
+void OnCustomDrawList(NMHDR* pNMHDR, LRESULT* pResult)
|
||||
}
|
||||
CAppDataTdGrListView --> CDataMngFrame : "belongs to"
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp)
|
||||
- [appdatatdgrlistview.h](file://h/appdatatdgrlistview.h)
|
||||
|
||||
### 数据操作器分析
|
||||
`CDataOperator`是数据管理的核心，负责与数据库交互，加载和导出数据。
|
||||
|
||||
#### 数据操作器类图
|
||||
```mermaid
|
||||
classDiagram
|
||||
class CDataOperator {
|
||||
+_ConnectionPtr m_pConnection
|
||||
+CStateProcessor m_stateProcessor
|
||||
+CHandleProcessor m_handleProcessor
|
||||
+bool InitialNavDataView(CNavDataView* pNavDataView)
|
||||
+void ShowRsp2DTdInfo(DWORD dwTdHandle, CView* pAppDataView)
|
||||
+void ShowRspCETdInfo(DWORD dwTdHandle, CView* pAppDataView)
|
||||
+UINT ExportRsp2DTdToExcel(CNavDataView* pNavDataView, CString f_szFileName)
|
||||
}
|
||||
CDataOperator --> _ConnectionPtr : "uses"
|
||||
CDataOperator --> CStateProcessor : "uses"
|
||||
CDataOperator --> CHandleProcessor : "uses"
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp)
|
||||
- [DataOperator.h](file://h/DataOperator.h)
|
||||
|
||||
**Section sources**
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp)
|
||||
- [DataOperator.h](file://h/DataOperator.h)
|
||||
|
||||
## 依赖分析
|
||||
数据管理界面依赖于`CDataOperator`进行数据操作，`CDataOperator`又依赖于数据库连接和状态处理器。
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
CDataMngFrame --> CDataOperator
|
||||
CDataOperator --> _ConnectionPtr
|
||||
CDataOperator --> CStateProcessor
|
||||
CDataOperator --> CHandleProcessor
|
||||
CAppDataTdListView --> CDataOperator
|
||||
CAppDataTdGrListView --> CDataOperator
|
||||
```
|
||||
|
||||
**Diagram sources**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp)
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp)
|
||||
|
||||
## 性能考虑
|
||||
在处理大数据量时，应优化数据加载和渲染性能。建议使用分页加载和虚拟列表技术，避免一次性加载所有数据。
|
||||
|
||||
## 故障排除指南
|
||||
- **数据无法加载**：检查数据库连接是否正常，确认`CDataOperator`的`m_pConnection`是否有效。
|
||||
- **导出失败**：检查文件路径和权限，确保Excel组件正确安装。
|
||||
- **界面卡顿**：减少一次性加载的数据量，使用分页或虚拟列表。
|
||||
|
||||
**Section sources**
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp)
|
||||
- [excel.cpp](file://cpp/Tools/excel.cpp)
|
||||
|
||||
## 结论
|
||||
数据管理界面通过`datamngframe`框架和`DataOperator`组件，实现了测量数据的高效管理和可视化。开发者可以通过扩展`CDataOperator`来支持新的数据格式和导出功能，优化大数据量下的性能表现。
|
||||
@@ -0,0 +1,225 @@
|
||||
# 测量数据浏览
|
||||
|
||||
<cite>
|
||||
**本文档引用的文件**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp)
|
||||
- [appdatatddetaillistview.cpp](file://cpp/Views/appdatatddetaillistview.cpp)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp)
|
||||
- [DialListMeasuData.cpp](file://cpp/Views/DialListMeasuData.cpp)
|
||||
- [DialListMeasuGR.cpp](file://cpp/Views/DialListMeasuGR.cpp)
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp)
|
||||
- [Ipsp2DTd.cpp](file://cpp/ProblemZone/Ipsp2DTd.cpp)
|
||||
- [Ipsp2DTdRecord.cpp](file://cpp/ProblemZone/Ipsp2DTdRecord.cpp)
|
||||
- [HandleProcessor.cpp](file://cpp/Tools/HandleProcessor.cpp)
|
||||
</cite>
|
||||
|
||||
## 目录
|
||||
1. [引言](#引言)
|
||||
2. [项目结构](#项目结构)
|
||||
3. [核心组件](#核心组件)
|
||||
4. [架构概述](#架构概述)
|
||||
5. [详细组件分析](#详细组件分析)
|
||||
6. [依赖关系分析](#依赖关系分析)
|
||||
7. [性能考虑](#性能考虑)
|
||||
8. [故障排除指南](#故障排除指南)
|
||||
9. [结论](#结论)
|
||||
|
||||
## 引言
|
||||
本文档详细阐述了GeomativeStudio软件中测量数据浏览功能的实现机制。重点分析了数据管理框架（datamngframe）如何集成测试数据列表视图（appdatatdlistview）、详细信息面板（appdatatddetaillistview）和图形化展示组件（appdatatdgrlistview）的联动机制。文档描述了用户通过DialListMeasuData和DialListMeasuGR对话框进行数据查询、筛选和可视化操作的完整流程，并为开发者提供了扩展数据展示字段、自定义排序规则或集成新型图表组件的技术指导。
|
||||
|
||||
## 项目结构
|
||||
GeomativeStudio项目是一个复杂的地质测量软件系统，其核心功能围绕数据采集、管理和可视化展开。测量数据浏览功能主要位于`cpp/Views`目录下，由一系列视图类和对话框类构成。数据管理框架`CDataMngFrame`作为主容器，负责协调各个子视图的显示和数据交互。
|
||||
|
||||
```mermaid
|
||||
graph TD
|
||||
subgraph "数据管理框架"
|
||||
DMF[CDataMngFrame]
|
||||
end
|
||||
subgraph "视图组件"
|
||||
TLV[CAppDataTdListView]
|
||||
DLV[CAppDataTdDetailListView]
|
||||
GLV[CAppDataTdGrListView]
|
||||
end
|
||||
subgraph "对话框"
|
||||
DLM[CDialogListMeasuData]
|
||||
DGR[CDialogListMeasuGR]
|
||||
end
|
||||
DMF --> TLV
|
||||
DMF --> DLV
|
||||
DMF --> GLV
|
||||
DLM --> TLV
|
||||
DGR --> GLV
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp#L49-L81)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp#L22-L33)
|
||||
- [appdatatddetaillistview.cpp](file://cpp/Views/appdatatddetaillistview.cpp#L17-L34)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp#L21-L38)
|
||||
- [DialListMeasuData.cpp](file://cpp/Views/DialListMeasuData.cpp#L18-L39)
|
||||
- [DialListMeasuGR.cpp](file://cpp/Views/DialListMeasuGR.cpp#L17-L41)
|
||||
|
||||
**章节来源**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp#L1-L81)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp#L1-L485)
|
||||
- [appdatatddetaillistview.cpp](file://cpp/Views/appdatatddetaillistview.cpp#L1-L318)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp#L1-L189)
|
||||
|
||||
## 核心组件
|
||||
测量数据浏览功能的核心在于`CDataMngFrame`类，它作为MDI子窗口，通过分割窗口（CSplitterWnd）将界面划分为导航视图（CNavDataView）和应用数据视图（CAppDataView）。应用数据视图会根据用户选择的数据类型动态切换为不同的具体视图，如`CAppDataRsp2DTdView`、`CAppDataIpsp2DTdView`等。
|
||||
|
||||
`CAppDataTdListView`负责以列表形式展示测量数据，支持列点击排序和双击跳转。`CAppDataTdDetailListView`则以键值对的形式展示所选数据的详细信息。`CAppDataTdGrListView`用于展示电极的电阻测量结果，通过自定义绘制实现不同状态（如短路、开路）的文本颜色高亮。
|
||||
|
||||
**章节来源**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp#L179-L602)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp#L72-L271)
|
||||
- [appdatatddetaillistview.cpp](file://cpp/Views/appdatatddetaillistview.cpp#L63-L267)
|
||||
- [appdatatdgrlistview.cpp](file://cpp/Views/appdatatdgrlistview.cpp#L67-L134)
|
||||
|
||||
## 架构概述
|
||||
整个测量数据浏览功能的架构基于MFC的文档/视图（Document/View）架构和消息映射机制。`CDataMngFrame`通过处理自定义Windows消息（如WM_SCHEDULE、WM_REFRESH）来响应用户操作和数据状态变化。
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant User as 用户
|
||||
participant Frame as CDataMngFrame
|
||||
participant Operator as CDataOperator
|
||||
participant Data as CTestingData
|
||||
participant View as CAppDataTdListView
|
||||
User->>Frame : 选择数据项
|
||||
Frame->>Frame : OnSchedule(WM_SCHEDULE)
|
||||
Frame->>Operator : ShowAppView()
|
||||
Operator->>Data : ShowConList()
|
||||
Data->>View : 填充列表数据
|
||||
View-->>User : 显示数据列表
|
||||
User->>View : 双击列表项
|
||||
View->>Frame : OnDblclk()
|
||||
Frame->>Frame : OnSkip()
|
||||
Frame->>Frame : 跳转到对应数据
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp#L87-L96)
|
||||
- [appdatatdlistview.cpp](file://cpp/Views/appdatatdlistview.cpp#L284-L301)
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp#L539-L579)
|
||||
- [Ipsp2DTd.cpp](file://cpp/ProblemZone/Ipsp2DTd.cpp#L48-L75)
|
||||
|
||||
## 详细组件分析
|
||||
|
||||
### 数据管理框架分析
|
||||
`CDataMngFrame`是整个功能的核心控制器。它在`OnCreateClient`中创建分割窗口，并在`OnSchedule`消息处理函数中根据传入的句柄（handle）动态创建或切换右侧的应用视图。
|
||||
|
||||
```mermaid
|
||||
classDiagram
|
||||
class CDataMngFrame {
|
||||
+CView* m_pAppDataView
|
||||
+CView* m_pNavDataView
|
||||
+CDataOperator* m_pDataOperator
|
||||
+OnCreateClient()
|
||||
+OnSchedule()
|
||||
+ShowAppView()
|
||||
+ShowContentListByPageView()
|
||||
}
|
||||
class CDataOperator {
|
||||
+ShowRsp2DTdInfo()
|
||||
+ShowIps2DpTdInfo()
|
||||
+LoadRsp2dRecordbyPage()
|
||||
+LoadIpsp2dRecordbyPage()
|
||||
}
|
||||
class CTestingData {
|
||||
+ShowDetailInfo()
|
||||
+ShowConList()
|
||||
+ShowConListByPage()
|
||||
}
|
||||
CDataMngFrame --> CDataOperator : "使用"
|
||||
CDataOperator --> CTestingData : "调用"
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp#L51-L81)
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp#L539-L579)
|
||||
- [Ipsp2DTd.cpp](file://cpp/ProblemZone/Ipsp2DTd.cpp#L48-L75)
|
||||
|
||||
### 对话框组件分析
|
||||
`CDialListMeasuData`和`CDialListMeasuGR`是两个独立的对话框，用于实时显示测量过程中的数据。它们不直接与`CDataMngFrame`集成，而是通过自己的数据操作对象（如`m_taskOper`）直接从数据库或设备获取数据。
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start([对话框初始化]) --> OnInitDialog["OnInitDialog()"]
|
||||
OnInitDialog --> InsertColumns["插入列表列"]
|
||||
InsertColumns --> QueryData["查询测量数据"]
|
||||
QueryData --> vtData{"数据为空?"}
|
||||
vtData --> |否| OnShowTdData["OnShowTdData()"]
|
||||
vtData --> |是| End([结束])
|
||||
OnShowTdData --> DeleteAll["清空列表"]
|
||||
DeleteAll --> Loop["遍历数据"]
|
||||
Loop --> FormatText["格式化文本"]
|
||||
FormatText --> SetItemText["设置列表项"]
|
||||
SetItemText --> NextItem["下一项"]
|
||||
NextItem --> Loop
|
||||
Loop --> End
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [DialListMeasuData.cpp](file://cpp/Views/DialListMeasuData.cpp#L52-L332)
|
||||
- [DialListMeasuGR.cpp](file://cpp/Views/DialListMeasuGR.cpp#L46-L112)
|
||||
|
||||
### 复杂逻辑组件分析
|
||||
数据句柄（Handle）的解析是系统中的一个关键逻辑。`CHandleProcessor`类负责将一个32位的DWORD句柄拆解为ID和样式（Style）两部分，用于标识不同的数据对象。
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A["dwHandle = 0xF8000001"] --> B["dwTempID = dwHandle & 0x7FFFFFF"]
|
||||
B --> C["dwID = 1"]
|
||||
A --> D["dwTempStyle = dwHandle & 0xF8000000"]
|
||||
D --> E["dwTempStyle >>= 27"]
|
||||
E --> F["uStyle = 31"]
|
||||
C --> G["获取数据ID"]
|
||||
F --> H["获取数据类型"]
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [HandleProcessor.cpp](file://cpp/Tools/HandleProcessor.cpp#L59-L95)
|
||||
|
||||
**章节来源**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp#L250-L312)
|
||||
- [HandleProcessor.cpp](file://cpp/Tools/HandleProcessor.cpp#L52-L95)
|
||||
|
||||
## 依赖关系分析
|
||||
测量数据浏览功能依赖于多个核心模块。`CDataMngFrame`依赖于`CDataOperator`进行数据操作，`CDataOperator`又依赖于具体的`CTestingData`派生类（如`CIpsp2DTd`）来获取数据。数据持久化则通过ADODB组件与数据库进行交互。
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
DMF[CDataMngFrame] --> DO[CDataOperator]
|
||||
DO --> TD[CTestingData]
|
||||
TD --> DB[(数据库)]
|
||||
DO --> HP[CHandleProcessor]
|
||||
DO --> SP[CStateProcessor]
|
||||
TD --> RSP[CIpsp2DTdRecord]
|
||||
RSP --> DB
|
||||
```
|
||||
|
||||
**图表来源**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp#L59-L61)
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp#L539-L579)
|
||||
- [Ipsp2DTd.cpp](file://cpp/ProblemZone/Ipsp2DTd.cpp#L37-L46)
|
||||
- [Ipsp2DTdRecord.cpp](file://cpp/ProblemZone/Ipsp2DTdRecord.cpp#L56-L87)
|
||||
|
||||
## 性能考虑
|
||||
对于大规模数据集，当前实现可能存在性能瓶颈。建议采用虚拟列表控件（Virtual List Control）来优化`CAppDataTdListView`的性能。虚拟列表控件只在需要时才请求显示数据，而不是一次性加载所有数据到内存中。
|
||||
|
||||
异步加载策略也是优化的关键。可以在后台线程中执行数据库查询，避免阻塞UI线程。当查询完成时，再通过`PostMessage`将结果发送回UI线程进行更新，确保界面的响应性。
|
||||
|
||||
## 故障排除指南
|
||||
如果测量数据无法正确显示，首先检查`CDataMngFrame`的`OnSchedule`消息是否被正确触发。确认传入的句柄（handle）是否有效，并通过`CHandleProcessor`验证其ID和样式是否正确解析。
|
||||
|
||||
如果详细信息面板为空，检查`CDataOperator::ShowIps2DpTdInfo`等方法是否成功获取了`CTestingData`对象，并确认`ShowDetailInfo`方法是否被正确调用。
|
||||
|
||||
**章节来源**
|
||||
- [datamngframe.cpp](file://cpp/Views/datamngframe.cpp#L249-L312)
|
||||
- [DataOperator.cpp](file://cpp/Operator/DataOperator.cpp#L544-L579)
|
||||
- [Ipsp2DTd.cpp](file://cpp/ProblemZone/Ipsp2DTd.cpp#L48-L75)
|
||||
|
||||
## 结论
|
||||
GeomativeStudio的测量数据浏览功能通过一个清晰的分层架构实现了数据的展示与交互。`CDataMngFrame`作为中心枢纽，协调着列表视图、详情面板和图形化组件的联动。MFC的消息映射机制是实现这一联动的核心。对于开发者而言，扩展功能的关键在于理解句柄解析机制和数据操作流程。未来应考虑引入虚拟列表和异步加载以提升大规模数据下的用户体验。
|
||||
Reference in New Issue
Block a user