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);
    }
}


本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582535,如需转载请自行联系原作者
相关文章
|
3天前
|
Linux 编译器 Android开发
FFmpeg开发笔记(九)Linux交叉编译Android的x265库
在Linux环境下,本文指导如何交叉编译x265的so库以适应Android。首先,需安装cmake和下载android-ndk-r21e。接着,下载x265源码,修改crosscompile.cmake的编译器设置。配置x265源码,使用指定的NDK路径,并在配置界面修改相关选项。随后,修改编译规则,编译并安装x265,调整pc描述文件并更新PKG_CONFIG_PATH。最后,修改FFmpeg配置脚本启用x265支持,编译安装FFmpeg,将生成的so文件导入Android工程,调整gradle配置以确保顺利运行。
23 1
FFmpeg开发笔记(九)Linux交叉编译Android的x265库
|
25天前
|
Java Android开发
Android 开发获取通知栏权限时会出现两个应用图标
Android 开发获取通知栏权限时会出现两个应用图标
12 0
|
1月前
|
XML 缓存 Android开发
Android开发,使用kotlin学习多媒体功能(详细)
Android开发,使用kotlin学习多媒体功能(详细)
101 0
|
1月前
|
设计模式 人工智能 开发工具
安卓应用开发:构建未来移动体验
【2月更文挑战第17天】 随着智能手机的普及和移动互联网技术的不断进步,安卓应用开发已成为一个热门领域。本文将深入探讨安卓平台的应用开发流程、关键技术以及未来发展趋势。通过分析安卓系统的架构、开发工具和框架,本文旨在为开发者提供全面的技术指导,帮助他们构建高效、创新的移动应用,以满足不断变化的市场需求。
18 1
|
1月前
|
机器学习/深度学习 调度 Android开发
安卓应用开发:打造高效通知管理系统
【2月更文挑战第14天】 在移动操作系统中,通知管理是影响用户体验的关键因素之一。本文将探讨如何在安卓平台上构建一个高效的通知管理系统,包括服务、频道和通知的优化策略。我们将讨论最新的安卓开发工具和技术,以及如何通过这些工具提高通知的可见性和用户互动性,同时确保不会对用户造成干扰。
33 1
|
16天前
|
XML 开发工具 Android开发
构建高效的安卓应用:使用Jetpack Compose优化UI开发
【4月更文挑战第7天】 随着Android开发不断进化,开发者面临着提高应用性能与简化UI构建流程的双重挑战。本文将探讨如何使用Jetpack Compose这一现代UI工具包来优化安卓应用的开发流程,并提升用户界面的流畅性与一致性。通过介绍Jetpack Compose的核心概念、与传统方法的区别以及实际集成步骤,我们旨在提供一种高效且可靠的解决方案,以帮助开发者构建响应迅速且用户体验优良的安卓应用。
|
19天前
|
监控 算法 Android开发
安卓应用开发:打造高效启动流程
【4月更文挑战第5天】 在移动应用的世界中,用户的第一印象至关重要。特别是对于安卓应用而言,启动时间是用户体验的关键指标之一。本文将深入探讨如何优化安卓应用的启动流程,从而减少启动时间,提升用户满意度。我们将从分析应用启动流程的各个阶段入手,提出一系列实用的技术策略,包括代码层面的优化、资源加载的管理以及异步初始化等,帮助开发者构建快速响应的安卓应用。
|
19天前
|
Java Android开发
Android开发之使用OpenGL实现翻书动画
本文讲述了如何使用OpenGL实现更平滑、逼真的电子书翻页动画,以解决传统贝塞尔曲线方法存在的卡顿和阴影问题。作者分享了一个改造后的外国代码示例,提供了从前往后和从后往前的翻页效果动图。文章附带了`GlTurnActivity`的Java代码片段,展示如何加载和显示书籍图片。完整工程代码可在作者的GitHub找到:https://github.com/aqi00/note/tree/master/ExmOpenGL。
19 1
Android开发之使用OpenGL实现翻书动画
|
19天前
|
Android开发 开发者
Android开发之OpenGL的画笔工具GL10
这篇文章简述了OpenGL通过GL10进行三维图形绘制,强调颜色取值范围为0.0到1.0,背景和画笔颜色设置方法;介绍了三维坐标系及与之相关的旋转、平移和缩放操作;最后探讨了坐标矩阵变换,包括设置绘图区域、调整镜头参数和改变观测方位。示例代码展示了如何使用这些方法创建简单的三维立方体。
15 1
Android开发之OpenGL的画笔工具GL10