Files
Just-DataInspector/Components/PlotView/Inc/PlotView.hpp
T
DeepSeek V4.1 Flash 542aa51e40 feat: 重构绘图区网格布局与信号拖拽,精简界面信息并新增 Y 轴精确控制
网格与标尺:
- 消除网格之间无意义的间隔,改用较重的横向分界线明确区分相邻网格
- 纵轴标尺从绘图区左侧外侧移入网格内侧,并改为带半透明衬底的覆盖层绘制,
  使其在波形之上依然清晰可读;绘图区左侧空间因此完全还给波形
- 继续保证底部时间轴预留高度,并把时间列名贴左显示、避开刻度标签

常规模式拖拽:
- 常规模式下水平拖动平移时间轴,纵向拖动偏移当前网格的幅值显示位置
- 绘图区右键菜单新增「恢复 Y 轴自适应」「设置 Y 轴最大值…」「设置 Y 轴最小值…」
  「全部自适应」,上下限通过内联输入框直接键入(与线宽输入一致的交互)

信号拖拽:
- 鼠标贴近信号曲线时给出光晕高亮与提示气泡(与时间光标的提示方式一致)
- 仅在出现提示时按左键才会进入拖拽;拖拽过程中在目标网格内绘制曲线虚影、
  高亮目标网格边框并提示「移动到网格 N」,松开左键确认归属变更
- 命中检测基于折线到光标的精确点到线段距离,散点模式按采样点距离判定

界面精简:
- 移除底部状态栏(左下角统计与右下角提示均不再占用空间),错误改由对话框提示
- 标题栏只显示应用名称
- 移除工具栏右上角的视图时间范围文本;按钮除「导入文件」外整体靠右排列

其他:
- 新增 PlotView::PaintEditField 统一绘制时间光标与网格 Y 轴上下限的输入框
- 移除已无引用的 UiDrawDashedLine 与绘图区标尺占位宽度
2026-09-29 20:49:21 +08:00

636 lines
20 KiB
C++

#ifndef __PLOT_VIEW_HPP__
#define __PLOT_VIEW_HPP__
#include <windows.h>
#include <objidl.h>
#include <gdiplus.h>
#include <string>
#include <vector>
#include "DataModel.hpp"
#include "PaintUtil.hpp"
#include "Theme.hpp"
namespace jdi
{
/**
* @brief 绘图区拖拽交互模式。
*/
enum class PlotDragMode : int
{
NONE = 0, /**< 未拖拽。 */
PAN, /**< 常规模式:水平平移时间轴 + 纵向偏移当前网格幅值。 */
RUBBER_TIME, /**< 时间轴缩放选区(竖向贯穿全高)。 */
RUBBER_VALUE, /**< Y 轴缩放选区(限定在某个网格内)。 */
SCROLL_LANES, /**< 拖动网格滚动条。 */
CURSOR_MOVE, /**< 拖拽时间光标。 */
MOVE_SIGNAL /**< 拖拽信号曲线到其它网格。 */
};
/**
* @brief 绘图区内的内联数值输入目标。
*/
enum class PlotEditTarget : int
{
NONE = 0, /**< 未处于输入状态。 */
CURSOR_TIME, /**< 编辑时间光标位置。 */
LANE_Y_MAX, /**< 编辑某网格的 Y 轴最大值。 */
LANE_Y_MIN /**< 编辑某网格的 Y 轴最小值。 */
};
/**
* @brief 绘图区右键菜单命令标识(与信号面板的命令空间相互独立)。
*/
enum PlotMenuCommand : int
{
PLOT_CMD_LANE_AUTO = 1, /**< 该网格恢复 Y 轴自适应。 */
PLOT_CMD_LANE_Y_MAX = 2, /**< 输入该网格 Y 轴最大值。 */
PLOT_CMD_LANE_Y_MIN = 3, /**< 输入该网格 Y 轴最小值。 */
PLOT_CMD_FIT_ALL = 4 /**< 全部网格与时间轴自适应。 */
};
/**
* @brief 波形绘图区:网格、时间轴、光标、缩放、自适应与信号拖拽。
*
* 绘图区同时依赖数据层(DataSet,只读)与当前标签页配置(TabConfig,可写),
* 视图范围、网格滚动与时间光标均保存在标签页配置中,因此各标签页互不干扰。
*/
class PlotView
{
public:
PlotView();
/**
* @brief 绑定字体与主题资源。
* @param [IN] fonts 字体集合,需在视图生命周期内保持有效。
* @param [IN] theme 主题配色,需在视图生命周期内保持有效。
*/
void Setup(const UiFonts* fonts, const Theme* theme);
/**
* @brief 绑定数据层与当前标签页配置。
* @param [IN] dataSet 数据集合,允许为空。
* @param [IN] tab 当前标签页配置,允许为空。
*/
void SetContext(const DataSet* dataSet, TabConfig* tab);
/**
* @brief 设置 DPI 缩放比例。
* @param [IN] scale 缩放比例(1.0 对应 96 DPI)。
*/
void SetScale(float scale);
/**
* @brief 按给定区域重新排布绘图区。
* @param [IN] area 可用区域。
*/
void Layout(const gd::RectF& area);
/**
* @brief 绘制绘图区。
* @param [IN,OUT] g 绘图上下文。
*/
void Paint(gd::Graphics& g);
/**
* @brief 处理鼠标移动(含拖拽)。
* @param [IN] x 客户区横坐标。
* @param [IN] y 客户区纵坐标。
* @return 需要重绘返回 true。
*/
bool OnMouseMove(int x, int y);
/**
* @brief 处理鼠标左键按下。
* @param [IN] x 客户区横坐标。
* @param [IN] y 客户区纵坐标。
* @return 需要重绘返回 true。
*/
bool OnLButtonDown(int x, int y);
/**
* @brief 处理鼠标左键抬起。
* @param [IN] x 客户区横坐标。
* @param [IN] y 客户区纵坐标。
* @return 需要重绘返回 true。
*/
bool OnLButtonUp(int x, int y);
/**
* @brief 处理鼠标滚轮(仅用于平移与网格滚动,不再承担缩放)。
* @param [IN] x 客户区横坐标。
* @param [IN] y 客户区纵坐标。
* @param [IN] delta 滚轮增量。
* @param [IN] shift 是否按下 Shift(水平平移时间轴)。
* @return 需要重绘返回 true。
*/
bool OnMouseWheel(int x, int y, int delta, bool shift);
/**
* @brief 处理鼠标双击(命中时间光标时进入精确时间输入)。
* @param [IN] x 客户区横坐标。
* @param [IN] y 客户区纵坐标。
* @return 需要重绘返回 true。
*/
bool OnDoubleClick(int x, int y);
/**
* @brief 处理鼠标离开绘图区。
* @return 需要重绘返回 true。
*/
bool OnMouseLeave();
/**
* @brief 判断坐标是否落在绘图区范围内。
* @param [IN] x 客户区横坐标。
* @param [IN] y 客户区纵坐标。
* @return 落在范围内返回 true。
*/
bool HitTest(int x, int y) const;
/**
* @brief 查询当前鼠标位置应使用的系统光标。
* @param [IN] x 客户区横坐标。
* @param [IN] y 客户区纵坐标。
* @return 系统光标句柄,未命中特殊区域返回 nullptr。
*/
HCURSOR QueryCursor(int x, int y) const;
/**
* @brief 时间轴与幅值轴同时自适应到可见信号范围。
*/
void FitAll();
/**
* @brief 以给定倍率缩放时间轴(以视图中心为锚点)。
* @param [IN] factor 缩放倍率,大于 1 表示放大。
*/
void ZoomTimeStep(double factor);
/**
* @brief 按当前视图跨度的比例平移时间轴。
* @param [IN] fraction 平移比例,正值向右(时间增大)平移。
*/
void PanTimeByFraction(double fraction);
/**
* @brief 按网格内容高度的比例纵向滚动网格。
* @param [IN] fraction 滚动比例,正值向下滚动。
*/
void ScrollLanesByFraction(double fraction);
/**
* @brief 获取网格当前内容总高度。
* @return 内容高度(像素)。
*/
float LaneContentHeight() const { return m_laneContentHeight; }
/**
* @brief 清除已启用的时间光标。
*/
void DisableCursor();
/**
* @brief 切换时间光标:启用时置于当前视图中心,再调用则关闭。
* @return 状态发生变化返回 true。
*/
bool ToggleCursor();
/**
* @brief 判断时间光标是否已启用。
* @return 启用返回 true。
*/
bool CursorEnabled() const;
/**
* @brief 获取当前光标对应的时间。
* @return 光标时间。
*/
double CursorTime() const;
/**
* @brief 切换拖拽缩放模式(再次调用同一模式则取消)。
* @param [IN] mode 目标模式。
* @return 状态发生变化返回 true。
*/
bool ToggleZoomMode(PlotZoomMode mode);
/**
* @brief 获取当前拖拽缩放模式。
* @return 模式枚举。
*/
PlotZoomMode CurrentZoomMode() const;
/**
* @brief 查询坐标命中的网格下标(用于右键菜单)。
* @param [IN] x 客户区横坐标。
* @param [IN] y 客户区纵坐标。
* @return 网格下标,未命中返回 -1。
*/
int LaneIndexAt(int x, int y) const;
/**
* @brief 判断某网格的 Y 轴是否处于自适应状态。
* @param [IN] laneIndex 网格下标。
* @return 自适应返回 true。
*/
bool LaneRangeIsAuto(int laneIndex) const;
/**
* @brief 让某网格的 Y 轴恢复自适应。
* @param [IN] laneIndex 网格下标。
* @return 状态发生变化返回 true。
*/
bool ResetLaneRange(int laneIndex);
/**
* @brief 进入某网格 Y 轴上限/下限的内联输入状态。
* @param [IN] laneIndex 网格下标。
* @param [IN] editMax 为 true 编辑上限,为 false 编辑下限。
* @return 进入成功返回 true。
*/
bool BeginLaneValueEdit(int laneIndex, bool editMax);
/**
* @brief 判断是否处于任意内联数值输入状态。
* @return 处于编辑态返回 true。
*/
bool IsEditing() const { return m_editTarget != PlotEditTarget::NONE; }
/**
* @brief 处理编辑态下的字符输入。
* @param [IN] character 输入字符。
* @return 界面状态发生变化返回 true。
*/
bool OnEditChar(wchar_t character);
/**
* @brief 处理编辑态下的按键。
* @param [IN] key 虚拟键码。
* @return 界面状态发生变化返回 true。
*/
bool OnEditKey(WPARAM key);
/**
* @brief 获取当前视图左边界时间。
* @return 视图左边界时间。
*/
double ViewMinTime() const;
/**
* @brief 获取当前视图右边界时间。
* @return 视图右边界时间。
*/
double ViewMaxTime() const;
/**
* @brief 重新生成网格几何(可见性或网格划分变化后调用)。
*/
void RefreshLanes();
private:
/**
* @brief 单个网格的绘制信息。
*/
struct LaneVisual
{
gd::RectF rect; /**< 网格波形区域。 */
double yMin = 0.0; /**< 幅值下限。 */
double yMax = 1.0; /**< 幅值上限。 */
};
/**
* @brief 已解析的信号视图:数据与显示配置的组合。
*/
struct ResolvedSignal
{
const SignalData* data = nullptr; /**< 信号数据。 */
const SignalStyle* style = nullptr; /**< 显示配置。 */
const DataFile* file = nullptr; /**< 所属文件。 */
};
/**
* @brief 获取当前生效的标签页配置(未绑定时返回内部占位对象)。
* @return 标签页配置引用。
*/
TabConfig& Tab() { return (m_tab != nullptr) ? *m_tab : m_localTab; }
/**
* @brief 获取当前生效的标签页配置(只读)。
* @return 标签页配置引用。
*/
const TabConfig& Tab() const { return (m_tab != nullptr) ? *m_tab : m_localTab; }
/**
* @brief 判断是否存在可绘制内容(已加载数据且至少有一条可见信号)。
* @return 可绘制返回 true。
*/
bool HasDrawableContent() const;
/**
* @brief 计算当前视图应使用的时间范围。
* @param [OUT] low 时间下限。
* @param [OUT] high 时间上限。
*/
void TimeBounds(double& low, double& high) const;
/**
* @brief 解析信号引用,得到数据与显示配置。
* @param [IN] ref 信号引用。
* @return 解析结果,引用无效时各指针为空。
*/
ResolvedSignal ResolveSignal(const SignalRef& ref) const;
/**
* @brief 判断某网格内的可见信号是否来自多个文件。
* @param [IN] laneIndex 网格下标。
* @return 跨越多个文件返回 true。
*/
bool LaneSpansMultipleFiles(int laneIndex) const;
/**
* @brief 重新计算各网格的布局与幅值范围。
*/
void BuildLaneVisuals();
/**
* @brief 限制网格滚动偏移量。
*/
void ClampLaneScroll();
/**
* @brief 将时间映射为绘图区横坐标。
* @param [IN] time 时间值。
* @return 横坐标。
*/
float TimeToX(double time) const;
/**
* @brief 将绘图区横坐标还原为时间。
* @param [IN] x 横坐标。
* @return 时间值。
*/
double XToTime(float x) const;
/**
* @brief 将幅值映射为纵坐标。
* @param [IN] value 幅值。
* @param [IN] lane 网格绘制信息。
* @return 纵坐标。
*/
float ValueToY(double value, const LaneVisual& lane) const;
/**
* @brief 将纵坐标还原为幅值。
* @param [IN] y 纵坐标。
* @param [IN] lane 网格绘制信息。
* @return 幅值。
*/
double YToValue(float y, const LaneVisual& lane) const;
/**
* @brief 查询指定纵坐标落在哪个网格内。
* @param [IN] y 纵坐标。
* @return 网格下标,未命中返回 -1。
*/
int LaneAtY(int y) const;
/**
* @brief 限制时间视图范围,避免过度平移到数据之外。
*/
void ClampTimeView();
/**
* @brief 以指定锚点缩放时间轴。
* @param [IN] factor 缩放倍率,大于 1 表示放大。
* @param [IN] anchorTime 锚点时间。
*/
void ZoomTimeAt(double factor, double anchorTime);
/**
* @brief 将时间轴缩放到指定的时间区间(拖拽选区释放时调用)。
* @param [IN] x0 选区起点横坐标。
* @param [IN] x1 选区终点横坐标。
* @return 产生了有效缩放返回 true。
*/
bool ApplyTimeSelection(float x0, float x1);
/**
* @brief 将某个网格的幅值轴缩放到指定区间(拖拽选区释放时调用)。
* @param [IN] laneIndex 目标网格下标。
* @param [IN] y0 选区起点纵坐标。
* @param [IN] y1 选区终点纵坐标。
* @return 产生了有效缩放返回 true。
*/
bool ApplyValueSelection(int laneIndex, float y0, float y1);
/**
* @brief 以指定倍率缩放某网格的幅值轴(保持锚点幅值不动)。
* @param [IN] laneIndex 目标网格下标。
* @param [IN] factor 缩放倍率,大于 1 表示放大。
* @param [IN] anchorValue 锚点幅值。
*/
void ScaleLaneRange(int laneIndex, double factor, double anchorValue);
/**
* @brief 平移某网格的幅值轴(偏移波形显示位置)。
* @param [IN] laneIndex 目标网格下标。
* @param [IN] deltaValue 幅值偏移量。
*/
void ShiftLaneRange(int laneIndex, double deltaValue);
/**
* @brief 计算时间光标当前的横坐标。
* @return 横坐标。
*/
float CursorX() const;
/**
* @brief 计算时间读数标签(或编辑框)的矩形。
* @return 标签矩形,位于绘图区顶部以避免遮挡时间轴刻度。
*/
gd::RectF CursorLabelRect() const;
/**
* @brief 判断给定横坐标是否落在时间光标附近(允许拖拽的容差范围)。
* @param [IN] x 横坐标。
* @return 命中返回 true。
*/
bool IsOnCursorLine(int x) const;
/**
* @brief 精确检测鼠标位置是否命中某条可见信号曲线。
* @param [IN] x 客户区横坐标。
* @param [IN] y 客户区纵坐标。
* @return 命中的信号引用,未命中返回无效引用。
*/
SignalRef HitTestSignal(int x, int y) const;
/**
* @brief 计算当前内联输入框的矩形(依编辑目标而定)。
* @return 输入框矩形,未处于编辑态时返回空矩形。
*/
gd::RectF EditFieldRect() const;
/**
* @brief 以给定目标与初始文本进入内联输入状态。
* @param [IN] target 编辑目标。
* @param [IN] laneIndex 目标网格下标(光标编辑时忽略)。
* @param [IN] initialText 初始文本。
* @return 进入成功返回 true。
*/
bool BeginEdit(PlotEditTarget target, int laneIndex, const std::wstring& initialText);
/**
* @brief 结束内联输入。
* @param [IN] commit 是否提交当前输入。
* @return 状态发生变化返回 true。
*/
bool EndEdit(bool commit);
/**
* @brief 构建单条信号在当前视图下的折线点序列。
* @param [IN] resolved 已解析的信号视图。
* @param [IN] lane 所属网格绘制信息。
* @param [OUT] points 输出点序列。
* @param [OUT] breaks 输出每段折线的起始下标(用于处理缺失值断线)。
*/
void BuildPolyline(const ResolvedSignal& resolved, const LaneVisual& lane,
std::vector<gd::PointF>& points, std::vector<std::size_t>& breaks) const;
/**
* @brief 绘制单个网格。
* @param [IN,OUT] g 绘图上下文。
* @param [IN] laneIndex 网格下标。
* @param [IN] lane 网格绘制信息。
* @param [IN] timeTicks 时间刻度序列。
*/
void PaintLane(gd::Graphics& g, int laneIndex, const LaneVisual& lane,
const std::vector<double>& timeTicks);
/**
* @brief 绘制底部时间轴。
* @param [IN,OUT] g 绘图上下文。
* @param [IN] timeTicks 时间刻度序列。
* @param [IN] timeStep 时间刻度步长。
*/
void PaintTimeAxis(gd::Graphics& g, const std::vector<double>& timeTicks, double timeStep);
/**
* @brief 绘制时间光标、选区及其读数。
* @param [IN,OUT] g 绘图上下文。
* @param [IN] lanes 网格绘制信息集合。
*/
void PaintCursor(gd::Graphics& g, const std::vector<LaneVisual>& lanes);
/**
* @brief 绘制拖动中的缩放选区。
* @param [IN,OUT] g 绘图上下文。
*/
void PaintRubberBand(gd::Graphics& g);
/**
* @brief 绘制内联数值输入框(时间光标或网格 Y 轴上下限)。
* @param [IN,OUT] g 绘图上下文。
*/
void PaintEditField(gd::Graphics& g);
/**
* @brief 绘制信号悬停提示与拖拽虚影。
* @param [IN,OUT] g 绘图上下文。
*/
void PaintSignalInteraction(gd::Graphics& g);
/**
* @brief 绘制网格纵向滚动条。
* @param [IN,OUT] g 绘图上下文。
*/
void PaintScrollBar(gd::Graphics& g);
/**
* @brief 绘制网格标题(信号图例)。
* @param [IN,OUT] g 绘图上下文。
* @param [IN] laneIndex 网格下标。
* @param [IN] lane 网格绘制信息。
* @param [IN] visibleTop 网格在绘图区内的可见上边界。
* @param [IN] visibleBottom 网格在绘图区内的可见下边界。
*/
void PaintLaneLegend(gd::Graphics& g, int laneIndex, const LaneVisual& lane, float visibleTop,
float visibleBottom);
/**
* @brief 在网格内绘制各信号的幅值读数。
* @param [IN,OUT] g 绘图上下文。
* @param [IN] laneIndex 网格下标。
* @param [IN] lane 网格绘制信息。
* @param [IN] visibleTop 网格在绘图区内的可见上边界。
* @param [IN] visibleBottom 网格在绘图区内的可见下边界。
*/
void PaintLaneReadout(gd::Graphics& g, int laneIndex, const LaneVisual& lane, float visibleTop,
float visibleBottom);
/**
* @brief 判断给定矩形是否完整落在可见纵向区间内。
* @param [IN] rect 待测矩形。
* @param [IN] visibleTop 可见区上边界。
* @param [IN] visibleBottom 可见区下边界。
* @return 完整可见返回 true。
* @note GDI 文本绘制不会遵循 GDI+ 的裁剪区,必须显式判定,否则滚动时文字会溢出到工具栏。
*/
static bool IsFullyVisible(const gd::RectF& rect, float visibleTop, float visibleBottom);
/**
* @brief 绘制空状态提示文本。
* @param [IN,OUT] g 绘图上下文。
*/
void PaintEmptyState(gd::Graphics& g);
const UiFonts* m_fonts = nullptr; /**< 字体资源。 */
const Theme* m_theme = nullptr; /**< 主题资源。 */
const DataSet* m_dataSet = nullptr; /**< 数据集合。 */
TabConfig* m_tab = nullptr; /**< 当前标签页配置。 */
TabConfig m_localTab; /**< 未绑定标签页时使用的占位配置。 */
float m_scale = 1.0f; /**< DPI 缩放比例。 */
gd::RectF m_area; /**< 绘图区整体区域。 */
gd::RectF m_plotRect; /**< 波形绘制区域。 */
gd::RectF m_timeAxisRect; /**< 时间轴区域。 */
gd::RectF m_scrollBarRect; /**< 网格滚动条区域。 */
float m_labelBandWidth = 66.0f; /**< 网格内侧纵轴标尺带宽度(逻辑像素)。 */
float m_timeAxisHeight = 32.0f; /**< 时间轴高度(逻辑像素)。 */
float m_minLaneHeight = 54.0f; /**< 网格最小高度(逻辑像素)。 */
float m_laneContentHeight = 0.0f; /**< 网格内容总高度。 */
bool m_scrollBarVisible = false; /**< 是否需要显示滚动条。 */
PlotDragMode m_dragMode = PlotDragMode::NONE; /**< 当前拖拽模式。 */
int m_dragLane = -1; /**< 拖拽所作用的网格下标。 */
bool m_dragMoved = false; /**< 拖拽过程中是否发生了位移。 */
int m_dragStartX = 0; /**< 拖拽起点横坐标。 */
int m_dragStartY = 0; /**< 拖拽起点纵坐标。 */
int m_dragLastX = 0; /**< 上一次拖拽横坐标。 */
int m_dragLastY = 0; /**< 上一次拖拽纵坐标。 */
gd::RectF m_rubberRect; /**< 拖拽选区矩形。 */
SignalRef m_hoverSignal; /**< 鼠标悬停命中的信号(曲线高亮)。 */
SignalRef m_dragSignal; /**< 正在被拖拽的信号。 */
int m_dragTargetLane = -1; /**< 拖拽信号时的目标网格下标。 */
bool m_cursorHover = false; /**< 鼠标是否悬停在时间光标上。 */
PlotEditTarget m_editTarget = PlotEditTarget::NONE; /**< 当前内联输入目标。 */
bool m_editFresh = false; /**< 输入框是否处于“首次输入整体替换”状态。 */
std::wstring m_editText; /**< 输入框当前文本。 */
int m_editLane = -1; /**< 内联输入所作用的网格下标。 */
int m_hoverLane = -1; /**< 当前悬停网格下标。 */
int m_mouseX = 0; /**< 最近一次鼠标横坐标(用于悬停提示定位)。 */
int m_mouseY = 0; /**< 最近一次鼠标纵坐标(用于悬停提示定位)。 */
std::vector<LaneVisual> m_lanes; /**< 当前网格绘制信息集合。 */
};
} // namespace jdi
#endif // __PLOT_VIEW_HPP__