前言
在Android开发过程中，经常会用到ProgressBar控件，但是原生的Android系统上的ProgressBar又不能满足日常开发需求，于是便自定义了一款进度条控件LoadProgressBar。该进度条具备两种表现形式，通常在下载或加载时使用。下面对其使用进行详细讲解。
今天涉及内容：
-
ProgressBar特性
1.1 水平进度条可设置参数
1.2 圆形进度条可设置参数
1.3 主要使用方法 -
ProgressBar的使用
2.1 建立自定义属性
2.2 在布局中引用LoadProgressBar控件
2.3 在MainActivity中使用LoadProgressBar控件 - 效果图项目结构图
-
ProgressBar源码
先来波效果图
1.gif
一. ProgressBar特性
ProgressBar是一款可自行设置众多属性的进度条，其参数以属性形式在布局中设置。下面对其分两种表现形式做设置参数讲解。其表现形式分为
- 水平进度条
- 圆形进度条
1.1 水平进度条可设置参数
progress_unreach_color="#FFA6ADB7" //未完成部分色值
progress_unreach_height="4dp" //未完成部分高度
progress_reach_color="#FF8AD858" //完成部分色值
progress_reach_height="4dp" //完成部分高度
progress_text_color="#FF000000" //文字颜色
progress_text_size="12sp" //文字大小
progress_text_offset="5dp" //文字与进度条间距
progress_circle_style="false" //是否为圆形进度条(不设置默认是false)
1.2 圆形进度条可设置参数
progress_unreach_color="#FFA6ADB7" //未完成部分色值
progress_unreach_height="4dp" //未完成部分高度
progress_reach_color="#FF8AD858" //完成部分色值
progress_reach_height="4dp" //完成部分高度
progress_text_color="#FF000000" //文字颜色
progress_text_size="12sp" //文字大小
progress_text_offset="5dp" //文字与进度条间距(圆形进度条不需要设置此属性)
progress_radius="40dp" //圆半径
progress_circle_style="true" //是否为圆形进度条(为圆形进度条时必须设置为true)
1.3 主要使用方法
ProgressBar只有一个可用的更新进度条的方法：
/***
* 更新进度条
* @param progress 进度
* @return true:已经更新到最大,需要移除handle消息 false:进度条更新
*/
public boolean update(int progress)
二. ProgressBar的使用
2.1 建立自定义属性
在attrs文件中新建如下引用样式(不会自定义的，可参考番外篇2：自定义View属性全解)：
<?xml version="1.0" encoding="utf-8"?>
<resources>
<!-- LoadProgressBar自定义属性样式 -->
<declare-styleable name="LoadProgressBar">
<attr name="progress_unreach_color" format="color"></attr>
<attr name="progress_unreach_height" format="dimension"></attr>
<attr name="progress_reach_color" format="color"></attr>
<attr name="progress_reach_height" format="dimension"></attr>
<attr name="progress_text_color" format="color"></attr>
<attr name="progress_text_size" format="dimension"></attr>
<attr name="progress_text_offset" format="dimension"></attr>
<attr name="progress_circle_style" format="boolean"/>
<attr name="progress_radius" format="dimension"/>
</declare-styleable>
</resources>
2.2 在布局中引用LoadProgressBar控件
在MainActivity对应布局文件activity_main.xml中声明LoadProgressBar控件的属性：
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:pain="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools">
//其他代码省略
//......
</androidx.constraintlayout.widget.ConstraintLayout>
其中xmlns:pain="http://schemas.android.com/apk/res-auto"即为控件属性声明，pain这个可以随便取，但是要保证attrs文件中每个属性的name都唯一。然后在xml中给控件设置属性可以像下面这样：
pain:progress_unreach_color="#FFA6ADB7" //设置未完成部分颜色
接着再在activity_main.xml中引用控件(以水平样式为例)：
<com.testdemo.widget.LoadProgressBar
android:id="@+id/progress"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginStart="10dp"
android:layout_marginEnd="10dp"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@+id/tv"
android:layout_marginTop="30dp"
pain:progress_unreach_color="#FFA6ADB7" //可选
pain:progress_unreach_height="4dp" //可选
pain:progress_reach_color="#FF8AD858" //可选
pain:progress_reach_height="4dp" //可选
pain:progress_text_color="#FF000000" //可选
pain:progress_text_size="12sp" //可选
pain:progress_text_offset="5dp" //可选
pain:progress_circle_style="false"/> //可选
下面贴出activity_main.xml中完整代码：
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:pain="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<TextView
android:id="@+id/tv"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="50dp"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent"
android:text="我是测试界面"/>
<!--水平进度条-->
<com.testdemo.widget.LoadProgressBar
android:id="@+id/progress"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginStart="10dp"
android:layout_marginEnd="10dp"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@+id/tv"
android:layout_marginTop="30dp"
pain:progress_unreach_color="#FFA6ADB7" //可选
pain:progress_unreach_height="4dp" //可选
pain:progress_reach_color="#FF8AD858" //可选
pain:progress_reach_height="4dp" //可选
pain:progress_text_color="#FF000000" //可选
pain:progress_text_size="12sp" //可选
pain:progress_text_offset="5dp" //可选
pain:progress_circle_style="false"/> //可选
<!--圆形进度条-->
<com.testdemo.widget.LoadProgressBar
android:id="@+id/progress2"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginStart="10dp"
android:layout_marginEnd="10dp"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@+id/progress"
android:layout_marginTop="30dp"
pain:progress_unreach_color="#FFA6ADB7" //可选
pain:progress_unreach_height="4dp" //可选
pain:progress_reach_color="#FF8AD858" //可选
pain:progress_reach_height="4dp" //可选
pain:progress_text_color="#FF000000" //可选
pain:progress_text_size="12sp" //可选
pain:progress_text_offset="5dp" //可选
pain:progress_radius="40dp" //可选
pain:progress_circle_style="true"/> //不需设置，且属性必须为true
<Button
android:id="@+id/btn"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="20dp"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@+id/progress2"
android:text="测试"/>
</androidx.constraintlayout.widget.ConstraintLayout>
2.3 在MainActivity中使用LoadProgressBar控件
在MainActivity中使用代码如下：
public class MainActivity extends AppCompatActivity{
private LoadProgressBar mLoadProgressBar;
private LoadProgressBar mLoadProgressBar2;
private Button mButton;
private Handler mHandler=new Handler(){
@Override
public void handleMessage(@NonNull Message msg) {
super.handleMessage(msg);
switch (msg.what) {
case 100:
int progress=mLoadProgressBar.getProgress();
progress++;
boolean complete=mLoadProgressBar.update(progress);
if(complete){
mHandler.removeMessages(100);
}else{
mHandler.sendEmptyMessageDelayed(100,500);
}
break;
case 101:
int progress2=mLoadProgressBar2.getProgress();
progress2++;
boolean complete2=mLoadProgressBar2.update(progress2);
if(complete2){
mHandler.removeMessages(101);
}else{
mHandler.sendEmptyMessageDelayed(101,500);
}
break;
default:
break;
}
}
};
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mButton=findViewById(R.id.btn);
mLoadProgressBar=findViewById(R.id.progress);
mLoadProgressBar2=findViewById(R.id.progress2);
mButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
mHandler.sendEmptyMessage(100);
mHandler.sendEmptyMessage(101);
}
});
}
}
三.效果图项目结构图
1.gif
项目结构图
image.png
四. ProgressBar源码
下面贴出ProgressBar源码：
