Files
Just-DataInspector/Components/Application/Inc/Application.hpp
T
DeepSeek V4.1 Flash 82a29362eb 网格管理增强:新信号置底、拆分当前网格、中键自由平移、选区模式图例可用、面板悬停高亮、中心轴样式与越界三角
- 新勾选的信号所在网格固定出现在**最下方**:
  原先 PER_SIGNAL 模式按 visibleRefs(文件/列序)重建网格,新勾选的信号会按其列序插到
  中间,位置看起来"不确定"。现在先按「原有网格位置」排序(已分配过网格的信号保持相对次序),
  再把尚未分配网格(新勾选)的信号统一追加到末尾。

- 网格右键菜单在「实验性功能」上方新增「拆分当前网格」(`PLOT_CMD_LANE_SPLIT`):
  把该网格内的信号按个拆分成独立网格,新网格插入到原网格的**下方依次排列**,
  原网格下方的网格顺次后移。网格编号(GX)完全由位置推导,因此左侧列表徽标、图例徽标、
  面板标题、菜单标题等所有使用该编号的地方会同步更新,不会错位。
  新增 `TabConfig::SplitLane()` / `PlotView::SplitLane()` / `PlotView::LaneSignalCount()`
  (仅 1 条信号时菜单项置灰)。拆分出来的网格继承原网格的网格自身状态
  (Y 轴自适应、边沿计数、面板位置等)。

- 鼠标**中键**按下拖拽也可自由查看区域(水平平移时间轴 + 纵向偏移当前网格幅值):
  新增 `PlotView::OnMButtonDown/OnMButtonUp` 与 `Application::WM_MBUTTONDOWN/UP`,
  **任何缩放模式下都可用**(不改变当前模式)。拖动期间 `WM_MOUSEMOVE` 的按键掩码
  加入 `MK_MBUTTON`,光标刷新为抓握图标。

- 选区放大模式下不再阻断图例交互:把「点击图例条目 → 选中信号」的判定移到选区放大分支
  **之前**,并让图例悬停(半高亮)在选区放大模式下同样生效(该模式只应改变拖拽语义)。
  同时选区放大模式下也可用中键拖拽平移。

- 实验性功能浮动面板悬停时高亮其所属网格(与鼠标直接停在网格上一致):
  `OnMouseMove` 中若鼠标落在面板上则把 `m_hoverLane` 置为该面板所属网格。

- 「边沿计数(中心轴)」:
  * 中心平均值曲线的颜色样式改为与光标一致(`CursorColor(1)`,即「边沿计数」横向光标
    与中心值胶囊的颜色),曲线与其取值标注、光标形成统一的视觉语言。
  * 中心值标注形式改为「数值(中心轴)」(数值在前、尾缀在后);
    双光标模式下由右侧光标额外显示增量,形如「数值(+0.0008 中心轴)」,
    与常规信号的增量显示保持一致(无尖头括号)。
  * 修复:光标处于当前显示区域之外(贴边显示)时,常规数据点会变成三角指示方向,
    而中心轴数据点仍是圆点。现在中心轴数据点复用同一分支,越界时同样绘制三角。

验证(TestData/VERY_BIG_DATA.CSV,125%、1725x996):
- 置底:先勾选第 5 个信号(电流钳采集(原始))→ G1,再勾选第 1 个信号(编码器A相)→ G2,
  新勾选的信号确实出现在最下方。
- 拆分:G1(编码器A相) / G2(飞线IO+编码器B相) / G3(电流钳(原始)) 时拆分 G2,
  得到 G1 / G2(飞线IO) / G3(编码器B相) / G4(电流钳(原始)),
  原本在中间的电流钳顺延为 G4,左侧徽标、图例徽标全部同步。
- 中键:常规模式与选区放大模式下中键拖拽均能把时间轴平移到 80~160(截图核对)。
- 选区放大模式:悬停图例条目显示半高亮;点击图例条目可切换选中信号(左侧高亮随之切换)。
- 面板悬停:鼠标停在 G1 的「边沿计数」面板上时 G1 区域被高亮(与悬停 G1、G2 两种情形
  做区域哈希对比,确认高亮归属正确)。
- 中心轴:曲线为光标橙 `#CB4B16`;面板标题「中心轴边沿计数」、底部「平滑点数 N = 5」;
  单光标显示 `4.9417` + `4.94199(中心轴)`;
  双光标(标题带「(光标区间内)」,计数 341959/341957)右侧光标显示
  `4.9425 (+0.000…)` + `4.94214(+0.00… 中心轴)`,左侧光标无增量;
  把 N 改为 4000 后曲线与计数同步更新(2333700/2333700);
  用选区放大把光标推到视野外后,中心轴数据点在与信号相同的贴边位置绘制为**橙色三角**
  (像素扫描 x=479 处得到 6px 高的 `#CB4B16` 三角,而非常规圆点)。
- 回归:[1].CSV 上「边沿计数」面板正常(上升沿 2 / 下降沿 2),中键平移正常。
- make clean && make all 无警告无错误。
2026-10-09 15:21:10 +08:00

372 lines
12 KiB
C++

#ifndef __APPLICATION_HPP__
#define __APPLICATION_HPP__
#include <windows.h>
#include <objidl.h>
#include <gdiplus.h>
#include <string>
#include <vector>
#include "ColorPickerPopup.hpp"
#include "DataModel.hpp"
#include "PaintUtil.hpp"
#include "PlotView.hpp"
#include "PopupMenu.hpp"
#include "SignalPanel.hpp"
#include "TabBar.hpp"
#include "Theme.hpp"
#include "Toolbar.hpp"
namespace jdi
{
/**
* @brief 应用主框架:负责窗口、布局、消息分发、标签页管理与绘制合成。
*
* 数据层(DataSet)全局共享,标签页仅保存各自的视图配置(TabConfig),
* 因此新标签页可以独立勾选信号、独立配色与分组,互不影响。
*/
class Application
{
public:
/**
* @brief 获取全局唯一应用实例。
* @return 应用实例引用。
*/
static Application& Instance();
/**
* @brief 初始化环境、创建窗口并进入消息循环。
* @param [IN] instance 模块实例句柄。
* @param [IN] showCommand 窗口显示方式。
* @return 进程退出码。
*/
int Run(HINSTANCE instance, int showCommand);
/**
* @brief 窗口过程中转处理函数。
* @param [IN] hwnd 窗口句柄。
* @param [IN] message 消息标识。
* @param [IN] wParam 消息参数。
* @param [IN] lParam 消息参数。
* @return 消息处理结果。
*/
LRESULT HandleMessage(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam);
private:
/**
* @brief 鼠标交互的作用目标。
*/
enum class Target : int
{
NONE = 0, /**< 无目标。 */
TAB_BAR, /**< 标签栏。 */
TOOLBAR, /**< 工具栏。 */
PANEL, /**< 信号面板。 */
PLOT, /**< 波形绘图区。 */
SPLITTER, /**< 面板分隔条。 */
EDIT_FIELD /**< 内联输入框(拖拽框选选区)。 */
};
Application() = default;
~Application() = default;
Application(const Application&) = delete;
Application& operator=(const Application&) = delete;
/**
* @brief 窗口过程静态回调。
* @param [IN] hwnd 窗口句柄。
* @param [IN] message 消息标识。
* @param [IN] wParam 消息参数。
* @param [IN] lParam 消息参数。
* @return 消息处理结果。
*/
static LRESULT CALLBACK WindowProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam);
/**
* @brief 创建主窗口与相关资源。
* @param [IN] instance 模块实例句柄。
* @param [IN] showCommand 窗口显示方式。
* @return 创建成功返回 true。
*/
bool Initialize(HINSTANCE instance, int showCommand);
/**
* @brief 释放窗口与绘图资源。
*/
void Shutdown();
/**
* @brief 依据 DPI 重建字体与布局。
* @param [IN] dpi 目标 DPI。
*/
void ApplyDpi(UINT dpi);
/**
* @brief 重新计算各区域的布局。
*/
void Relayout();
/**
* @brief 创建或调整后备缓冲区尺寸。
* @param [IN] width 客户区宽度。
* @param [IN] height 客户区高度。
*/
void EnsureBackBuffer(int width, int height);
/**
* @brief 释放后备缓冲区。
*/
void ReleaseBackBuffer();
/**
* @brief 完整重绘客户区并呈现到窗口。
*/
void Render();
/**
* @brief 获取当前激活标签页配置(可写)。
* @return 激活标签页配置引用。
*/
TabConfig& ActiveTab();
/**
* @brief 获取当前激活标签页配置(只读)。
* @return 激活标签页配置引用。
*/
const TabConfig& ActiveTab() const;
/**
* @brief 新建标签页并切换为激活页。
*/
void NewTab();
/**
* @brief 生成当前未被占用的最小标签页名称(关闭标签页后编号可被复用)。
* @return 形如「视图 N」的名称。
*/
std::wstring NextTabName() const;
/**
* @brief 关闭指定标签页。
* @param [IN] index 标签页下标。
*/
void CloseTab(int index);
/**
* @brief 切换激活标签页并重新绑定各组件上下文。
* @param [IN] index 标签页下标。
*/
void SetActiveTab(int index);
/**
* @brief 将标签栏内容与当前标签页集合同步。
*/
void RefreshTabBar();
/**
* @brief 检测激活标签页的可见性/网格变化,并同步绘图区与布局。
* @param [IN] force 是否强制同步(忽略缓存比对)。
*/
void SynchronizeView(bool force);
/**
* @brief 将全部标签页配置与数据层对齐(文件增删后调用)。
*/
void SyncTabsToDataSet();
/**
* @brief 从工作区移除指定文件并修正各标签页配置。
* @param [IN] fileIndex 文件下标。
*/
void RemoveFile(int fileIndex);
/**
* @brief 处理标签栏交互结果。
* @param [IN] result 交互结果。
*/
void OnTabBarResult(const TabBarResult& result);
/**
* @brief 弹出标签页右键菜单(主题化自绘菜单)。
* @param [IN] result 标签栏交互结果。
*/
void ShowTabContextMenu(const TabBarResult& result);
/**
* @brief 弹出绘图区网格右键菜单(设置 Y 轴上下限 / 恢复自适应)。
* @param [IN] laneIndex 目标网格下标。
* @param [IN] x 客户区横坐标。
* @param [IN] y 客户区纵坐标。
*/
void ShowPlotContextMenu(int laneIndex, int x, int y);
/**
* @brief 把网格菜单上的 Y 轴上下限显示值刷新为数据层的真实值(菜单保持打开)。
* @param [IN] laneIndex 网格下标。
*/
void RefreshPlotMenuValues(int laneIndex);
/**
* @brief 派发弹出菜单的选择结果。
* @param [IN] result 菜单选择结果。
*/
void DispatchMenuResult(const MenuResult& result);
/**
* @brief 调整标签页顺序(拖拽重排)。
* @param [IN] from 被移动的标签页下标。
* @param [IN] target 目标插入位置(插入到该下标之前)。
*/
void MoveTab(int from, int target);
/**
* @brief 应用绘图区提交的信号重命名请求。
* @return 应用了重命名返回 true。
*/
bool ApplyPendingRename();
/**
* @brief 弹出文件选择对话框并加载所选文件。
*/
void OpenFileDialog();
/**
* @brief 加载指定 CSV 文件并刷新界面。
* @param [IN] path 文件完整路径。
* @return 加载成功返回 true。
*/
bool LoadFile(const std::wstring& path);
/**
* @brief 执行工具栏动作。
* @param [IN] action 动作标识。
*/
void ExecuteToolbarAction(ToolbarAction action);
/**
* @brief 处理键盘按键。
* @param [IN] key 虚拟键码。
* @return 已处理返回 true。
*/
bool HandleKeyDown(WPARAM key);
/**
* @brief 报告操作结果信息。
* @param [IN] text 提示文本。
* @param [IN] isError 是否为错误提示。
* @note 界面不再保留常驻状态栏:错误以对话框提示,普通提示被忽略,避免无用信息干扰。
*/
void SetStatusMessage(const std::wstring& text, bool isError);
/**
* @brief 刷新窗口标题。
*/
void UpdateWindowTitle();
/**
* @brief 解析命令行中的文件参数并加载。
*/
void LoadCommandLineFiles();
/**
* @brief 在后台线程解析并构建数据文件,同时播放加载过渡动画(界面不卡死)。
*
* 大文件的瓶颈在“解析 CSV”与“按列重组采样数据”,这两步都不依赖 DataSet,
* 因此放在工作线程执行;主线程循环抽送消息并重绘加载遮罩层,
* 直到后台完成后再把结果移动进 DataSet(O(1),不会引起卡顿)。
*
* @param [IN] path 文件路径。
* @param [OUT] file 构建好的数据文件。
* @param [OUT] error 失败原因描述。
* @return 加载成功返回 true;用户取消或失败返回 false。
*/
bool LoadFileAsync(const std::wstring& path, DataFile& file, std::wstring& error);
/**
* @brief 绘制加载过渡动画遮罩(在 Render 的最后一步调用,覆盖整个客户区)。
* @param [IN,OUT] g 绘图上下文。
* @param [IN] width 客户区宽度。
* @param [IN] height 客户区高度。
*/
void PaintLoadingOverlay(gd::Graphics& g, int width, int height);
/**
* @brief 处理客户区鼠标移动。
* @param [IN] x 客户区横坐标。
* @param [IN] y 客户区纵坐标。
* @param [IN] buttonDown 是否有按键处于按下状态。
* @return 需要重绘返回 true。
*/
bool HandleMouseMove(int x, int y, bool buttonDown);
/**
* @brief 拖动(鼠标捕获)期间主动刷新光标形状。
*
* Windows 在鼠标被捕获时不再派发 `WM_SETCURSOR`,若不主动设置,
* 光标会一直停留在按下瞬间的形状(例如选区放大时看不到十字/方向箭头)。
*
* @param [IN] x 客户区横坐标。
* @param [IN] y 客户区纵坐标。
*/
void UpdateDragCursor(int x, int y);
HINSTANCE m_instance = nullptr; /**< 模块实例句柄。 */
HWND m_hwnd = nullptr; /**< 主窗口句柄。 */
UINT m_dpi = 96; /**< 当前 DPI。 */
float m_scale = 1.0f; /**< DPI 缩放比例。 */
ULONG_PTR m_gdiplusToken = 0; /**< GDI+ 运行时令牌。 */
bool m_gdiplusReady = false; /**< GDI+ 是否初始化成功。 */
Theme m_theme; /**< 主题配色。 */
UiFonts m_fonts; /**< 界面字体。 */
PopupMenu m_menu; /**< 与主题一致的自绘弹出菜单。 */
ColorPickerPopup m_colorPicker; /**< 与主题一致的浮动拾色器。 */
DataSet m_dataSet; /**< 全局共享的数据集合。 */
std::vector<TabConfig> m_tabs; /**< 标签页配置集合。 */
int m_activeTab = -1; /**< 当前激活标签页下标。 */
TabBar m_tabBar; /**< 顶部标签栏。 */
Toolbar m_toolbar; /**< 顶部工具栏。 */
SignalPanel m_panel; /**< 左侧信号面板。 */
PlotView m_plot; /**< 波形绘图区。 */
gd::RectF m_tabBarRect; /**< 标签栏区域。 */
gd::RectF m_toolbarRect; /**< 工具栏区域。 */
gd::RectF m_panelRect; /**< 信号面板区域。 */
gd::RectF m_splitterRect; /**< 面板分隔条区域。 */
gd::RectF m_plotRect; /**< 绘图区区域。 */
float m_panelWidth = 366.0f; /**< 面板宽度(逻辑像素)。 */
bool m_draggingSplitter = false; /**< 是否正在拖动分隔条。 */
bool m_middlePanning = false; /**< 是否正在用鼠标中键自由平移绘图区。 */
int m_splitterGrabOffset = 0; /**< 分隔条拖动的抓取偏移。 */
HDC m_backDc = nullptr; /**< 后备缓冲设备上下文。 */
HBITMAP m_backBitmap = nullptr; /**< 后备缓冲位图。 */
HGDIOBJ m_backOldBitmap = nullptr; /**< 后备缓冲原始位图。 */
int m_backWidth = 0; /**< 后备缓冲宽度。 */
int m_backHeight = 0; /**< 后备缓冲高度。 */
Target m_activeTarget = Target::NONE; /**< 当前鼠标作用目标。 */
bool m_trackingLeave = false; /**< 是否已注册鼠标离开通知。 */
bool m_hintTimerActive = false; /**< 提示浮层淡出定时器是否已启动。 */
int m_tabMenuIndex = -1; /**< 标签栏右键菜单的目标标签页下标。 */
int m_plotMenuLane = -1; /**< 绘图区右键菜单的目标网格下标。 */
int m_cachedVisibleCount = -1; /**< 上次同步时的可见信号数量。 */
std::size_t m_cachedLaneCount = 0; /**< 上次同步时的网格数量。 */
bool m_cachedAnyVisible = false; /**< 上次同步时是否存在可见信号。 */
bool m_loading = false; /**< 是否正在显示加载过渡动画。 */
std::wstring m_loadingText; /**< 加载遮罩显示的文件名。 */
float m_loadingProgress = 0.0f; /**< 加载进度(0-1)。 */
float m_loadingSpin = 0.0f; /**< 加载动画旋转相位(度)。 */
unsigned long long m_loadingBytes = 0; /**< 当前文件字节数(用于展示体积)。 */
};
} // namespace jdi
#endif // __APPLICATION_HPP__