鴻蒙OS Rating

Rating

java.lang.Object

|---ohos.agp.components.Component

|---|---ohos.agp.components.ProgressBar

|---|---|---ohos.agp.components.AbsSlider

|---|---|---|---ohos.agp.components.Rating

public class Rating
extends AbsSlider

提供帶有評(píng)級(jí)項(xiàng)目的評(píng)級(jí)，例如星級(jí)或任何其他元素。

此類提供帶有評(píng)級(jí)項(xiàng)目（如星號(hào)（或元素））的評(píng)級(jí)，以表示評(píng)級(jí)級(jí)別。

Since:

3

嵌套類摘要

修飾符和類型	類	描述
static interface	Rating.RatingChangedListener	回調(diào)以處理評(píng)級(jí)的更改事件。

從類 ohos.agp.components.AbsSlider 繼承的嵌套類/接口
AbsSlider.Formatter

從類 ohos.agp.components.Component 繼承的嵌套類/接口

Component.BindStateChangedListener, Component.CanAcceptScrollListener, Component.ClickedListener, Component.ComponentStateChangedListener, Component.ContourRefreshedListener, Component.DefSpeechEventListener, Component.DoubleClickedListener, Component.DragFeedbackProvider, Component.DraggedListener, Component.DrawTask, Component.EditEventListener, Component.EstimateSizeListener, Component.EstimateSpec, Component.FadeEffectEnum, Component.FocusChangedListener, Component.ForwardHoverListener, Component.ForwardTouchListener, Component.GestureType, Component.HoverEventListener, Component.KeyEventListener, Component.LayoutDirection, Component.LayoutRefreshedListener, Component.LongClickedListener, Component.MeasureSpec, Component.MouseEventListener, Component.MousePointerStyleListener, Component.OnDragListener, Component.RotationEventListener, Component.ScaledListener, Component.ScrolledListener, Component.ShadowDevice, Component.ShadowMode, Component.ShadowSize, Component.SpeechEventListener, Component.TouchEventListener, Component.UnconsumedKeyEventListener, Component.VoiceEvent

從類 ohos.agp.components.ProgressBar 繼承的嵌套類/接口
ProgressBar.BarObserver

字段摘要

從類 ohos.agp.components.Component 繼承的字段

ACCESSIBILITY_ADAPTABLE, ACCESSIBILITY_DISABLE, ACCESSIBILITY_ENABLE, AXIS_X, AXIS_Y, CONTOUR_BACKGROUND, CONTOUR_BORDER, CONTOUR_PADDING_BORDER, DEFAULT_SCALE, DRAG_DOWN, DRAG_HORIZONTAL, DRAG_HORIZONTAL_VERTICAL, DRAG_LEFT, DRAG_RIGHT, DRAG_UP, DRAG_VERTICAL, EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED, EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED_CLEAR, EVENT_TYPE_COMPONENT_CLICKED, EVENT_TYPE_COMPONENT_FOCUSED, EVENT_TYPE_COMPONENT_LONG_CLICKED, EVENT_TYPE_COMPONENT_SCROLLED, EVENT_TYPE_COMPONENT_SELECTED, EVENT_TYPE_COMPONENT_TEXT_UPDATE, EVENT_TYPE_NOTICE, EVENT_TYPE_NOTIFICATION_STATE_UPDATE, EVENT_TYPE_TOAST_SHOW, EVENT_TYPE_WINDOW_STATE_UPDATE, FOCUS_ADAPTABLE, FOCUS_DISABLE, FOCUS_ENABLE, FOCUS_NEXT, FOCUS_PREVIOUS, FOCUS_SIDE_BOTTOM, FOCUS_SIDE_LEFT, FOCUS_SIDE_RIGHT, FOCUS_SIDE_TOP, HIDE, HORIZONTAL, ID_DEFAULT, INHERITED_MODE, INVISIBLE, mBackgroundElement, mCanvasForTaskOverContent, mCanvasForTaskUnderContent, mComponentParent, mContext, mDrawTaskOverContent, mDrawTaskUnderContent, mEstimateSizeListener, mForegroundElement, mForwardHoverListener, mHoverEventListener, mKeyEventListener, mMouseEventListener, mPosition, mRotationEventListener, mShadowElement, mUnconsumedKeyEventListener, OVAL_MODE, OVAL_SCROLL_BAR_MODE, POSITION_X_INDEX, POSITION_Y_INDEX, RECT_MODE, RECT_SCROLL_BAR_MODE, SCROLL_AUTO_STAGE, SCROLL_IDLE_STAGE, SCROLL_NORMAL_STAGE, UNSPECIFIED_SCROLL_BAR_MODE, VERTICAL, VISIBLE

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù)	描述
Rating(Context context)	用于使用默認(rèn)屬性集和樣式創(chuàng)建 Rating 實(shí)例的默認(rèn)構(gòu)造函數(shù)。
Rating(Context context, AttrSet attrSet)	用于在解析 XML 文件后使用指定的屬性集和默認(rèn)樣式創(chuàng)建 Rating 實(shí)例的構(gòu)造函數(shù)。
Rating(Context context, AttrSet attrSet, String styleName)	用于在解析 XML 文件后使用指定的屬性集和指定樣式創(chuàng)建 Rating 實(shí)例的構(gòu)造函數(shù)。

方法總結(jié)

修飾符和類型	方法	描述
Element	getFilledElement()	從評(píng)分項(xiàng)中獲取填充元素。
float	getGrainSize()	獲取評(píng)級(jí)項(xiàng)目的步長（粒度）。
Element	getHalfFilledElement()	從評(píng)分項(xiàng)中獲取半填充元素。
int	getRatingItems()	獲取當(dāng)前評(píng)分項(xiàng)的數(shù)量。
float	getScore()	獲取當(dāng)前評(píng)分。
Element	getThumbElement()	獲取當(dāng)前元素拇指。
Element	getUnfilledElement()	從評(píng)分項(xiàng)中獲取未填充的元素。
boolean	isOperable()	檢查評(píng)級(jí)是否不可操作。
void	setFilledElement(Element element)	將指定的 Element 對(duì)象設(shè)置為評(píng)級(jí)項(xiàng)目的填充元素。
void	setGrainSize(float size)	設(shè)置評(píng)級(jí)項(xiàng)目的步長。
void	setHalfFilledElement(Element element)	將指定的 Element 對(duì)象設(shè)置為評(píng)級(jí)項(xiàng)目的半填充元素。
void	setIsOperable(boolean isOperable)	設(shè)置評(píng)級(jí)是否不可操作。
void	setRatingChangedListener(Rating.RatingChangedListener listener)	設(shè)置更改偵聽器以處理評(píng)級(jí)的更改事件。
void	setRatingItems(int numberItems)	設(shè)置由星號(hào)或其他符號(hào)表示的評(píng)級(jí)項(xiàng)目的數(shù)量以表示評(píng)級(jí)級(jí)別。
void	setScore(float score)	設(shè)置評(píng)分。
void	setThumbElement(Element element)	設(shè)置元素拇指。
void	setUnfilledElement(Element element)	將指定的 Element 對(duì)象設(shè)置為評(píng)級(jí)項(xiàng)目的未填充元素。

從類 ohos.agp.components.AbsSlider 繼承的方法
getFormatter, setFormatter

從類 ohos.agp.components.Component 繼承的方法

addDrawTask, addDrawTask, addScrolledListener, announceAccessibility, arrange, bindCornerMark, callOnClick, canScroll, clearFocus, createAnimatorProperty, disableFadeEffect, dispatchRestoreState, dispatchSaveState, draw, enableCornerMark, enableFadeEffect, enableSaveState, enableScrollBar, estimateSize, executeDoubleClick, executeLongClick, findComponentById, findComponentHolderById, findFocus, findNextFocusableComponent, findRequestNextFocus, getAccessibility, getAccessibilityDescription, getAlpha, getAltitude, getBackgroundElement, getBaseLine, getBottom, getBoundaryFadeEffectBottomRate, getBoundaryFadeEffectLeftRate, getBoundaryFadeEffectRightRate, getBoundaryFadeEffectTopRate, getCenterZoomFactor, getCentralScrollMode, getClickedListener, getClipEnabled, getComponentDescription, getComponentMinSize, getComponentParent, getComponentPosition, getComponentSize, getComponentStateChangedListener, getComponentTreeObserver, getContentEnable, getContentPosition, getContentPositionX, getContentPositionY, getContext, getContour, getContourRefreshedListener, getCornerMark, getDragAcceptAngle, getDraggedListener, getEditEventListener, getEstimatedHeight, getEstimatedWidth, getFadeEffectBoundaryWidth, getFadeEffectColor, getFocusable, getFocusBorderEnable, getFocusBorderPadding, getFocusBorderRadius, getFocusBorderWidth, getForegroundElement, getForegroundGravity, getForwardHoverListener, getForwardTouchListener, getGesturePriority, getHeight, getHorizontalPadding, getHorizontalPosition, getHoverEventListener, getId, getKeyEventListener, getLayoutConfig, getLayoutDirection, getLayoutDirectionResolved, getLayoutRefreshedListener, getLeft, getLocationOnScreen, getMarginBottom, getMarginLeft, getMarginRight, getMargins, getMarginsLeftAndRight, getMarginsTopAndBottom, getMarginTop, getMatrix, getMinHeight, getMinWidth, getMode, getModeResolved, getMouseEventListener, getMousePointerStyleListener, getName, getPadding, getPaddingBottom, getPaddingEnd, getPaddingLeft, getPaddingRight, getPaddingStart, getPaddingTop, getPivot, getPivotX, getPivotY, getResourceManager, getRight, getRotation, getRotationEventListener, getRotationSensitivity, getScale, getScaledListener, getScaleX, getScaleY, getScrollbarBackgroundColor, getScrollbarColor, getScrollbarFadingDelay, getScrollbarFadingDuration, getScrollBarMode, getScrollbarRadius, getScrollbarRoundRect, getScrollbarStartAngle, getScrollbarSweepAngle, getScrollbarThickness, getScrollState, getScrollValue, getSelfVisibleRect, getShadowColor, getSpeechEventListener, getTag, getTop, getTouchEventListener, getTransitionSymbol, getTranslation, getTranslationX, getTranslationY, getTranslationZ, getUserNextFocus, getVerticalPadding, getVerticalPosition, getVisibility, getVisibleRectOnScreen, getWidth, getWindowVisibleRect, hasFocus, hasFocusedEffect, hasOverlaps, hideFocusBorder, informConfigurationChanged, invalidate, isBoundaryFadeEffectEnable, isBoundToWindow, isClickable, isClipToContourEnabled, isComponentDisplayed, isEnabled, isFadeEffected, isFocusable, isFocused, isIdentityMatrix, isLongClickOn, isPressed, isRtl, isSaveStateEnabled, isScrollbarFadingOn, isScrollBarOn, isScrollbarOverlapEnabled, isSelected, isSoundEnable, isTouchFocusable, isVibrationEffectEnabled, notifyAccessibility, onAttributeConfigChanged, onDrag, onRestoreState, onRtlChanged, onSaveState, performScale, playSound, postLayout, refreshContour, release, removeBindStateChangedListener, removeScrolledListener, requestFocus, requestForceForwardTouchEvent, restoreComponentTreeState, saveComponentTreeState, scrollBy, scrollTo, setAccessibility, setAccessibilityDescription, setAlpha, setAltitude, setBackground, setBindStateChangedListener, setBottom, setBoundaryFadeEffectEnable, setCanAcceptScrollListener, setCenterZoomFactor, setCentralScrollMode, setClickable, setClickedListener, setClipEnabled, setClipToContourEnabled, setComponentDescription, setComponentMinSize, setComponentPosition, setComponentPosition, setComponentSize, setComponentStateChangedListener, setContentEnable, setContentPosition, setContentPositionX, setContentPositionY, setContour, setContourRefreshedListener, setDoubleClickedListener, setDragAcceptAngle, setDraggedListener, setEditEventListener, setEnabled, setEstimatedSize, setEstimateSizeListener, setFadeEffectBoundaryWidth, setFadeEffectColor, setFocusable, setFocusBorderEnable, setFocusBorderPadding, setFocusBorderRadius, setFocusBorderRadius, setFocusBorderWidth, setFocusChangedListener, setFocusedEffect, setForeground, setForegroundGravity, setForwardHoverListener, setForwardTouchListener, setGesturePriority, setHeight, setHorizontalPadding, setHorizontalPosition, setHoverEventListener, setId, setKeyEventListener, setLayoutConfig, setLayoutDirection, setLayoutRefreshedListener, setLeft, setLongClickable, setLongClickedListener, setMarginBottom, setMarginLeft, setMarginRight, setMarginsLeftAndRight, setMarginsTopAndBottom, setMarginTop, setMinHeight, setMinWidth, setMode, setMouseEventListener, setMousePointerStyleListener, setName, setOnDragListener, setPadding, setPaddingBottom, setPaddingLeft, setPaddingRelative, setPaddingRight, setPaddingTop, setPivot, setPivot, setPivotX, setPivotY, setPosition, setPositionX, setPositionY, setPressState, setRight, setRotation, setRotationEventListener, setRotationSensitivity, setScale, setScaledListener, setScaleX, setScaleY, setScrollbarBackgroundColor, setScrollbarColor, setScrollbarFadingDelay, setScrollbarFadingDuration, setScrollbarFadingEnabled, setScrollBarMode, setScrollbarOverlapEnabled, setScrollbarRadius, setScrollbarRoundRect, setScrollbarStartAngle, setScrollbarSweepAngle, setScrollbarThickness, setScrolledListener, setSelected, setShadowColor, setShadowStyle, setSoundEnable, setSpeechEventListener, setTag, setTop, setTouchEventListener, setTouchFocusable, setTransitionSymbol, setTranslation, setTranslationX, setTranslationY, setTranslationZ, setUnconsumedKeyEventListener, setUserNextFocus, setVerticalPadding, setVerticalPosition, setVibrationEffectEnabled, setVisibility, setWidth, showFocusBorder, simulateClick, simulateDrag, startDragAndDrop, subscribeVoiceEvents, unsubscribeVoiceEvents

從類 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

從類 ohos.agp.components.ProgressBar 繼承的方法

addBarObserver, enableDividerLines, getBackgroundInstructElement, getDividerLineColor, getDividerLinesNumber, getDividerLineThickness, getInfiniteModeElement, getMax, getMaxHeight, getMaxWidth, getMin, getOrientation, getProgress, getProgressColor, getProgressColors, getProgressElement, getProgressHintText, getProgressHintTextAlignment, getProgressHintTextColor, getProgressHintTextSize, getProgressWidth, getStep, getViceProgressElement, getViceProgressValue, isDividerLinesEnabled, isIndeterminate, isInfiniteMode, removeBarObserver, setDividerLineColor, setDividerLinesNumber, setDividerLineThickness, setIndeterminate, setInfiniteModeElement, setMaxHeight, setMaxValue, setMaxWidth, setMinValue, setOrientation, setProgressBackgroundElement, setProgressColor, setProgressColors, setProgressElement, setProgressHintText, setProgressHintTextAlignment, setProgressHintTextColor, setProgressHintTextSize, setProgressValue, setProgressWidth, setStep, setViceProgress, setViceProgressElement

構(gòu)造函數(shù)詳細(xì)信息

Rating

public Rating(Context context)

用于使用默認(rèn)屬性集和樣式創(chuàng)建 Rating 實(shí)例的默認(rèn)構(gòu)造函數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
context	指示應(yīng)用程序上下文。

Since:

4

Rating

public Rating(Context context, AttrSet attrSet)

用于在解析 XML 文件后使用指定的屬性集和默認(rèn)樣式創(chuàng)建 Rating 實(shí)例的構(gòu)造函數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
context	指示應(yīng)用程序上下文。
attrSet	指示要使用的屬性集。

Since:

4

Rating

public Rating(Context context, AttrSet attrSet, String styleName)

用于在解析 XML 文件后使用指定的屬性集和指定樣式創(chuàng)建 Rating 實(shí)例的構(gòu)造函數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
context	指示應(yīng)用程序上下文。
attrSet	指示要使用的屬性集。
styleName	指示要使用的樣式名稱。

Since:

4

方法詳情

getGrainSize

public float getGrainSize()

獲取評(píng)級(jí)項(xiàng)目的步長（粒度）。

返回:

返回評(píng)級(jí)步長。

Since:

4

setGrainSize

public void setGrainSize(float size)

設(shè)置評(píng)級(jí)項(xiàng)目的步長。

參數(shù)：

參數(shù)名稱	參數(shù)描述
size	指示要設(shè)置的步長。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果 size 值小于或等于 0 或大于評(píng)級(jí)項(xiàng)目的數(shù)量，則引發(fā)異常，請(qǐng)參閱 Rating#getRatingItems()

Since:

4

setScore

public void setScore(float score)

設(shè)置評(píng)分。

參數(shù)：

參數(shù)名稱	參數(shù)描述
score	表示要設(shè)置的分?jǐn)?shù)，它是一個(gè)浮點(diǎn)值。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果 score 值小于 0，則拋出異常

Since:

4

getScore

public float getScore()

獲取當(dāng)前評(píng)分。

返回:

返回當(dāng)前評(píng)分。

Since:

4

setIsOperable

public void setIsOperable(boolean isOperable)

設(shè)置評(píng)級(jí)是否不可操作。

參數(shù)：

參數(shù)名稱	參數(shù)描述
isOperable	指定評(píng)級(jí)是否不可操作。 值 true 表示評(píng)級(jí)不可操作，false 表示相反。

Since:

4

isOperable

public boolean isOperable()

檢查評(píng)級(jí)是否不可操作。

返回:

如果評(píng)級(jí)不可操作，則返回真； 否則返回 false。

Since:

4

setRatingItems

public void setRatingItems(int numberItems)

設(shè)置由星號(hào)或其他符號(hào)表示的評(píng)級(jí)項(xiàng)目的數(shù)量以表示評(píng)級(jí)級(jí)別。

參數(shù)：

參數(shù)名稱	參數(shù)描述
numberItems	表示評(píng)級(jí)項(xiàng)目的數(shù)量。

Throws:

Throw名稱	Throw描述
IllegalArgumentException	如果值小于 0 或大于評(píng)級(jí)項(xiàng)目的上限 RATING_MAX_ITEMS，則引發(fā)異常

Since:

4

getRatingItems

public int getRatingItems()

獲取當(dāng)前評(píng)分項(xiàng)的數(shù)量。

通常，較高的評(píng)級(jí)級(jí)別由較大數(shù)量的星號(hào)（或其他符號(hào)）表示。

返回:

返回評(píng)級(jí)項(xiàng)目的數(shù)量。

Since:

4

setRatingChangedListener

public void setRatingChangedListener(Rating.RatingChangedListener listener)

設(shè)置更改偵聽器以處理評(píng)級(jí)的更改事件。

參數(shù)：

參數(shù)名稱	參數(shù)描述
listener	指示應(yīng)用程序傳遞的更改偵聽器，用于處理評(píng)分的更改事件。

Since:

4

setFilledElement

public void setFilledElement(Element element)

將指定的 Element 對(duì)象設(shè)置為評(píng)級(jí)項(xiàng)目的填充元素。

參數(shù)：

參數(shù)名稱	參數(shù)描述
element	指示要設(shè)置的 Element 對(duì)象。

Since:

4

getFilledElement

public Element getFilledElement()

從評(píng)分項(xiàng)中獲取填充元素。

返回:

返回元素對(duì)象。

Since:

4

setUnfilledElement

public void setUnfilledElement(Element element)

將指定的 Element 對(duì)象設(shè)置為評(píng)級(jí)項(xiàng)目的未填充元素。

參數(shù)：

參數(shù)名稱	參數(shù)描述
element	指示要設(shè)置的 Element 對(duì)象。

Since:

4

getHalfFilledElement

public Element getHalfFilledElement()

從評(píng)分項(xiàng)中獲取半填充元素。

返回:

返回元素對(duì)象。

Since:

4

setHalfFilledElement

public void setHalfFilledElement(Element element)

將指定的 Element 對(duì)象設(shè)置為評(píng)級(jí)項(xiàng)目的半填充元素。

參數(shù)：

Parameter Name	Parameter Description
element	Indicates the Element object to set.

Since:

4

getUnfilledElement

public Element getUnfilledElement()

從評(píng)分項(xiàng)中獲取未填充的元素。

返回:

返回元素對(duì)象。

Since:

4

getThumbElement

public Element getThumbElement()

從類復(fù)制的描述：AbsSlider

獲取當(dāng)前元素拇指。

覆蓋：

類 AbsSlider 中的 getThumbElement

返回:

指示當(dāng)前元素縮略圖。

setThumbElement

public void setThumbElement(Element element)

從類復(fù)制的描述：AbsSlider

設(shè)置元素拇指。

覆蓋：

類 AbsSlider 中的 setThumbElement

參數(shù)：

參數(shù)名稱	參數(shù)描述
element	指示元素拇指。