RatingBar的使用方法详解

不念不忘少年蓝@ 2022-08-20 07:22 203阅读 0赞

![2010-11-18_1.jpg][]

RatingBar是基于SeekBar和ProgressBar的扩展，用星型来显示等级评定。使用RatingBar的默认大小时，用户可以触摸/拖动或使用键来设置评分，它有两种样式(小风格用ratingBarStyleSmall，大风格用ratingBarStyleIndicator)，其中大的只适合指示，不适合于用户交互。

当使用可以支持用户交互的RatingBar时，无论将控件(widgets)放在它的左边还是右边都是不合适的。

只有当布局的宽被设置为wrap content时，设置的星星数量（通过函数setNumStars(int)或者在XML的布局文件中定义）将显示出来（如果设置为另一种布局宽的话，后果无法预知）。

次级进度一般不应该被修改，因为他仅仅是被当作星型部分内部的填充背景。

参见[Form Stuff tutorial][].

三、嵌套类

接口：RatingBar.OnRatingBarChangeListener

一个回调函数，当星级进度改变时修改客户端的星级。

四、XML属性

<table style="border:medium none; border-collapse:collapse; word-break:break-word; color:rgb(75,75,75); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; font-size:13px; line-height:19.5px; margin-left:26.7pt"> 
 <tbody> 
 <tr> 
 <td style="color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1pt solid black; border-collapse:collapse; padding:0cm 5.4pt; width:106.3pt; background:rgb(222,232,241)"> 属性名称 </td> 
 <td style="color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border-width:1pt 1pt 1pt medium; border-style:solid solid solid none; border-top-color:black; border-right-color:black; border-bottom-color:black; border-collapse:collapse; padding:0cm 5.4pt; width:276.4pt; background:rgb(222,232,241)"> 描述 </td> 
 </tr> 
 <tr> 
 <td style="color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:initial; border-collapse:collapse; padding:0cm 5.4pt; width:106.3pt"> android:isIndicator </td> 
 <td style="color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:initial; border-collapse:collapse; padding:0cm 5.4pt; width:276.4pt"> RatingBar是否是一个指示器（用户无法进行更改） </td> 
 </tr> 
 <tr> 
 <td style="color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:initial; border-collapse:collapse; padding:0cm 5.4pt; width:106.3pt"> android:numStars </td> 
 <td style="color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:initial; border-collapse:collapse; padding:0cm 5.4pt; width:276.4pt"> 显示的星型数量，必须是一个整形值，像“100”。 </td> 
 </tr> 
 <tr> 
 <td style="color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:initial; border-collapse:collapse; padding:0cm 5.4pt; width:106.3pt"> android:rating </td> 
 <td style="color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:initial; border-collapse:collapse; padding:0cm 5.4pt; width:276.4pt"> 默认的评分，必须是浮点类型，像“1.2”。 </td> 
 </tr> 
 <tr> 
 <td style="color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border-width:medium 1pt 1pt; border-style:none solid solid; border-color:initial; border-collapse:collapse; padding:0cm 5.4pt; width:106.3pt"> android:stepSize </td> 
 <td style="color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border-width:medium 1pt 1pt medium; border-style:none solid solid none; border-color:initial; border-collapse:collapse; padding:0cm 5.4pt; width:276.4pt"> 评分的步长，必须是浮点类型，像“1.2”。 </td> 
 </tr> 
 </tbody> 
</table>

五、公共方法

public int getNumStars ()

返回显示的星型数量

返回值

显示的星型数量

public RatingBar.OnRatingBarChangeListener getOnRatingBarChangeListener ()

返回值

监听器（可能为空）监听评分改变事件

public float getRating ()

获取当前的评分（填充的星型的数量）

返回值

当前的评分

public float getStepSize ()

获取评分条的步长

返回值

步长

public boolean isIndicator ()

返回值

判断当前的评分条是否仅仅是一个指示器（注：即能否被修改）

public void setIsIndicator (boolean isIndicator)

设置当前的评分条是否仅仅是一个指示器（这样用户就不能进行修改操作了）

参数

isIndicator       Bool值，是否是一个指示器

public synchronized void setMax (int max)

设置评分等级的范围，从0到max

参数

max         评分条最大范围。

public void setNumStars (int numStars)

设置显示的星型的数量。为了能够正常显示它们，建议将当前widget的布局宽度设置为

wrap content

参数

numStars         星型的数量

public void setOnRatingBarChangeListener (RatingBar.OnRatingBarChangeListener listener)

设置当评分等级发生改变时回调的监听器

参数

listener  监听器

public void setRating (float rating)

设置分数（星型的数量）

参数

rating      设置的分数

public void setStepSize (float stepSize)

设置当前评分条的步长（step size）

参数

stepSize 评分条的步进。例如：如果想要半个星星，它的值为0.5。

六、受保护方法

protected synchronized void onMeasure** **(int widthMeasureSpec, int heightMeasureSpec)

权衡 view 和 content 来决定它的宽度和高度的整齐。它被measure(int, int) 调用 并且应该被子类所覆盖，以便提供准确高效的布局测量。

规定: 当覆盖这个方法的时候，你必须调用 setMeasuredDimension(int, int)以便存储精确的视图的宽和高。如果不这样做的话将触发llegalStateException异常，被函数 measure(int, int)抛出。调用父类 onMeasure(int, int)是合理的。

尺寸的基本类的实现默认是背景大小，除非通过MeasureSpec允许大的尺寸。子类应该覆盖 onMeasure(int, int) 以便提供更好的布局大小。

如果这个方法被覆盖，子类应该负责确保标准的宽和高至少是视图的最小宽度和高度的值（分别为getSuggestedMinimumHeight() 和getSuggestedMinimumWidth()两方法）。

参数

*widthMeasureSpec     *受主窗口支配的水平空间要求。这个需求通过 View.MeasureSpec.进行编码。

*heightMeasureSpec   * 受主窗口支配的垂直空间要求。这个需求通过   View.MeasureSpec . 进行编码。

七、补充

文章链接

[Android 控件之RatingBar评分条][Android_RatingBar]

[Android更换RatingBar图片][Android_RatingBar 1]

[\[Android学习指南\]RatingBar 评分条][Android_RatingBar 2]

示例代码（[代码转载自Android手机开发者论坛][Android]）

Java文件

![复制代码][copycode.gif]

public   class  AndroidRatingBar  extends  Activity \{  
    /\*\*  Called when the activity is first created.  \*/   
   @Override  
    public   void  onCreate(Bundle savedInstanceState) \{  
        super .onCreate(savedInstanceState);  
       setContentView(R.layout.main);  
  
        final  RatingBar ratingBar\_Small  =  (RatingBar)findViewById(R.id.ratingbar\_Small);  
        final  RatingBar ratingBar\_Indicator  =  (RatingBar)findViewById(R.id.ratingbar\_Indicator);  
        final  RatingBar ratingBar\_default  =  (RatingBar)findViewById(R.id.ratingbar\_default);  
  
       ratingBar\_default.setOnRatingBarChangeListener( new  RatingBar.OnRatingBarChangeListener()\{  
  
    public   void  onRatingChanged(RatingBar ratingBar,  float  rating,  
      boolean  fromUser) \{  
    ratingBar\_Small.setRating(rating);  
    ratingBar\_Indicator.setRating(rating);  
    Toast.makeText(AndroidRatingBar. this ,  " rating: " \+ String.valueOf(rating),  
      Toast.LENGTH\_LONG).show();  
   \}\});  
   \}  
\}

![复制代码][copycode.gif]

XML文件

![复制代码][copycode.gif]

<? xml version="1.0" encoding="utf-8" ?> 
 < LinearLayout  xmlns:android ="http://schemas.android.com/apk/res/android" 
   android:orientation ="vertical" 
   android:layout\_width ="fill\_parent" 
   android:layout\_height ="fill\_parent" 
    > 
 < TextView  
    android:layout\_width ="fill\_parent" 
   android:layout\_height ="wrap\_content" 
   android:text ="@string/hello" 
    /> 
 < RatingBar  
    android:layout\_width ="wrap\_content" 
   android:layout\_height ="wrap\_content" 
   style ="?android:attr/ratingBarStyleIndicator" 
   android:id ="@+id/ratingbar\_Indicator" 
    /> 
 < RatingBar  
    android:layout\_width ="wrap\_content" 
   android:layout\_height ="wrap\_content" 
   style ="?android:attr/ratingBarStyleSmall" 
   android:id ="@+id/ratingbar\_Small" 
   android:numStars ="20" 
    /> 
 < RatingBar  
    android:layout\_width ="wrap\_content" 
   android:layout\_height ="wrap\_content" 
   style ="?android:attr/ratingBarStyle" 
   android:id ="@+id/ratingbar\_default" 
    /> 
 </ LinearLayout >

![复制代码][copycode.gif]

[2010-11-18_1.jpg]: /images/20220731/0f08d7631cb941b1820fbc4248a4925e.png
[Form Stuff tutorial]: http://developer.android.com/resources/tutorials/views/hello-formstuff.html
[Android_RatingBar]: http://www.cnblogs.com/salam/archive/2010/10/06/1844741.html
[Android_RatingBar 1]: http://www.javaeye.com/topic/689272
[Android_RatingBar 2]: http://android.yaohuiji.com/archives/tag/ratingbar
[Android]: http://xn--android-0b5kt08a40i90v96ik1knxfkgx85w9q2adeh9n4cgpphka/
[copycode.gif]: /images/20220731/d185161e069845aeb5fa37c794d42294.png