MPAndroidChart 教程：修改视窗 Modifying the Viewport（九）

时间 2020-07-12 标签 mpandroidchart 教程修改视窗 modifying viewport

其他文章索引：
MPAndroidChart 教程：概述
 MPAndroidChart 教程：开始 Getting Started（一）
MPAndroidChart 教程：与图表进行手势交互 Interaction with the Chart（二）
MPAndroidChart 教程：坐标轴，X轴，Y轴，Labels（三）
MPAndroidChart 教程：设置数据，设置颜色（四）
MPAndroidChart 教程：数据格式器 ValueFormatter（五）
MPAndroidChart 教程：图表的具体设置 Specific chart settings（六）
MPAndroidchart 教程：图例 Legend（七）
MPAndroidChart 教程：动态和实时数据 Dynamic & Realtime Data（八）
MPAndroidChart 教程：修改视窗 Modifying the Viewport（九）
MPAndroidChart 教程：动画 Animations（十）
MPAndroidChart 教程：MarkerView（十一）
MPAndroidChart 教程：ChartData类，ChartData子类， DataSet类，DataSet子类（十二）
时间仓促，不免有错误，有的话但愿你们在评论中指出，谢谢。
源码：范例代码在线查看或下载java

1、概述

MPAndroidChart 图表具备多种不一样的方法来修改视窗（图表上那些是可见的，以及 aim of the view）。注意，这些方法仅适用于 LineChart , BarChart , ScatterChart 和 CandleStickChart .git

请注意，修改视口的全部方法须要在 为Chart 设置数据以后 调用。github

2、什么是可见的

setVisibleXRangeMinimum(float minXRange) : 设定x轴最大可见区域范围的大小。若是设置为17，则不可能进一步放大视图（在x轴超过17的值）。

// 上面左图不作任何处理
    // 上面右图：
    chart.setVisibleXRangeMinimum(17);

setVisibleXRangeMaximum(float maxXRange) : 设定x轴最大可见区域范围的大小。若是设定为3，则在x轴超过3的值被视为不可见（不滑动 chart 的话）。

chart.setVisibleXRangeMaximum(3); // 效果如上面左图

    // 这时你会发现能够移动 chart 了
    // 手指稍微左滑下效果图如上面右图

setVisibleYRangeMaximum(float maxYRange, AxisDependency axis) : 设定y轴最大可见区域范围的大小。您还须要提供要对应的轴（YAxis.AxisDependency.LEFT 或 YAxis.AxisDependency.RIGHT )

// 上面左效果图对应代码
    chart.setVisibleYRangeMaximum(50f,YAxis.AxisDependency.LEFT);

    // 上面右效果图对应代码
    chart.setVisibleYRangeMaximum(70f,YAxis.AxisDependency.LEFT);

setViewPortOffsets(float left, float top, float right, float bottom) : 设置当前视图的偏移量（实际图表窗口的两侧偏移量）。设置这个，将阻止图表自动计算它的偏移量。
使用 resetViewPortOffsets() 撤消此设置。

chart.setViewPortOffsets(50,0,0,0);     // 图1
    chart.setViewPortOffsets(0,50,0,0);     // 图2
    chart.setViewPortOffsets(50,50,0,0);    // 图3
    chart.setViewPortOffsets(50,50,50,50);  // 图4

resetViewPortOffsets() : 撤销全部经过 setViewPortOffsets(...) 方法设置的偏移量。容许图表再次自动计算全部偏移。
setExtraOffsets(float left, float top, float right, float bottom) : 设置额外的偏移，将被添加到自动计算的偏移。这不会改变自动计算的偏移量，但增长了额外的空间给它们。

3、移动视图（它的目的）

fitScreen() : 重设全部缩放和拖动，使图表彻底适合它的边界（彻底缩小）。
moveViewToX(float xIndex) : 将当前视口的左侧（边）到指定的 x 值。

chart.setVisibleXRangeMaximum(3);

    chart.moveViewToX(2);  // 上面左效果图,Mar是三月
    chart.moveViewToX(5);  // 上面右效果图,Jun是六月

moveViewToY(float yValue, AxisDependency axis) : 使得指定的y值显示在对应y轴( 左or右 )的中间。

YAxis leftAxis = chart.getAxisLeft();
    leftAxis.setTextSize(18f);
    chart.setVisibleYRangeMaximum(50f,YAxis.AxisDependency.LEFT);

    chart.moveViewToY(40,YAxis.AxisDependency.LEFT); // 上面左效果图
    chart.moveViewToY(40,YAxis.AxisDependency.LEFT); // 上面右效果图

moveViewTo(float xIndex, float yValue, AxisDependency axis) : 至关于setVisibleXRange(...) 和 setVisibleYRange(...) 组合使用。
centerViewTo(int xIndex, float yValue, AxisDependency axis) : 至关于 setVisibleXRange(...) 和 setVisibleYRange(...) 组合使用。

注：全部 moveViewTo(...) 方法会自动 invalidate() 刷新图表。没有必要进行进一步调用 invalidate() 。web

4、变焦（编程）

zoomIn() : Zooms in by 1.4f, into the charts center.
zoomOut() : Zooms out by 0.7f, from the charts center.
zoom(float scaleX, float scaleY, float x, float y) : 根据所给的参数进行放大或缩小。参数 x 和 y 是变焦中心的坐标（单位：像素）。记住，1f = 无放缩 。

5、完整示例

chart.setData(...); // first set data

    // now modify viewport
    // allow 20 values to be displayed at 
    once on the x-axis, not more
    chart.setVisibleXRangeMaximum(20); 
    // set the left edge of the chart to x-index 10
    chart.moveViewToX(10); 

    // moveViewToX(...) also calls invalidate()