鴻蒙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

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

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

Since:

3

嵌套類摘要

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

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

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

返回:

返回評級步長。

Since:

4

setGrainSize

public void setGrainSize(float size)

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

參數(shù)：

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

Throws:

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

Since:

4

setScore

public void setScore(float score)

設(shè)置評分。

參數(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)前評分。

返回:

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

Since:

4

setIsOperable

public void setIsOperable(boolean isOperable)

設(shè)置評級是否不可操作。

參數(shù)：

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

Since:

4

isOperable

public boolean isOperable()

檢查評級是否不可操作。

返回:

如果評級不可操作，則返回真； 否則返回 false。

Since:

4

setRatingItems

public void setRatingItems(int numberItems)

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

參數(shù)：

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

Throws:

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

Since:

4

getRatingItems

public int getRatingItems()

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

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

返回:

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

Since:

4

setRatingChangedListener

public void setRatingChangedListener(Rating.RatingChangedListener listener)

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

參數(shù)：

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

Since:

4

setFilledElement

public void setFilledElement(Element element)

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

參數(shù)：

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

Since:

4

getFilledElement

public Element getFilledElement()

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

返回:

返回元素對象。

Since:

4

setUnfilledElement

public void setUnfilledElement(Element element)

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

參數(shù)：

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

Since:

4

getHalfFilledElement

public Element getHalfFilledElement()

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

返回:

返回元素對象。

Since:

4

setHalfFilledElement

public void setHalfFilledElement(Element element)

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

參數(shù)：

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

Since:

4

getUnfilledElement

public Element getUnfilledElement()

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

返回:

返回元素對象。

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	指示元素拇指。