【OpenHarmony】 鸿蒙 UI开发之MpChart（二）

---

📚往期笔录记录🔖：

🔖鸿蒙应用开发与鸿蒙系统开发哪个更有前景？

🔖嵌入式开发适不适合做鸿蒙南向开发？看完这篇你就了解了~

🔖对于大前端开发来说，转鸿蒙开发究竟是福还是祸？

🔖鸿蒙岗位需求突增！移动端、PC端、IoT到底该怎么选？

🔖记录一场鸿蒙开发岗位面试经历~

🔖持续更新中……

---

接口说明

一、ChartModel

所有图表配置构建类的基类。

方法名	描述
animateX	展示图表时带有X轴动画。
animateXY	展示图表时同时带有X轴，Y轴动画。
animateY	展示图表时带有Y轴动画。
calcMinMax	计算 y-min 和 y-max 值以及 y-delta 和 x-delta 值。
calculateOffsets	计算图表到边框的偏移量，具体取决于图例的位置，x轴y轴的长度，及其的标签位置。
clear	清空图表的所有数据，将其置空null，并刷新图表。
clearValues	从图表中删除所有数据集（以及条目），并刷新图表。
getAnimator	返回负责对图表值进行动画处理的动画制作者。
getCenter	返回图表(整个视图)的中心点的可回收的MPPointF实例。
getCenterOffsets	返回图表的图形绘制的中心区域的可回收的MPPointF实例。
getCenterOfView	返回图表(整个视图)的中心点的可回收的MPPointF实例。
getContentRect	返回图表绘制的内容区域的矩形。
getData	返回已为图表设置的 ChartData 对象。
getDefaultValueFormatter	返回默认的数据格式化接口实现类。
getHighlightByTouchPoint	返回 LineChart，ScatterChart，CandleStickChart等图表触摸屏幕时的Highlight 对象（包含 x-index 和 DataSet 索引）。
getHighlighted	返回当前高亮显示值的数组。这可能是空值，如果没有突出显示，则为空数组。
getHighlighter	返回当前高亮显示条目接口。
getLegend	获取图例对象，通过该对象的setEnable(false)方法可以关闭图例显示。
getLegendRenderer	获取图例渲染器。
getRenderer	获取图表数据渲染器。
getXAxis	获取X轴对象。
invalidate	重绘图表。
notifyDataSetChanged	图表数据刷新。
onChartSizeChanged	更新图表正确Size。
onDraw	图表绘制方法。
setContext2D	设置图表绘制的画布。
setData	设置图表数据。
setDragDecelerationEnabled	设置是否开启惯性滑动。
setHitTestMode	设置触摸测试类型。
getHitTestMode	获取触摸测试类型。

1.animateX

public animateX(durationMillis: number): void;

展示图表时带有X轴动画。

参数：

参数名	类型	必填	说明
durationMillis	number	是	动画播放的时长，单位毫秒。

public animateX(durationMillis: number, easing: string): void;

展示图表时带有X轴动画。

参数：

参数名	类型	必填	说明
durationMillis	number	是	动画播放的时长，单位毫秒。
easing	string	是	动画插值曲线。

2.animateXY

public animateXY(durationMillisX: number, durationMillisY: number): void;

展示图表时同时带有X轴，Y轴动画。

参数：

参数名	类型	必填	说明
durationMillisX	number	是	X轴条目动画播放的时长，单位毫秒。
durationMillisY	number	是	Y轴条目动画播放的时长，单位毫秒。

public animateXY(durationMillisX: number, durationMillisY: number, easingX: string): void;

展示图表时同时带有X轴，Y轴动画。

参数：

参数名	类型	必填	说明
durationMillisX	number	是	X轴条目动画播放的时长，单位毫秒。
durationMillisY	number	是	Y轴条目动画播放的时长，单位毫秒。
easingX	string	是	X轴动画插值曲线。

public animateXY(durationMillisX: number, durationMillisY: number, easingX: string, easingY: string): void;

展示图表时同时带有X轴，Y轴动画。

参数：

参数名	类型	必填	说明
durationMillisX	number	是	X轴条目动画播放的时长，单位毫秒。
durationMillisY	number	是	Y轴条目动画播放的时长，单位毫秒。
easingX	string	是	X轴动画插值曲线 。
easingY	string	是	Y轴动画插值曲线。

3.animateY

展示图表时带有Y轴动画。

public animateY(durationMillis: number): void;

参数：

参数名	类型	必填	说明
durationMillis	number	是	动画播放的时长，单位毫秒。

public animateY(durationMillis: number, easing: string): void;

参数：

参数名	类型	必填	说明
durationMillis	number	是	动画播放的时长，单位毫秒。
easing	string	是	动画插值曲线。

4.calcMinMax

protected abstract calcMinMax() : void;

计算 y-min 和 y-max 值以及 y-delta 和 x-delta 值。

5.calculateOffsets

protected abstract calculateOffsets() : void;

计算图表到边框的偏移量，具体取决于图例的位置，x轴y轴的长度，及其的标签位置。

6.clear

public clear() : void;

清空图表的所有数据，将其置空null，并刷新图表。

7.clearValues

public clearValues() : void;

从图表中删除所有数据集（以及条目），并刷新图表。

8.getAnimator

public getAnimator(): ChartAnimator | null;

返回负责对图表值进行动画处理的动画制作者。

返回值：

类型	说明
ChartAnimator	null

9.getCenter

public getCenter(): MPPointF;

返回图表(整个视图)的中心点的可回收的MPPointF实例。

返回值：

类型	说明
MPPointF	可回收的MPPointF实例。

10.getCenterOffsets

public getCenterOffsets(): MPPointF | null;

返回图表的图形绘制的中心区域的可回收的MPPointF实例。

返回值：

类型	说明
MPPointF	null

11.getCenterOfView

public getCenterOfView(): MPPointF;

返回图表(整个视图)的中心点的可回收的MPPointF实例。

返回值：

类型	说明
MPPointF	可回收的MPPointF实例。

12.getContentRect

public getContentRect(): Rect;

返回图表绘制的内容区域的矩形。

返回值：

类型	说明
Rect	图表绘制的内容区域的矩形。

13.getData

public getData(): T | null ;

返回已为图表设置的 ChartData 对象。

返回值：

类型	说明
T	null

14.getDefaultValueFormatter

public getDefaultValueFormatter(): IValueFormatter;

返回默认的数据格式化接口实现类。

返回值：

类型	说明
IValueFormatter	数据格式化接口实现类。

15.getHighlightByTouchPoint

public getHighlightByTouchPoint(x: number, y: number): Highlight | null;

返回 LineChart，ScatterChart，CandleStickChart等图表触摸屏幕时的Highlight 对象（包含 x-index 和 DataSet 索引）。

参数：

参数名	类型	必填	说明
x	number	是	屏幕触摸点的x轴坐标。
y	number	是	屏幕触摸点的y轴坐标。

返回值：

类型	说明
Highlight	null

16.getHighlighted

public getHighlighted(): Highlight[] | null;

返回当前高亮显示值的数组。这可能是空值，如果没有突出显示，则为空数组。

参数：

参数名	类型	必填	说明
x	number	是	屏幕触摸点的x轴坐标。
y	number	是	屏幕触摸点的y轴