ui_scatter_plot

ui_scatter_plot 模块提供散点图组件，支持散点数据序列与散点图绘制。

Class Summary

OHOS::UIScatterPlotDataSerial

散点图数据序列类，用于设置和获取散点数据点的样式

• 构造：无

• 成员函数：

  接口名称	功能简述
  SetPointStyle	设置散点数据点的样式
  GetPointStyle	获取散点数据点的样式

• 使用包含头文件：#include "components/ui_scatter_plot.h"

• 声明头文件：middleware/services/gui/uikit/proprietary/include/components/ui_scatter_plot.h
• 公有运算符：无
• 继承关系：UIChartDataSerial
• 嵌套类型：无
• 模板形参：无

OHOS::UIScatterPlot

散点图组件类，用于显示数据点对应其 x 和 y 值的散点图

• 构造：无

• 成员函数：

  接口名称	功能简述
  RefreshChart	刷新散点图并重绘脏区域

• 使用包含头文件：#include "components/ui_scatter_plot.h"

• 声明头文件：middleware/services/gui/uikit/proprietary/include/components/ui_scatter_plot.h
• 公有运算符：无
• 继承关系：UIChart
• 嵌套类型：无
• 模板形参：无

Functions

OHOS::UIScatterPlotDataSerial

SetPointStyle

void SetPointStyle(const PointStyle& style)

功能说明

• 核心用途：设置散点数据序列中所有数据点的显示样式
• 设计目的：提供统一的点样式配置入口，包括填充色、描边色、半径和描边宽度
• 使用场景：在添加数据点后自定义散点外观，或在运行时动态更新散点样式

入参

名称	参数类型	详细说明	约束取值范围
style	const PointStyle&	入参只读引用，待设置的点样式对象，包含填充色、描边色、半径和描边宽度	PointStyle 结构体各字段取值参考 UIChartDataSerial::PointStyle 定义

GetPointStyle

const PointStyle& GetPointStyle() const

功能说明

• 核心用途：获取当前散点数据序列的点样式
• 设计目的：提供只读访问接口，供外部查询散点的显示样式配置
• 使用场景：在绘制前读取点样式以确认当前配置，或在样式更新后获取最新值

返回值

• 返回类型：const PointStyle&

返回当前散点数据序列的点样式常引用

返回值	触发场景
const PointStyle&	始终返回当前已设置的点样式引用

OHOS::UIScatterPlot

RefreshChart

void RefreshChart() override

功能说明

• 核心用途：刷新散点图并重绘脏区域，仅重绘需要更新的部分（如新增数据点）
• 设计目的：提供比 Invalidate 更高效的局部刷新机制，避免全量重绘
• 使用场景：数据点新增或修改后调用此接口触发增量刷新