Android RatingBar：评价条控件

ratingBar 是 SeekBar 和 ProgressBar 的扩展，是 ProgressBar 的间接子类，可以使用 ProgressBar 相关的属性。

ratingBar 有三种风格，分别为默认风格（ratingBarStyle）、小风格（ratingBarStyleSmall）和大风格（ratingBarStyleIndicator ）。其中，默认风格的 ratingBar 是我们通常使用的，可以进行交互，而其他两种不能进行交互。

以一个简单的实例讲解 ratingBar 组件的使用方法。在工程 WidgetDemo 的布局文件 main.xml 中添加一个名为“ratingBarDemo”的 Button，用以启动 ratingBaractivity。

在 main.xml 中添加代码如下：

1. <Button
2. android:id="@+id/button9"
3. android:layout_width="wrap_content"
4. android:layout_height="wrap_content"
5. android:text="ratingBarDemo" />

单击 Button 并启动 ratingBaractivity 的代码如下：

1. Button ratingbar = (Button)this.findViewById(R.id.button9);
2. ratingbar.setonClickListener(new View.OnClickListener(){
3. @Override
4. public void onClick(View v){
5. Intent intent;
6. intent = new Intent(MainActivity.this, ratingBaractivity.class);
7. startActivity(intent);
8. }
9. });

同时在 AndroidManifest.xml 文件中声明该 Activity：

<activity android:name=".ratingBaractivity"></activity>

ratingBaractivity 的运行效果如图 1 所示。
 

图 1  ratingBaractivity的运行效果

ratingBaractivity 使用的布局文件 ratingbar.xml 的内容如下：

1. <?xml version="1.0" encoding="utf-8"?>
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
3. android:layout_width="match_parent"
4. android:layout_height="match_parent"
5. android:orientation="vertical">
6.  
7. <TextView
8. android:id="@+id/textView1"
9. android:layout_width="wrap_content"
10. android:layout_height="wrap_content"
11. android:text="TextView" />
12.  
13. <ratingBar
14. android:id="@+id/ratingBar1"
15. android:layout_width="wrap_content"
16. android:layout_height="wrap_content"
17. android:numStars="5"
18. android:rating="3"
19. android:stepSize="0.5" />
20. </LinearLayout>

该布局文件使用 LinearLayout 布局，其中放置了一个 TextView 和一个 ratingBar，并对 ratingBar 的相关属性进行了设置。

下面是各个属性的作用：

• android:numStars="5" 用于设置 ratingBar 显示的星星数量为 5 个。
• android:stepSize="0.5" 用于设置 ratingBar 的最小变化单位为半个星星。
• android:rating ="3" 表示 ratingBar 在初始状态下被选中的星星数量为 3 个。

ratingBaractivity.java 的代码如下：

1. package introduction.android.widgetdemo;
2.  
3. import android.app.Activity;
4. import android.os.Bundle;
5. import android.util.Log;
6. import android.view.MotionEvent;
7. import android.view.View;
8.  
9. import android.view.View.OnTouchListener;
10. import android.widget.ratingBar;
11.  
12. import android.widget.ratingBar.OnratingBarchangelistener;
13. import android.widget.TextView;
14. import android.widget.Toast;
15.  
16. public class ratingBaractivity extends Activity {
17. private ratingBar chooseratingBar;
18. private TextView textView;
19.  
20. @Override
21. public void onCreate(Bundle savedlnstanceState) {
22. super.onCreate(savedlnstanceState);
23. setContentView(R.layout.ratingbar);
24. textView = (TextView) findViewById(R.id.textView1);
25. chooseratingBar = (ratingBar) findViewById(R.id.ratingBar1);
26. /*创建ratingBar监听器 */
27. chooseratingBar.setonratingBarchangelistener(new OnratingBarchangelistener() {
28. @Override
29. public void onratingChanged(ratingBar ratingBar, float rating, boolean fromUser) {
30. chooseratingBar = (ratingBar) findViewById(R.id.ratingBar1);
31. chooseratingBar.setrating(rating);
32. textView.setText("您选择了" + rating + "个星星");
33.  
34. }
35.  
36. });
37. }
38. }

ratingBaractivity 为 ratingBar 对象设置了 OnratingBarchangelistener 监听器，当用户单击 ratingBar 引起被选中星星数量的变化时，该接口会监测到该事件，并且调用 onratingChanged() 方法，更新 TextView 显示的内容。

onratingChanged() 的三个参数所对应的含义如下。

• ratingBar：多个 ratingBar 可以同时指定同一个 ratingBar 监听器。该参数就是当前触发 ratingBar 监听器的那个 ratingBar 对象。
• rating：当前评级分数。取值范围从 0 到 ratingBar 的总星星数。
• fromUser：如果触发监听器的是用户触屏单击或轨迹球左右移动，则为 true。