android项目源码解析03——vudroid阅读器源码解析03:文件内容显示

本文要讲的是，vudroid阅读器选择某个文件后，如何展示该文件的内容。

这里不涉及vudroid是如何读取文件内容的，只是涉及读取到文件内容后，如何展示这些内容。

这里涉及到三个类：DocumentView，Page，PageTreeNode。

DocumentView我们可以认为是一个显示容器，它里面存放的内容是一个个的页（Page），而每个页是由若干个PageTreeNode组成的。

因此，我们可以看到，DocumentView只是负责处理触摸屏时间、按钮时间、滚动事件，当然这里还涉及到放大缩小这个功能的处理；而Page是包括一页的内容，包括页边界、文本内容等；PageTreeNode中存放的才是真正的文本内容。

1、DocumentView

这里要做的内容包括按键处理、触摸屏事件处理（支持多点触摸）、放大缩小功能处理、scroll事件处理：

1）按键事件处理，这里你按上下左右键，页面内容是可以上下左右移动的。

@Override public boolean dispatchKeyEvent(KeyEvent event) { if (event.getAction() == KeyEvent.ACTION_DOWN) { switch (event.getKeyCode()) { case KeyEvent.KEYCODE_DPAD_RIGHT: lineByLineMoveTo(1); return true; case KeyEvent.KEYCODE_DPAD_LEFT: lineByLineMoveTo(-1); return true; case KeyEvent.KEYCODE_DPAD_DOWN: verticalDpadScroll(1); return true; case KeyEvent.KEYCODE_DPAD_UP: verticalDpadScroll(-1); return true; } } return super.dispatchKeyEvent(event); }2）触摸屏事件处理（这里由于引入了多点触摸的库，因此是支持多点触摸的）

第一段代码时倒入多点触摸的库

private void initMultiTouchZoomIfAvailable(ZoomModel zoomModel) { try { multiTouchZoom = (MultiTouchZoom) Class.forName("org.vudroid.core.multitouch.MultiTouchZoomImpl").getConstructor(ZoomModel.class).newInstance(zoomModel); } catch (Exception e) { System.out.println("Multi touch zoom is not available: " + e); } }第二段代码是处理触摸屏事件

@Override public boolean onTouchEvent(MotionEvent ev) { super.onTouchEvent(ev); if (multiTouchZoom != null) { if (multiTouchZoom.onTouchEvent(ev)) { return true; } if (multiTouchZoom.isResetLastPointAfterZoom()) { setLastPosition(ev); multiTouchZoom.setResetLastPointAfterZoom(false); } } if (velocityTracker == null) { velocityTracker = VelocityTracker.obtain(); } velocityTracker.addMovement(ev); switch (ev.getAction()) { case MotionEvent.ACTION_DOWN: stopScroller(); setLastPosition(ev); if (ev.getEventTime() - lastDownEventTime < DOUBLE_TAP_TIME) { zoomModel.toggleZoomControls(); } else { lastDownEventTime = ev.getEventTime(); } break; case MotionEvent.ACTION_MOVE: scrollBy((int) (lastX - ev.getX()), (int) (lastY - ev.getY())); setLastPosition(ev); break; case MotionEvent.ACTION_UP: velocityTracker.computeCurrentVelocity(1000); scroller.fling(getScrollX(), getScrollY(), (int) -velocityTracker.getXVelocity(), (int) -velocityTracker.getYVelocity(), getLeftLimit(), getRightLimit(), getTopLimit(), getBottomLimit()); velocityTracker.recycle(); velocityTracker = null; break; } return true; } 这段代码中，首先是让多点触摸的处理类处理事件，如果该事件在这里不被处理，则按普通触摸屏事件（区别于多点触摸）处理。

3）、缩放功能处理

public void zoomChanged(float newZoom, float oldZoom) { inZoom = true; stopScroller(); final float ratio = newZoom / oldZoom; invalidatePageSizes(); scrollTo((int) ((getScrollX() + getWidth() / 2) * ratio - getWidth() / 2), (int) ((getScrollY() + getHeight() / 2) * ratio - getHeight() / 2)); postInvalidate(); }这个应该是由ZoomListener触发的事件，具体可以研究下ZoomListener的代码。

4）scroll事件处理

只要调用了scrollTo和scrollBy都会触发onScrollChanged函数。该函数的代码是所有DocumentView事件的基础，因为其他事件最终都会调用这一个代码。

@Override protected void onScrollChanged(int l, int t, int oldl, int oldt) { super.onScrollChanged(l, t, oldl, oldt); // bounds could be not updated post(new Runnable() { public void run() { currentPageModel.setCurrentPageIndex(getCurrentPage()); } }); if (inZoom) { return; } // on scrollChanged can be called from scrollTo just after new layout applied so we should wait for relayout post(new Runnable() { public void run() { updatePageVisibility(); } }); } 这里我们看到，DocumentView中要改变显示内容的话，最终都是通过更改每个Page的显示来实现的。读这一段代码的时候要注意以下这段函数：

void invalidatePageSizes() { if (!isInitialized) { return; } float heightAccum = 0; int width = getWidth(); float zoom = zoomModel.getZoom(); for (int i = 0; i < pages.size(); i++) { Page page = pages.get(i); float pageHeight = page.getPageHeight(width, zoom); page.setBounds(new RectF(0, heightAccum, width * zoom, heightAccum + pageHeight)); heightAccum += pageHeight; } } 这一端代码定义每一页的大小。根据PageTreeNode中的代码判断，这一部分显示是这样的，pages中的内容，我们可以看作是一页页首尾连在一起的卷轴，DocumentView相当于一个放大镜，这个放大镜放到什么地方，就显示什么内容。

2、page

说实在的，我没有搞清楚有了page以后，让page来显示内容就可以了，为什么要加一个PageTreeNode类？

page类的功能实际上很直白：显示一页内容的上下分界线，滑动到某页时在其中间显示当前页数（这个黑体页数值会被PageTreeNode的内容覆盖，可以认为是文件内容没有显示之前，先显示一个页数值）。

3、PageTreeNode

PageTreeNode类是用来显示文件内容的，就是你在屏幕上看得到的实实在在的阅读内容。

从以下函数知道PageTreeNode中的内容在PageTreeNode的方框与documentView的方框有交集时可以显示。

private boolean isVisible() { return RectF.intersects(documentView.getViewRect(), getTargetRectF()); } 但是我没弄明白pageSliceBounds、children、thresholdHit()等等这些成员是拿来做什么的。从DecodeServiceBase的代码中可以看出pageSliceBounds与读取具体某种格式的文件（如pdf文件）有关系，但其具体在什么地方有用，也只有等阅读以下读取pdf的那些代码才能搞明白了。