com.freerdp.freerdpcore.presentation.ScrollView2D Class Reference

Inheritance diagram for com.freerdp.freerdpcore.presentation.ScrollView2D:

Collaboration diagram for com.freerdp.freerdpcore.presentation.ScrollView2D:

Data Structures
interface	ScrollView2DListener

Public Member Functions
	ScrollView2D (Context context)
	ScrollView2D (Context context, AttributeSet attrs)
	ScrollView2D (Context context, AttributeSet attrs, int defStyle)
void	setScrollEnabled (boolean enable)
int	getMaxScrollAmountVertical ()
int	getMaxScrollAmountHorizontal ()
void	addView (View child)
void	addView (View child, int index)
void	addView (View child, ViewGroup.LayoutParams params)
void	addView (View child, int index, ViewGroup.LayoutParams params)
boolean	onInterceptTouchEvent (MotionEvent ev)
boolean	onTouchEvent (MotionEvent ev)
boolean	fullScroll (int direction, boolean horizontal)
boolean	arrowScroll (int direction, boolean horizontal)
final void	smoothScrollBy (int dx, int dy)
final void	smoothScrollTo (int x, int y)
void	computeScroll ()
void	requestChildFocus (View child, View focused)
boolean	requestChildRectangleOnScreen (View child, Rect rectangle, boolean immediate)
void	requestLayout ()
void	fling (int velocityX, int velocityY)
void	scrollTo (int x, int y)
void	setScrollViewListener (ScrollView2DListener scrollViewListener)

Protected Member Functions
float	getTopFadingEdgeStrength ()
float	getBottomFadingEdgeStrength ()
float	getLeftFadingEdgeStrength ()
float	getRightFadingEdgeStrength ()
int	computeVerticalScrollRange ()
int	computeHorizontalScrollRange ()
void	measureChild (View child, int parentWidthMeasureSpec, int parentHeightMeasureSpec)
void	measureChildWithMargins (View child, int parentWidthMeasureSpec, int widthUsed, int parentHeightMeasureSpec, int heightUsed)
int	computeScrollDeltaToGetChildRectOnScreen (Rect rect)
boolean	onRequestFocusInDescendants (int direction, Rect previouslyFocusedRect)
void	onLayout (boolean changed, int l, int t, int r, int b)
void	onSizeChanged (int w, int h, int oldw, int oldh)
void	onScrollChanged (int x, int y, int oldx, int oldy)

Detailed Description

Layout container for a view hierarchy that can be scrolled by the user, allowing it to be larger than the physical display. A TwoDScrollView is a FrameLayout, meaning you should place one child in it containing the entire contents to scroll; this child may itself be a layout manager with a complex hierarchy of objects. A child that is often used is a LinearLayout in a vertical orientation, presenting a vertical array of top-level items that the user can scroll through.

The TextView class also takes care of its own scrolling, so does not require a TwoDScrollView, but using the two together is possible to achieve the effect of a text view within a larger container.

Definition at line 58 of file ScrollView2D.java.

Constructor & Destructor Documentation

ScrollView2D() [1/3]

com.freerdp.freerdpcore.presentation.ScrollView2D.ScrollView2D ( Context  context )

inline

Definition at line 106 of file ScrollView2D.java.

  {
    super(context);
    initTwoDScrollView();
  }

ScrollView2D() [2/3]

com.freerdp.freerdpcore.presentation.ScrollView2D.ScrollView2D ( Context  context, AttributeSet  attrs  )

inline

Definition at line 112 of file ScrollView2D.java.

  {
    super(context, attrs);
    initTwoDScrollView();
  }

ScrollView2D() [3/3]

com.freerdp.freerdpcore.presentation.ScrollView2D.ScrollView2D ( Context  context, AttributeSet  attrs, int  defStyle  )

inline

Definition at line 118 of file ScrollView2D.java.

  {
    super(context, attrs, defStyle);
    initTwoDScrollView();
  }

Member Function Documentation

addView() [1/4]

void com.freerdp.freerdpcore.presentation.ScrollView2D.addView ( View  child )

inline

Definition at line 218 of file ScrollView2D.java.

  {
    if (getChildCount() > 0)
    {
      throw new IllegalStateException("TwoDScrollView can host only one direct child");
    }
    super.addView(child);
  }

addView() [2/4]

void com.freerdp.freerdpcore.presentation.ScrollView2D.addView ( View  child, int  index  )

inline

Definition at line 227 of file ScrollView2D.java.

  {
    if (getChildCount() > 0)
    {
      throw new IllegalStateException("TwoDScrollView can host only one direct child");
    }
    super.addView(child, index);
  }

addView() [3/4]

void com.freerdp.freerdpcore.presentation.ScrollView2D.addView ( View  child, int  index, ViewGroup.LayoutParams  params  )

inline

Definition at line 245 of file ScrollView2D.java.

  {
    if (getChildCount() > 0)
    {
      throw new IllegalStateException("TwoDScrollView can host only one direct child");
    }
    super.addView(child, index, params);
  }

addView() [4/4]

void com.freerdp.freerdpcore.presentation.ScrollView2D.addView ( View  child, ViewGroup.LayoutParams  params  )

inline

Definition at line 236 of file ScrollView2D.java.

  {
    if (getChildCount() > 0)
    {
      throw new IllegalStateException("TwoDScrollView can host only one direct child");
    }
    super.addView(child, params);
  }

arrowScroll()

boolean com.freerdp.freerdpcore.presentation.ScrollView2D.arrowScroll ( int  direction, boolean  horizontal  )

inline

Handle scrolling in response to an up or down arrow click.

Parameters

direction

The direction corresponding to the arrow key that was pressed

Returns

True if we consumed the event, false otherwise

Definition at line 707 of file ScrollView2D.java.

  {
    View currentFocused = findFocus();
    if (currentFocused == this)
      currentFocused = null;
    View nextFocused = FocusFinder.getInstance().findNextFocus(this, currentFocused, direction);
    final int maxJump =
        horizontal ? getMaxScrollAmountHorizontal() : getMaxScrollAmountVertical();
 
    if (!horizontal)
    {
      if (nextFocused != null)
      {
        nextFocused.getDrawingRect(mTempRect);
        offsetDescendantRectToMyCoords(nextFocused, mTempRect);
        int scrollDelta = computeScrollDeltaToGetChildRectOnScreen(mTempRect);
        doScroll(0, scrollDelta);
        nextFocused.requestFocus(direction);
      }
      else
      {
        // no new focus
        int scrollDelta = maxJump;
        if (direction == View.FOCUS_UP && getScrollY() < scrollDelta)
        {
          scrollDelta = getScrollY();
        }
        else if (direction == View.FOCUS_DOWN)
        {
          if (getChildCount() > 0)
          {
            int daBottom = getChildAt(0).getBottom();
            int screenBottom = getScrollY() + getHeight();
            if (daBottom - screenBottom < maxJump)
            {
              scrollDelta = daBottom - screenBottom;
            }
          }
        }
        if (scrollDelta == 0)
        {
          return false;
        }
        doScroll(0, direction == View.FOCUS_DOWN ? scrollDelta : -scrollDelta);
      }
    }
    else
    {
      if (nextFocused != null)
      {
        nextFocused.getDrawingRect(mTempRect);
        offsetDescendantRectToMyCoords(nextFocused, mTempRect);
        int scrollDelta = computeScrollDeltaToGetChildRectOnScreen(mTempRect);
        doScroll(scrollDelta, 0);
        nextFocused.requestFocus(direction);
      }
      else
      {
        // no new focus
        int scrollDelta = maxJump;
        if (direction == View.FOCUS_UP && getScrollY() < scrollDelta)
        {
          scrollDelta = getScrollY();
        }
        else if (direction == View.FOCUS_DOWN)
        {
          if (getChildCount() > 0)
          {
            int daBottom = getChildAt(0).getBottom();
            int screenBottom = getScrollY() + getHeight();
            if (daBottom - screenBottom < maxJump)
            {
              scrollDelta = daBottom - screenBottom;
            }
          }
        }
        if (scrollDelta == 0)
        {
          return false;
        }
        doScroll(direction == View.FOCUS_DOWN ? scrollDelta : -scrollDelta, 0);
      }
    }
    return true;
  }

References com.freerdp.freerdpcore.presentation.ScrollView2D.computeScrollDeltaToGetChildRectOnScreen(), and com.freerdp.freerdpcore.presentation.ScrollView2D.getMaxScrollAmountVertical().

Here is the call graph for this function:

computeHorizontalScrollRange()

int com.freerdp.freerdpcore.presentation.ScrollView2D.computeHorizontalScrollRange ( )

inlineprotected

Definition at line 853 of file ScrollView2D.java.

  {
    int count = getChildCount();
    return count == 0 ? getWidth() : (getChildAt(0)).getRight();
  }

computeScroll()

void com.freerdp.freerdpcore.presentation.ScrollView2D.computeScroll ( )

inline

Definition at line 886 of file ScrollView2D.java.

  {
    if (mScroller.computeScrollOffset())
    {
      // This is called at drawing time by ViewGroup.  We don't want to
      // re-show the scrollbars at this point, which scrollTo will do,
      // so we replicate most of scrollTo here.
      //
      //         It's a little odd to call onScrollChanged from inside the drawing.
      //
      //         It is, except when you remember that computeScroll() is used to
      //         animate scrolling. So unless we want to defer the onScrollChanged()
      //         until the end of the animated scrolling, we don't really have a
      //         choice here.
      //
      //         I agree.  The alternative, which I think would be worse, is to post
      //         something and tell the subclasses later.  This is bad because there
      //         will be a window where mScrollX/Y is different from what the app
      //         thinks it is.
      //
      int oldX = getScrollX();
      int oldY = getScrollY();
      int x = mScroller.getCurrX();
      int y = mScroller.getCurrY();
      if (getChildCount() > 0)
      {
        View child = getChildAt(0);
        scrollTo(
            clamp(x, getWidth() - getPaddingRight() - getPaddingLeft(), child.getWidth()),
            clamp(y, getHeight() - getPaddingBottom() - getPaddingTop(),
                  child.getHeight()));
      }
      else
      {
        scrollTo(x, y);
      }
      if (oldX != getScrollX() || oldY != getScrollY())
      {
        onScrollChanged(getScrollX(), getScrollY(), oldX, oldY);
      }
 
      // Keep on drawing until the animation has finished.
      postInvalidate();
    }
  }

computeScrollDeltaToGetChildRectOnScreen()

int com.freerdp.freerdpcore.presentation.ScrollView2D.computeScrollDeltaToGetChildRectOnScreen ( Rect  rect )

inlineprotected

Compute the amount to scroll in the Y direction in order to get a rectangle completely on the screen (or, if taller than the screen, at least the first screen size chunk of it).

Parameters

rect

The rect.

Returns

The scroll delta.

Definition at line 983 of file ScrollView2D.java.

  {
    if (getChildCount() == 0)
      return 0;
    int height = getHeight();
    int screenTop = getScrollY();
    int screenBottom = screenTop + height;
    int fadingEdge = getVerticalFadingEdgeLength();
    // leave room for top fading edge as long as rect isn't at very top
    if (rect.top > 0)
    {
      screenTop += fadingEdge;
    }
 
    // leave room for bottom fading edge as long as rect isn't at very bottom
    if (rect.bottom < getChildAt(0).getHeight())
    {
      screenBottom -= fadingEdge;
    }
    int scrollYDelta = 0;
    if (rect.bottom > screenBottom && rect.top > screenTop)
    {
      // need to move down to get it in view: move down just enough so
      // that the entire rectangle is in view (or at least the first
      // screen size chunk).
      if (rect.height() > height)
      {
        // just enough to get screen size chunk on
        scrollYDelta += (rect.top - screenTop);
      }
      else
      {
        // get entire rect at bottom of screen
        scrollYDelta += (rect.bottom - screenBottom);
      }
 
      // make sure we aren't scrolling beyond the end of our content
      int bottom = getChildAt(0).getBottom();
      int distanceToBottom = bottom - screenBottom;
      scrollYDelta = Math.min(scrollYDelta, distanceToBottom);
    }
    else if (rect.top < screenTop && rect.bottom < screenBottom)
    {
      // need to move up to get it in view: move up just enough so that
      // entire rectangle is in view (or at least the first screen
      // size chunk of it).
 
      if (rect.height() > height)
      {
        // screen size chunk
        scrollYDelta -= (screenBottom - rect.bottom);
      }
      else
      {
        // entire rect at top
        scrollYDelta -= (screenTop - rect.top);
      }
 
      // make sure we aren't scrolling any further than the top our content
      scrollYDelta = Math.max(scrollYDelta, -getScrollY());
    }
    return scrollYDelta;
  }

Referenced by com.freerdp.freerdpcore.presentation.ScrollView2D.arrowScroll().

Here is the caller graph for this function:

computeVerticalScrollRange()

int com.freerdp.freerdpcore.presentation.ScrollView2D.computeVerticalScrollRange ( )

inlineprotected

The scroll range of a scroll view is the overall height of all of its children.

Definition at line 847 of file ScrollView2D.java.

  {
    int count = getChildCount();
    return count == 0 ? getHeight() : (getChildAt(0)).getBottom();
  }

fling()

void com.freerdp.freerdpcore.presentation.ScrollView2D.fling ( int  velocityX, int  velocityY  )

inline

Fling the scroll view

Parameters

velocityY

The initial velocity in the Y direction. Positive numbers mean that the finger/curor is moving down the screen, which means we want to scroll towards the top.

Definition at line 1198 of file ScrollView2D.java.

  {
    if (getChildCount() > 0)
    {
      int height = getHeight() - getPaddingBottom() - getPaddingTop();
      int bottom = getChildAt(0).getHeight();
      int width = getWidth() - getPaddingRight() - getPaddingLeft();
      int right = getChildAt(0).getWidth();
 
      mScroller.fling(getScrollX(), getScrollY(), velocityX, velocityY, 0, right - width, 0,
                      bottom - height);
 
      final boolean movingDown = velocityY > 0;
      final boolean movingRight = velocityX > 0;
 
      View newFocused = findFocusableViewInMyBounds(
          movingRight, mScroller.getFinalX(), movingDown, mScroller.getFinalY(), findFocus());
      if (newFocused == null)
      {
        newFocused = this;
      }
 
      if (newFocused != findFocus() &&
          newFocused.requestFocus(movingDown ? View.FOCUS_DOWN : View.FOCUS_UP))
      {
        mTwoDScrollViewMovedFocus = true;
        mTwoDScrollViewMovedFocus = false;
      }
 
      awakenScrollBars(mScroller.getDuration());
      invalidate();
    }
  }

fullScroll()

boolean com.freerdp.freerdpcore.presentation.ScrollView2D.fullScroll ( int  direction, boolean  horizontal  )

inline

Handles scrolling in response to a "home/end" shortcut press. This method will scroll the view to the top or bottom and give the focus to the topmost/bottommost component in the new visible area. If no component is a good candidate for focus, this scrollview reclaims the focus.

Parameters

direction

the scroll direction: android.view.View#FOCUS_UP to go the top of the view or android.view.View#FOCUS_DOWN to go the bottom

Returns

true if the key event is consumed by this method, false otherwise

Definition at line 611 of file ScrollView2D.java.

  {
    if (!horizontal)
    {
      boolean down = direction == View.FOCUS_DOWN;
      int height = getHeight();
      mTempRect.top = 0;
      mTempRect.bottom = height;
      if (down)
      {
        int count = getChildCount();
        if (count > 0)
        {
          View view = getChildAt(count - 1);
          mTempRect.bottom = view.getBottom();
          mTempRect.top = mTempRect.bottom - height;
        }
      }
      return scrollAndFocus(direction, mTempRect.top, mTempRect.bottom, 0, 0, 0);
    }
    else
    {
      boolean right = direction == View.FOCUS_DOWN;
      int width = getWidth();
      mTempRect.left = 0;
      mTempRect.right = width;
      if (right)
      {
        int count = getChildCount();
        if (count > 0)
        {
          View view = getChildAt(count - 1);
          mTempRect.right = view.getBottom();
          mTempRect.left = mTempRect.right - width;
        }
      }
      return scrollAndFocus(0, 0, 0, direction, mTempRect.top, mTempRect.bottom);
    }
  }

getBottomFadingEdgeStrength()

float com.freerdp.freerdpcore.presentation.ScrollView2D.getBottomFadingEdgeStrength ( )

inlineprotected

Definition at line 138 of file ScrollView2D.java.

  {
    if (getChildCount() == 0)
    {
      return 0.0f;
    }
    final int length = getVerticalFadingEdgeLength();
    final int bottomEdge = getHeight() - getPaddingBottom();
    final int span = getChildAt(0).getBottom() - getScrollY() - bottomEdge;
    if (span < length)
    {
      return span / (float)length;
    }
    return 1.0f;
  }

getLeftFadingEdgeStrength()

float com.freerdp.freerdpcore.presentation.ScrollView2D.getLeftFadingEdgeStrength ( )

inlineprotected

Definition at line 154 of file ScrollView2D.java.

  {
    if (getChildCount() == 0)
    {
      return 0.0f;
    }
    final int length = getHorizontalFadingEdgeLength();
    if (getScrollX() < length)
    {
      return getScrollX() / (float)length;
    }
    return 1.0f;
  }

getMaxScrollAmountHorizontal()

int com.freerdp.freerdpcore.presentation.ScrollView2D.getMaxScrollAmountHorizontal ( )

inline

Definition at line 201 of file ScrollView2D.java.

  {
    return (int)(MAX_SCROLL_FACTOR * getWidth());
  }

getMaxScrollAmountVertical()

int com.freerdp.freerdpcore.presentation.ScrollView2D.getMaxScrollAmountVertical ( )

inline

Returns

The maximum amount this scroll view will scroll in response to an arrow event.

Definition at line 196 of file ScrollView2D.java.

  {
    return (int)(MAX_SCROLL_FACTOR * getHeight());
  }

Referenced by com.freerdp.freerdpcore.presentation.ScrollView2D.arrowScroll().

Here is the caller graph for this function:

getRightFadingEdgeStrength()

float com.freerdp.freerdpcore.presentation.ScrollView2D.getRightFadingEdgeStrength ( )

inlineprotected

Definition at line 168 of file ScrollView2D.java.

  {
    if (getChildCount() == 0)
    {
      return 0.0f;
    }
    final int length = getHorizontalFadingEdgeLength();
    final int rightEdge = getWidth() - getPaddingRight();
    final int span = getChildAt(0).getRight() - getScrollX() - rightEdge;
    if (span < length)
    {
      return span / (float)length;
    }
    return 1.0f;
  }

getTopFadingEdgeStrength()

float com.freerdp.freerdpcore.presentation.ScrollView2D.getTopFadingEdgeStrength ( )

inlineprotected

Definition at line 124 of file ScrollView2D.java.

  {
    if (getChildCount() == 0)
    {
      return 0.0f;
    }
    final int length = getVerticalFadingEdgeLength();
    if (getScrollY() < length)
    {
      return getScrollY() / (float)length;
    }
    return 1.0f;
  }

measureChild()

void com.freerdp.freerdpcore.presentation.ScrollView2D.measureChild ( View  child, int  parentWidthMeasureSpec, int  parentHeightMeasureSpec  )

inlineprotected

Definition at line 860 of file ScrollView2D.java.

  {
    ViewGroup.LayoutParams lp = child.getLayoutParams();
    int childWidthMeasureSpec;
    int childHeightMeasureSpec;
 
    childWidthMeasureSpec = getChildMeasureSpec(parentWidthMeasureSpec,
                                                getPaddingLeft() + getPaddingRight(), lp.width);
    childHeightMeasureSpec = MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED);
 
    child.measure(childWidthMeasureSpec, childHeightMeasureSpec);
  }

measureChildWithMargins()

void com.freerdp.freerdpcore.presentation.ScrollView2D.measureChildWithMargins ( View  child, int  parentWidthMeasureSpec, int  widthUsed, int  parentHeightMeasureSpec, int  heightUsed  )

inlineprotected

Definition at line 874 of file ScrollView2D.java.

  {
    final MarginLayoutParams lp = (MarginLayoutParams)child.getLayoutParams();
    final int childWidthMeasureSpec =
        MeasureSpec.makeMeasureSpec(lp.leftMargin + lp.rightMargin, MeasureSpec.UNSPECIFIED);
    final int childHeightMeasureSpec =
        MeasureSpec.makeMeasureSpec(lp.topMargin + lp.bottomMargin, MeasureSpec.UNSPECIFIED);
 
    child.measure(childWidthMeasureSpec, childHeightMeasureSpec);
  }

onInterceptTouchEvent()

boolean com.freerdp.freerdpcore.presentation.ScrollView2D.onInterceptTouchEvent ( MotionEvent  ev )

inline

Definition at line 272 of file ScrollView2D.java.

  {
    /*
     * This method JUST determines whether we want to intercept the motion.
     * If we return true, onMotionEvent will be called and we do the actual
     * scrolling there.
     *
     * Shortcut the most recurring case: the user is in the dragging
     * state and he is moving his finger.  We want to intercept this
     * motion.
     */
    // Let child handle touchpad scroll gestures.
    if (ev.getClassification() == MotionEvent.CLASSIFICATION_TWO_FINGER_SWIPE)
    {
      mIsBeingDragged = false;
      return false;
    }
 
    final int action = ev.getAction();
    if ((action == MotionEvent.ACTION_MOVE) && (mIsBeingDragged))
    {
      return true;
    }
    if (!canScroll())
    {
      mIsBeingDragged = false;
      return false;
    }
    final float y = ev.getY();
    final float x = ev.getX();
    switch (action)
    {
      case MotionEvent.ACTION_MOVE:
        /*
         * mIsBeingDragged == false, otherwise the shortcut would have caught it. Check
         * whether the user has moved far enough from his original down touch.
         */
        /*
         * Locally do absolute value. mLastMotionY is set to the y value
         * of the down event.
         */
        final int yDiff = (int)Math.abs(y - mLastMotionY);
        final int xDiff = (int)Math.abs(x - mLastMotionX);
        if (yDiff > mTouchSlop || xDiff > mTouchSlop)
        {
          mIsBeingDragged = true;
        }
        break;
 
      case MotionEvent.ACTION_DOWN:
        /* Remember location of down touch */
        mLastMotionY = y;
        mLastMotionX = x;
 
        /*
         * If being flinged and user touches the screen, initiate drag;
         * otherwise don't.  mScroller.isFinished should be false when
         * being flinged.
         */
        mIsBeingDragged = !mScroller.isFinished();
        break;
 
      case MotionEvent.ACTION_CANCEL:
      case MotionEvent.ACTION_UP:
        /* Release the drag */
        mIsBeingDragged = false;
        break;
    }
 
    /*
     * The only time we want to intercept motion events is if we are in the
     * drag mode.
     */
    return mIsBeingDragged;
  }

onLayout()

void com.freerdp.freerdpcore.presentation.ScrollView2D.onLayout ( boolean  changed, int  l, int  t, int  r, int  b  )

inlineprotected

Definition at line 1115 of file ScrollView2D.java.

  {
    super.onLayout(changed, l, t, r, b);
    mIsLayoutDirty = false;
    // Give a child focus if it needs it
    if (mChildToScrollTo != null && isViewDescendantOf(mChildToScrollTo, this))
    {
      scrollToChild(mChildToScrollTo);
    }
    mChildToScrollTo = null;
 
    // Center the content area (excluding touch-pointer padding) within the viewport.
    // This keeps the RDP surface visually centered regardless of pointer padding changes.
    if (getChildCount() > 0)
    {
      View child = getChildAt(0);
      SessionView sv = findViewById(R.id.sessionView);
      int ptw = sv != null ? sv.getTouchPointerPaddingWidth() : 0;
      int pth = sv != null ? sv.getTouchPointerPaddingHeight() : 0;
      int contentW = child.getMeasuredWidth() - ptw;
      int contentH = child.getMeasuredHeight() - pth;
      int usableW = getWidth() - getPaddingLeft() - getPaddingRight();
      int usableH = getHeight() - getPaddingTop() - getPaddingBottom();
      int left = getPaddingLeft() + Math.max(0, (usableW - contentW) / 2);
      int top;
      if (contentH == lastCenterContentH)
      {
        // viewport-only change (e.g. keyboard): keep position, don't re-center
        top = lastCenterTop;
      }
      else
      {
        top = getPaddingTop() + Math.max(0, (usableH - contentH) / 2);
        lastCenterContentH = contentH;
        lastCenterTop = top;
      }
      child.layout(left, top, left + child.getMeasuredWidth(),
                   top + child.getMeasuredHeight());
    }
 
    // Calling this with the present values causes it to re-clamp them
    scrollTo(getScrollX(), getScrollY());
  }

onRequestFocusInDescendants()

boolean com.freerdp.freerdpcore.presentation.ScrollView2D.onRequestFocusInDescendants ( int  direction, Rect  previouslyFocusedRect  )

inlineprotected

When looking for focus in children of a scroll view, need to be a little more careful not to give focus to something that is scrolled off screen.

This is more expensive than the default android.view.ViewGroup implementation, otherwise this behavior might have been made the default.

Definition at line 1072 of file ScrollView2D.java.

  {
    // convert from forward / backward notation to up / down / left / right
    // (ugh).
    if (direction == View.FOCUS_FORWARD)
    {
      direction = View.FOCUS_DOWN;
    }
    else if (direction == View.FOCUS_BACKWARD)
    {
      direction = View.FOCUS_UP;
    }
 
    final View nextFocus = previouslyFocusedRect == null
                               ? FocusFinder.getInstance().findNextFocus(this, null, direction)
                               : FocusFinder.getInstance().findNextFocusFromRect(
                                     this, previouslyFocusedRect, direction);
 
    if (nextFocus == null)
    {
      return false;
    }
 
    return nextFocus.requestFocus(direction, previouslyFocusedRect);
  }

onScrollChanged()

void com.freerdp.freerdpcore.presentation.ScrollView2D.onScrollChanged ( int  x, int  y, int  oldx, int  oldy  )

inlineprotected

Definition at line 1290 of file ScrollView2D.java.

  {
    super.onScrollChanged(x, y, oldx, oldy);
    if (scrollView2DListener != null)
    {
      scrollView2DListener.onScrollChanged(this, x, y, oldx, oldy);
    }
  }

onSizeChanged()

void com.freerdp.freerdpcore.presentation.ScrollView2D.onSizeChanged ( int  w, int  h, int  oldw, int  oldh  )

inlineprotected

Definition at line 1159 of file ScrollView2D.java.

  {
    super.onSizeChanged(w, h, oldw, oldh);
 
    View currentFocused = findFocus();
    if (null == currentFocused || this == currentFocused)
      return;
 
    // If the currently-focused view was visible on the screen when the
    // screen was at the old height, then scroll the screen to make that
    // view visible with the new screen height.
    currentFocused.getDrawingRect(mTempRect);
    offsetDescendantRectToMyCoords(currentFocused, mTempRect);
    int scrollDeltaX = computeScrollDeltaToGetChildRectOnScreen(mTempRect);
    int scrollDeltaY = computeScrollDeltaToGetChildRectOnScreen(mTempRect);
    doScroll(scrollDeltaX, scrollDeltaY);
  }

onTouchEvent()

boolean com.freerdp.freerdpcore.presentation.ScrollView2D.onTouchEvent ( MotionEvent  ev )

inline

Definition at line 348 of file ScrollView2D.java.

  {
 
    if (ev.getAction() == MotionEvent.ACTION_DOWN && ev.getEdgeFlags() != 0)
    {
      // Don't handle edge touches immediately -- they may actually belong to one of our
      // descendants.
      return false;
    }
 
    if (!canScroll())
    {
      return false;
    }
 
    if (mVelocityTracker == null)
    {
      mVelocityTracker = VelocityTracker.obtain();
    }
    mVelocityTracker.addMovement(ev);
 
    final int action = ev.getAction();
    final float y = ev.getY();
    final float x = ev.getX();
 
    switch (action)
    {
      case MotionEvent.ACTION_DOWN:
        /*
         * If being flinged and user touches, stop the fling. isFinished
         * will be false if being flinged.
         */
        if (!mScroller.isFinished())
        {
          mScroller.abortAnimation();
        }
 
        // Remember where the motion event started
        mLastMotionY = y;
        mLastMotionX = x;
        break;
      case MotionEvent.ACTION_MOVE:
        // Scroll to follow the motion event
        int deltaX = (int)(mLastMotionX - x);
        int deltaY = (int)(mLastMotionY - y);
        mLastMotionX = x;
        mLastMotionY = y;
 
        if (deltaX < 0)
        {
          if (getScrollX() < 0)
          {
            deltaX = 0;
          }
        }
        else if (deltaX > 0)
        {
          final int rightEdge = getWidth() - getPaddingRight();
          final int availableToScroll =
              getChildAt(0).getRight() - getScrollX() - rightEdge;
          if (availableToScroll > 0)
          {
            deltaX = Math.min(availableToScroll, deltaX);
          }
          else
          {
            deltaX = 0;
          }
        }
        if (deltaY < 0)
        {
          if (getScrollY() < 0)
          {
            deltaY = 0;
          }
        }
        else if (deltaY > 0)
        {
          final int bottomEdge = getHeight() - getPaddingBottom();
          final int availableToScroll =
              getChildAt(0).getBottom() - getScrollY() - bottomEdge;
          if (availableToScroll > 0)
          {
            deltaY = Math.min(availableToScroll, deltaY);
          }
          else
          {
            deltaY = 0;
          }
        }
        if (deltaY != 0 || deltaX != 0)
          scrollBy(deltaX, deltaY);
        break;
      case MotionEvent.ACTION_UP:
        final VelocityTracker velocityTracker = mVelocityTracker;
        velocityTracker.computeCurrentVelocity(1000, mMaximumVelocity);
        int initialXVelocity = (int)velocityTracker.getXVelocity();
        int initialYVelocity = (int)velocityTracker.getYVelocity();
        if ((Math.abs(initialXVelocity) + Math.abs(initialYVelocity) > mMinimumVelocity) &&
            getChildCount() > 0)
        {
          fling(-initialXVelocity, -initialYVelocity);
        }
        if (mVelocityTracker != null)
        {
          mVelocityTracker.recycle();
          mVelocityTracker = null;
        }
    }
    return true;
  }

requestChildFocus()

void com.freerdp.freerdpcore.presentation.ScrollView2D.requestChildFocus ( View  child, View  focused  )

inline

Definition at line 1047 of file ScrollView2D.java.

  {
    if (!mTwoDScrollViewMovedFocus)
    {
      if (!mIsLayoutDirty)
      {
        scrollToChild(focused);
      }
      else
      {
        // The child may not be laid out yet, we can't compute the scroll yet
        mChildToScrollTo = focused;
      }
    }
    super.requestChildFocus(child, focused);
  }

requestChildRectangleOnScreen()

boolean com.freerdp.freerdpcore.presentation.ScrollView2D.requestChildRectangleOnScreen ( View  child, Rect  rectangle, boolean  immediate  )

inline

Definition at line 1099 of file ScrollView2D.java.

  {
    // offset into coordinate space of this scroll view
    rectangle.offset(child.getLeft() - child.getScrollX(), child.getTop() - child.getScrollY());
    return scrollToChildRect(rectangle, immediate);
  }

requestLayout()

void com.freerdp.freerdpcore.presentation.ScrollView2D.requestLayout ( )

inline

Definition at line 1106 of file ScrollView2D.java.

  {
    mIsLayoutDirty = true;
    super.requestLayout();
  }

scrollTo()

void com.freerdp.freerdpcore.presentation.ScrollView2D.scrollTo ( int  x, int  y  )

inline

This version also clamps the scrolling to the bounds of our child.

Definition at line 1237 of file ScrollView2D.java.

  {
    // we rely on the fact the View.scrollBy calls scrollTo.
    if (getChildCount() > 0)
    {
      View child = getChildAt(0);
      x = clamp(x, getWidth() - getPaddingRight() - getPaddingLeft(), child.getWidth());
      y = clamp(y, getHeight() - getPaddingBottom() - getPaddingTop(), child.getHeight());
      if (x != getScrollX() || y != getScrollY())
      {
        super.scrollTo(x, y);
      }
    }
  }

setScrollEnabled()

void com.freerdp.freerdpcore.presentation.ScrollView2D.setScrollEnabled ( boolean  enable )

inline

Disable/Enable scrolling

Definition at line 187 of file ScrollView2D.java.

  {
    scrollEnabled = enable;
  }

setScrollViewListener()

void com.freerdp.freerdpcore.presentation.ScrollView2D.setScrollViewListener ( ScrollView2DListener  scrollViewListener )

inline

Definition at line 1285 of file ScrollView2D.java.

  {
    this.scrollView2DListener = scrollViewListener;
  }

smoothScrollBy()

final void com.freerdp.freerdpcore.presentation.ScrollView2D.smoothScrollBy ( int  dx, int  dy  )

inline

Like View#scrollBy, but scroll smoothly instead of immediately.

Parameters

dx	the number of pixels to scroll by on the X axis
dy	the number of pixels to scroll by on the Y axis

Definition at line 812 of file ScrollView2D.java.

  {
    long duration = AnimationUtils.currentAnimationTimeMillis() - mLastScroll;
    if (duration > ANIMATED_SCROLL_GAP)
    {
      mScroller.startScroll(getScrollX(), getScrollY(), dx, dy);
      awakenScrollBars(mScroller.getDuration());
      invalidate();
    }
    else
    {
      if (!mScroller.isFinished())
      {
        mScroller.abortAnimation();
      }
      scrollBy(dx, dy);
    }
    mLastScroll = AnimationUtils.currentAnimationTimeMillis();
  }

Referenced by com.freerdp.freerdpcore.presentation.ScrollView2D.smoothScrollTo().

Here is the caller graph for this function:

smoothScrollTo()

final void com.freerdp.freerdpcore.presentation.ScrollView2D.smoothScrollTo ( int  x, int  y  )

inline

Like scrollTo, but scroll smoothly instead of immediately.

Parameters

x	the position where to scroll on the X axis
y	the position where to scroll on the Y axis

Definition at line 838 of file ScrollView2D.java.

  {
    smoothScrollBy(x - getScrollX(), y - getScrollY());
  }

References com.freerdp.freerdpcore.presentation.ScrollView2D.smoothScrollBy().

Here is the call graph for this function:

---

The documentation for this class was generated from the following file:

• ScrollView2D.java