API 25 (Android 7.1.1 API) widget.ProgressBar——属性分析

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/qqicq2001/article/details/53228380

Android API 25 (Android 7.1.1)


ProgressBar

public class ProgressBar

extends View

Added in API level 1

 

java.lang.Object

   ↳android.view.View

    ↳android.widget.ProgressBar

 

已知直接子类:

AbsSeekBar

ContentLoadingProgressBar

 

【概述】

ProgressBar是界面用于与用户交互的一个组件,用来提升用户友好度,通常用于向用户展示某个耗时操作时,用于展示完成的百分比,不至于让用户觉得程序失去了响应。

 

在某些操作的进度中的可视指示器,为用户呈现操作的进度,还它有一个次要的进度条,用来显示中间进度,如在流媒体播放的缓冲区的进度。一个进度条也可不确定其进度。在不确定模式下,进度条显示循环动画。这种模式常用于应用程序使用任务的长度是未知的。

 

以下代码示例展示了如何使用一个进度条,在一个工作线程中更新,然后把进度通知给用户:

public class MyActivity extends Activity {

     private static final int PROGRESS = 0x1;

     private ProgressBar mProgress;

     private int mProgressStatus = 0;

     private Handler mHandler = new Handler();

 

     protected void onCreate(Bundle icicle) {

         super.onCreate(icicle);

         setContentView(R.layout.progressbar_activity);

         mProgress = (ProgressBar) findViewById(R.id.progress_bar);

         // Start lengthy operation in a background thread

         new Thread(new Runnable() {

             public void run() {

                 while (mProgressStatus < 100) {

                     mProgressStatus = doWork();

                     // Update the progress bar

                     mHandler.post(new Runnable() {

                         public void run() {

                             mProgress.setProgress(mProgressStatus);

                         }

                     });

                 }

             }

         }).start();

     }

 }

 

 

添加进度条的布局文件,你可以使用<ProgressBar>元素。默认情况下,进度条是一个旋转的轮子(一个不确定的指标)。应用Widget.ProgressBar.Horizontal风格可以把进度条改成水平方向,像这样:

<ProgressBar style="@android:style/Widget.ProgressBar.Horizontal" .../>

style=?android:attr/ProgressBarStyleHorizontal

如果你将使用进度条显示真正的进度,你应该使用水平进度条。然后使用incrementProgressBy()setProgress()来增加进度值。默认情况下,当进度值达到100就满了。如果有必要,你可以使用android:max来调整最大值。

另一个常用的风格是Widget.ProgressBar.Small。当等待加载内容时显示了一个小的旋转轮子。

 

系统提供的进度条风格有:

·Widget.ProgressBar.Horizontal     水平进度条

·Widget.ProgressBar.Small          小环形进度条

·Widget.ProgressBar.Large          大环形进度条

·Widget.ProgressBar.Inverse        环形逆转进度条

·Widget.ProgressBar.Small.Inverse  小环形逆转进度条

·Widget.ProgressBar.Large.Inverse  大环形逆转进度条

·Widget.ProgressBar.Small.Title   标题型小环形进度条

 

 

【XML属性】

android:  animationResolution

API 11-16

属性说明:设置进度条动画的超时时间。帧之间的动画超时时间。单位:毫秒。

必须是整型值(integer),如:100

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局资源符号是animationResolution

 

API 16被弃用。Framework不再使用。

 

android:  indeterminate

API 1

属性说明:设置是否使用不确定进度模式。在不确定进度模式下,进度条动画无限循环。(即没有确切的进度值。)

必须是布尔值(boolean),true”或“false”。

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局资源符号是indeterminate

 


android:  indeterminateBehavior

API 1

属性说明:设置当选择不确定进度时,如何描述到达最大进度值的表现。

必须是以下常量之一:

repeat 进度从0重新开始

cycle  进度保持当前值,并且回到0

对应的全局资源符号是indeterminateBehavior

 


android:  indeterminateDrawable

API 1

属性说明:设置当选择不确定进度时,所绘制的drawable

必须引用另一个资源(格式:@[package:]type:name)或主题属性(格式:?[package][type:]name

对应的全局资源符号是indeterminateDrawable

 


android:  indeterminateDuration

API 1

属性说明:设置当选择不确定进度时的持续时间。

必须是整型值(integer),如:100

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局资源符号是indeterminateDuration

  


android:  indeterminateOnly

API 1

属性说明:设置是否只采用不确定进度模式(状态保持模式将不会工作)。

必须是布尔值(boolean),true”或“false”。

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局资源符号是indeterminateOnly

 


android:  indeterminateTint

API 21

关联方法:setIndeterminateTintList(ColorStateList tint)

属性说明:设置不确定进度条的色调。

必须是颜色值(color),格式#rgb”、”#argb”、”#rrggbb”、”#aarrggbb”。

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局资源符号是indeterminateTint

 


android:  indeterminateTintMode

API 21

关联方法:setIndeterminateTintMode(PorterDuff.Mode tintMode)

属性说明:设置不确定进度条色调的混合模式。

必须是以下常量之一:

src_over  src_in  src_atop  multiply  screen  add

它对应的全局资源符号是indeterminateTintMode

 


android:  interpolator

API 1

关联方法:setInterpolator(Interpolator interpolator)

属性说明:指定一个插值器。用于定义变化的速率。默认linear_interpolator

使用插值器

android:interpolator=@android:anim/accelerate_interpolator

常用插值器

accelerate_decelerate_interpolator 先加速再减速

accelerate_interpolator            加速

decelerate_interpolator            减速

linear_interpolator                匀速

cycle_interpolator                 周期运动(正弦曲线

bounce_interpolator                最后阶段弹球效果

anticipate_interpolator            先回退一小步然后加速前进

anticipate_overshoot_interpolator   在上一个基础上超过终点一小步再回到终点

overshoot_interpolator             快速到达终点并超出一小步最后回到终点

【个性化插值器】(几种常用插值器可调整的属性)

accelerate_decelerate_interpolator

accelerate_interpolator

androidfactor浮点值,加速速率,默认为1

decelerate_interpolator

androidfactor浮点值,减速速率,默认为1

linear_interpolator

cycle_interpolator

androidcycles整数值,循环次数,默认为1

bounce_interpolator

anticipate_interpolator

androidtension浮点值,起始点后退的张力,默认为2

anticipate_overshoot_interpolator

androidtension浮点值,起始点后退的张力,默认为2

androidextraTension浮点值,拉力的倍数,默认为1.52*1.5

overshoot_interpolator

androidtension浮点值,超出终点后的拉力,默认为2

【例】在/res/anim下创建此XML文件,命名my_overshoot_interpolator.xml,然后引用

<?xml version="1.0" encoding="utf-8"?>  

<overshootInterpolator xmlns:android="http://schemas.android.com/apk/res/android"  

android:tension="7.0"/>

自定义插值器

...

 

android:  max

API 1

关联方法:setMax(int max)

属性说明:设置进度值的最大值。

必须是整型值(integer),如:100

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局属性资源符号是max

 


android:  maxHeight

API 1

属性说明:设置进度条的最大高度的可选参数。

必须是带单位的浮点型尺寸值float,如:14.5sp”。有效的单位包括:px(像素)dp(密度无关像素)sp(通常用于字体尺寸的可伸缩像素)in(英寸)mm(毫米)

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局属性资源符号是maxHeight


 

android:  maxWidth

API 1

属性说明:设置进度条的最大宽度的可选参数。

必须是带单位的浮点型尺寸值float,如:14.5sp”。有效的单位包括:px(像素)dp(密度无关像素)sp(通常用于字体尺寸的可伸缩像素)in(英寸)mm(毫米)

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局属性资源符号是maxWidth

 


android:  minHeight

API 1

属性说明:设置进度条的最小高度的可选参数。

关联方法setMinimumHeight(int minHeight)

必须是带单位的浮点型尺寸值float,如:14.5sp”。有效的单位包括:px(像素)dp(密度无关像素)sp(通常用于字体尺寸的可伸缩像素)in(英寸)mm(毫米)

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局属性资源符号是minHeight

 


android:  minWidth

API 1

属性说明:设置进度条的最小宽度的可选参数。

关联方法:setMinimumWidth(int minWidth)

必须是带单位的浮点型尺寸值float,如:14.5sp”。有效的单位包括:px(像素)dp(密度无关像素)sp(通常用于字体尺寸的可伸缩像素)in(英寸)mm(毫米)

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局属性资源符号是minWidth

 


android:  mirrorForRtl

API 18

属性说明:设置当RTL模式时,相关绘图是否需要镜像。默认为false

必须是布尔值(boolean),true”或“false”。

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局属性资源符号是mirrorForRtl

 


android:  progress

API 1

setProgress(int progress)

属性说明:设置进度值的默认值,值介于0max之间。如果进度条处于不确定模式,则不执行任何操作。

必须是整型值(integer),如:100

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局属性资源符号是progress

 


android:  progressBackgroundTint

API 21

关联方法:setProgressBackgroundTintList(ColorStateList tint)

属性说明:设置进度条背景的色调。

必须是颜色值(color),格式#rgb”、”#argb”、”#rrggbb”、”#aarrggbb”。

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局属性资源符号是progressBackgroundTint

 


android:  progressBackgroundTintMode

API 21

关联方法:setProgressBackgroundTintMode(PorterDuff.Mode)

属性说明:设置进度条背景色调的渲染模式。

必须是以下常量之一:

src_over src_in src_atop multiply screen add

对应的全局属性资源符号是progressBackgroundTintMode

 


android:  progressDrawable

API 1

关联方法:setProgressDrawable(android.graphics.drawable.Drawable)

属性说明:设置该进度条轨道对应的drawable

必须引用另一个资源(格式:@[package:]type:name)或主题属性(格式:?[package][type:]name

对应的全局属性资源符号是progressDrawable

   


android:  progressTint

API 21

关联方法:setProgressTintList(ColorStateList tint)

属性说明:设置进度条的色调。

必须是颜色值(color),格式#rgb”、”#argb”、”#rrggbb”、”#aarrggbb”。

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局属性资源符号是progressTint

 


android:  progressTintMode

API 21

关联方法:setProgressTintMode(PorterDuff.Mode tintMode)

属性说明:设置进度条色调的渲染模式。

必须是以下常量之一:

src_over src_in src_atop multiply screen add

对应的全局属性资源符号是progressTintMode

 


android:  secondaryProgress

API 1

关联方法:setSecondearyProgress(int secondaryProgress)

属性说明:设置次级进度值的默认值,值介于0max之间。这种进步是在主要进展和背景之间绘制的。 它可以是媒体场景的理想选择,例如显示缓冲进度,而默认进度显示播放进度。

必须是整型值(integer),如:100

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局属性资源符号是secondaryProgress

 


android:  secondaryProgressTint

API 21

关联方法:setSecondaryProgressTintList(ColorStateList tint)

属性说明:设置二级进度条的色调。

必须是颜色值(color),格式#rgb”、”#argb”、”#rrggbb”、”#aarrggbb”。

也可以引用一个包含此类型值的资源格式:@[package:]type:name或主题属性(格式:?[package][type:]name)。

对应的全局属性资源符号是secondaryProgressTint

 


android:  secondaryProgressTintMode

API 21

关联方法:setSecondaryProgressTintMode(PorterDuff.Mode tintMode)

属性说明:设置二级进度条色调的渲染模式。

必须是以下常量之一:

src_over src_in src_atop multiply screen add

对应的全局属性资源符号是secondaryProgressTintMode 

 

【继承自view.View的XML属性】

跳转view.View

 

【公共构造函数】

ProgressBar(Context context) 

ProgressBar(Context context, AttributeSet attrs)

ProgressBar(Context context, AttributeSet attrs, int defStyleAttr)

ProgressBar(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)




阅读更多
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页