MPAndroidChart 教程：修改视窗 (Modifying the Viewport)

一、概述

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

二、什么是可见的

• setVisible@L_799_3@minimum(float minxrange) : 设定x轴最大可见区域范围的大小。如果设置为17，则不可能进一步放大视图（在x轴超过17的值）。
  

  

  

// 上面左图不做任何处理
    // 上面右图：
    chart.setVisible@L_799_3@minimum(17);

• setVisible@L_799_3@maximum(float maxxrange) : 设定x轴最大可见区域范围的大小。 如果设定为3，则在x轴超过3的值被视为不可见（不滑动 chart 的话）。
  

  

  

chart.setVisible@L_799_3@maximum(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);     // 图1
    chart.setViewPortOffsets(0,50,0);     // 图2
    chart.setViewPortOffsets(50,0);    // 图3
    chart.setViewPortOffsets(50,50);  // 图4

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

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

• fitScreen() : 重设所有缩放和拖动，使图表完全适合它的边界（完全缩小）。
• @H_430_8@moveViewToX(float xIndeX) : 将当前视口的左侧（边）到指定的 x 值。
  

  

  

chart.setVisible@L_799_3@maximum(3);

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

• @H_430_8@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); // 上面右效果图

• @H_430_8@moveViewTo(float xIndex,float yValue,AxisDependency axis) : 相当于setVisiblexrange(...) 和 setVisibleYRange(...) 组合使用。
• centerViewTo(int xIndex,AxisDependency axis) : 相当于 setVisiblexrange(...) 和 setVisibleYRange(...) 组合使用。

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

四、变焦 （编程）

• 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 = 无放缩 。

五、完整示例

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

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

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