Android RatingBar：评价条控件

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

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

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

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

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：

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

图 1  RatingBarActivity的运行效果

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

3. android:layout_width="match_parent"
4. android:layout_height="match_parent"
5. android:orientation="vertical">
6.  
8. android:id="@+id/textView1"
9. android:layout_width="wrap_content"
10. android:layout_height="wrap_content"
11. android:text="TextView" />
12.  
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" />

该布局文件使用 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。