android 中文 api (64) —— Scroller

简介:

一、结构

    public class Scroller extends Object

    java.lang.Object

    android.widget.Scroller

二、概述

    这个类封装了滚动操作。滚动的持续时间可以通过构造函数传递,并且可以指定滚动动作的持续的最长时间。经过这段时间,滚动会自动定位到最终位置,并且通过computeScrollOffset()会得到的返回值为false,表明滚动动作已经结束。

三、构造函数

  public Scroller (Context context)

  使用缺省的持续持续时间和动画插入器创建一个Scroller。(译者注:interpolator这里翻译为动画插入器,见这里。)

  public Scroller (Context context, Interpolator interpolator)

  根据指定的动画插入器创建一个Scroller,如果指定的动画插入器为空,则会使用缺省的动画插入器(粘滞viscous)创建。

四、公共方法

  public void abortAnimation ()

  停止动画。与forceFinished(boolean)相反,Scroller滚动到最终xy位置时中止动画。

  参见

        forceFinished(boolean)

  public boolean computeScrollOffset ()

  当想要知道新的位置时,调用此函数。如果返回true,表示动画还没有结束。位置改变以提供一个新的位置。

  public void extendDuration (int extend)

  延长滚动动画时间。此函数允许当使用setFinalX(int) or setFinalY(int) 时,卷动动作持续更长时间并且卷动更长距离。

          参数

              extend 卷动事件延长的时间,以毫秒为单位

          参见

              setFinalX(int)

              setFinalY(int)

  public void fling (int startX, int startY, int velocityX, int velocityY, int minX, int maxX, int minY, int maxY)

  在fling(译者注:快滑,用户按下触摸屏、快速移动后松开)手势基础上开始滚动。滚动的距离取决于fling的初速度。

      参数

          startX 滚动起始点X坐标

  startY 滚动起始点Y坐标

  velocityX   当滑动屏幕时X方向初速度,以每秒像素数计算

  velocityY   当滑动屏幕时Y方向初速度,以每秒像素数计算

  minX    X方向的最小值,scroller不会滚过此点。

  maxX    X方向的最大值,scroller不会滚过此点。

  minY    Y方向的最小值,scroller不会滚过此点。

  maxY    Y方向的最大值,scroller不会滚过此点。

  public final void forceFinished (boolean finished)

  强制终止的字段到特定值。(译者注:立即停止滚动?)

      参数

          finished    新的结束值

  public final int getCurrX ()

  返回当前滚动X方向的偏移

      返回值

          距离原点X方向的绝对值

  public final int getCurrY ()

  返回当前滚动Y方向的偏移

      返回值

          距离原点Y方向的绝对值

  public final int getDuration ()

  返回滚动事件的持续时间,以毫秒计算。

      返回值

          滚动持续的毫秒数

  public final int getFinalX ()

  返回滚动结束位置。仅针对“fling”手势有效

      返回值

          最终位置X方向距离原点的绝对距离

  public final int getFinalY ()

  返回滚动结束位置。仅针对“fling”操作有效

      返回值

          最终位置Y方向距离原点的绝对距离

  public final int getStartX ()

  返回滚动起始点的X方向的偏移

      返回值

          起始点在X方向距离原点的绝对距离

  public final int getStartY ()

  返回滚动起始点的Y方向的偏移

      返回值

          起始点在Y方向距离原点的绝对距离

  public final boolean isFinished ()

  返回scroller是否已完成滚动。

      返回值

          停止滚动返回true,否则返回false

  public void setFinalX (int newX)

  设置scroller的X方向终止位置

      参数

          newX    新位置在X方向距离原点的绝对偏移。

      参见

          extendDuration(int)

          setFinalY(int)

  public void setFinalY (int newY)

  设置scroller的Y方向终止位置

      参数

          newY    新位置在Y方向距离原点的绝对偏移。

      参见

          extendDuration(int)

          setFinalY(int)

  public void startScroll (int startX, int startY, int dx, int dy)

  以提供的起始点和将要滑动的距离开始滚动。滚动会使用缺省值250ms作为持续时间。

      参数

          startX 水平方向滚动的偏移值,以像素为单位。正值表明滚动将向左滚动

  startY 垂直方向滚动的偏移值,以像素为单位。正值表明滚动将向上滚动

  dx 水平方向滑动的距离,正值会使滚动向左滚动

  dy 垂直方向滑动的距离,正值会使滚动向上滚动

  public void startScroll (int startX, int startY, int dx, int dy, int duration)

  以提供的起始点和将要滑动的距离开始滚动。

      参数

          startX 水平方向滚动的偏移值,以像素为单位。正值表明滚动将向左滚动

  startY 垂直方向滚动的偏移值,以像素为单位。正值表明滚动将向上滚动

  dx 水平方向滑动的距离,正值会使滚动向左滚动

  dy 垂直方向滑动的距离,正值会使滚动向上滚动

        duration    滚动持续时间,以毫秒计。

  public int timePassed ()

  返回自滚动开始经过的时间

      返回值

             经过时间以毫秒为单位

五、补充

    文章精选

      Scroller 粗浅理解

      ScrollTextView - scrolling TextView for Android

    示例代码

      创建工程MyScroler,或者将下类名“MyScroler”改为自己创建的工程,将下面代码直接覆盖生成的.java文件运行即可:

package  my.Scroller;
import  android.app.Activity;
import  android.os.Bundle;
import  android.view.View;
import  android.view.View.OnClickListener;
import  android.widget.Button;
import  android.widget.LinearLayout;
import  android.widget.Scroller;

public   class  MyScroler  extends  Activity {
    
/**  Called when the activity is first created.  */
    LinearLayout lay1,lay2,lay;
     
private  Scroller mScroller;
     
private   boolean  s1,s2;
    @Override
    
public   void  onCreate(Bundle savedInstanceState) {
        
super .onCreate(savedInstanceState);
        mScroller 
=   new  Scroller( this );
         lay1 
=   new  LinearLayout( this ){
             @Override 
             
public   void  computeScroll() { 
                 
if  (mScroller.computeScrollOffset()) { 
                     scrollTo(mScroller.getCurrX(), 
0 ); 
                     postInvalidate(); 
                 } 
             } 
         };
         lay2 
=   new  LinearLayout( this ){
             @Override 
             
public   void  computeScroll() { 
                 
if  (mScroller.computeScrollOffset()) { 
                    
//  mScrollX = mScroller.getCurrX(); 
                     scrollTo(mScroller.getCurrX(),  0 ); 
                     postInvalidate(); 
                 } 
             } 
         };
      lay1.setBackgroundColor(
this .getResources().getColor(android.R.color.darker_gray));
        lay2.setBackgroundColor(
this .getResources().getColor(android.R.color.white));
        lay 
=   new  LinearLayout( this );
        lay.setOrientation(LinearLayout.VERTICAL);
        LinearLayout.LayoutParams p0 
=   new  LinearLayout.LayoutParams(LinearLayout.LayoutParams.FILL_PARENT,LinearLayout.LayoutParams.FILL_PARENT);     
        
this .setContentView(lay, p0);
        
        LinearLayout.LayoutParams p1 
=   new  LinearLayout.LayoutParams(LinearLayout.LayoutParams.FILL_PARENT,LinearLayout.LayoutParams.FILL_PARENT);     
        p1.weight
= 1 ;
        lay.addView(lay1,p1);
        LinearLayout.LayoutParams p2 
=   new  LinearLayout.LayoutParams(LinearLayout.LayoutParams.FILL_PARENT,LinearLayout.LayoutParams.FILL_PARENT);     
        p2.weight
= 1 ;
        lay.addView(lay2,p2);
        Button tx 
=   new  Button( this );
        Button tx2 
=   new  Button( this );
        tx.setText(
" Button1 " );  
        tx2.setText(
" Button2 " );
        tx.setOnClickListener(
new  OnClickListener(){
            @Override
            
public   void  onClick(View v) {
                
if ( ! s1){
                    mScroller.startScroll(
0 0 5 10 10 );
                    s1 
=   true ;
                }
else {
                    mScroller.startScroll(
0 0 - 50 - 10 , 10 );
                    s1 
=   false ;
                }
            }
            
        });
        tx2.setOnClickListener(
new  OnClickListener(){
            @Override
            
public   void  onClick(View v) {
                
if ( ! s2){
                    mScroller.startScroll(
0 0 5 20 , 10 );
                    s2
= true ;
                }
else {
                    mScroller.startScroll(
20 20 - 50 - 20 , 10 );
                    s2
= false ;
                }
            }
        });
        lay1.addView(tx);
        lay2.addView(tx2);
    }
}

本文转自博客园农民伯伯的博客,原文链接:android 中文 api (64) —— Scroller,如需转载请自行联系原博主。


目录
相关文章
|
Android开发
Android 11 修改libcore update-api 遇到的问题
Android 11 修改libcore update-api 遇到的问题
652 1
|
11月前
|
存储 机器学习/深度学习 API
Android API Level 到底是什么?和安卓什么关系?应用发布如何知道自己的版本?优雅草卓伊凡
Android API Level 到底是什么?和安卓什么关系?应用发布如何知道自己的版本?优雅草卓伊凡
1671 31
Android API Level 到底是什么?和安卓什么关系?应用发布如何知道自己的版本?优雅草卓伊凡
|
编译器 API Android开发
Android经典实战之Kotlin Multiplatform 中,如何处理不同平台的 API 调用
本文介绍Kotlin Multiplatform (KMP) 中使用 `expect` 和 `actual` 关键字处理多平台API调用的方法。通过共通代码集定义预期API,各平台提供具体实现,编译器确保正确匹配,支持依赖注入、枚举类处理等,实现跨平台代码重用与原生性能。附带示例展示如何定义跨平台函数与类。
771 0
|
Android开发 UED
Android采用Scroller实现底部二楼效果
Android采用Scroller实现底部二楼效果
302 0
Android采用Scroller实现底部二楼效果
|
API Android开发 开发者
`RecyclerView`是Android API 21引入的UI组件,用于替代ListView和GridView
【6月更文挑战第26天】`RecyclerView`是Android API 21引入的UI组件,用于替代ListView和GridView。它提供高效的数据视图复用,优化的布局管理,支持多种布局(如线性、网格),并解耦数据、适配器和视图。RecyclerView的灵活性、性能(如局部刷新和动画支持)和扩展性使其成为现代Android开发的首选,特别是在处理大规模数据集时。
569 2
|
SQL API Android开发
Android API:Activity.managedQuery()
Android API:Activity.managedQuery()
245 2
|
API Android开发
Android Framework增加API 报错 Missing nullability on parameter
Android Framework增加API 报错 Missing nullability on parameter
898 1
|
Java Linux API
微信API:探究Android平台下Hook技术的比较与应用场景分析
微信API:探究Android平台下Hook技术的比较与应用场景分析
|
API 定位技术 开发工具
Android Studio2021.1.1 高德地图api调用这一篇就够了
Android Studio2021.1.1 高德地图api调用这一篇就够了

热门文章

最新文章