鸿蒙OS Slider

Slider

java.lang.Object

|---ohos.agp.components.Component

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

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

|---|---|---|---ohos.agp.components.Slider

public class Slider
extends AbsSlider

提供一个进度组件，允许在屏幕上进行拖动操作。

您可以更改事件的进度，例如，快进音乐播放。 如果 Slider 用于指示任务的完成状态，则不能在屏幕上拖动滑块。

Since:

3

嵌套类摘要

修饰符和类型	类	描述
static interface	Slider.ValueChangedListener	提供回调以侦听和处理 Slider 的更改事件。

从类 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

字段摘要

修饰符和类型	字段	描述
protected Slider.ValueChangedListener	mValueChangedListener	指示接收进度级别更改通知的侦听器。

从类 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

构造函数摘要

构造函数	描述
Slider(Context context)	用于使用默认属性集和样式创建 Slider 实例的默认构造函数。
Slider(Context context, AttrSet attrSet)	用于在 XML 文件解析后使用指定的属性集和默认样式创建 Slider 实例的构造函数。
Slider(Context context, AttrSet attrSet, String styleName)	用于在 XML 文件解析后使用指定的属性集和指定的样式创建 Slider 实例的构造函数。

方法总结

修饰符和类型	方法	描述
Element[]	getAdjustButtonsElements()	获取所有增减按钮的Element对象。
Element	getDecreaseButton()	获取用于绘制减小按钮的对象。
Component.ClickedListener	getDecreaseButtonClickedListener()	获取减小按钮的侦听器。
Element	getIncreaseButton()	获取用于绘制增加按钮的对象。
Component.ClickedListener	getIncreaseButtonClickedListener()	获取增加按钮的监听器。
Element	getThumbElement()	获取当前元素拇指。
Slider.ValueChangedListener	getValueChangedListener()	获取监听此 Slider 变化事件的监听器。
void	setAdjustButtons(Element increaseElement, Component.ClickedListener increaseListener, Element decreaseElement, Component.ClickedListener decreaseListener)	设置此 Slider 的增加和减少按钮。
void	setDecreaseButton(Element element, Component.ClickedListener listener)	为此滑块设置一个减小按钮。
void	setDecreaseButtonClickedListener(Component.ClickedListener listener)	设置此 Slider 的减小按钮的侦听器。
void	setDecreaseButtonElement(Element element)	设置此 Slider 的减小按钮。
void	setIncreaseButton(Element element, Component.ClickedListener listener)	为此滑块设置一个增加按钮。
void	setIncreaseButtonClickedListener(Component.ClickedListener listener)	设置此 Slider 的增加按钮的侦听器。
void	setIncreaseButtonElement(Element element)	设置此 Slider 的增加按钮。
void	setThumbElement(Element element)	设置元素拇指。
void	setValueChangedListener(Slider.ValueChangedListener listener)	设置侦听器以侦听滑块的更改事件。

从类 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

字段详细信息

mValueChangedListener

protected Slider.ValueChangedListener mValueChangedListener

指示接收进度级别更改通知的侦听器。

ValueChangedListener 存储滑块变化监听器，并提供回调处理滑块变化事件。

构造函数详细信息

Slider

public Slider(Context context)

用于使用默认属性集和样式创建 Slider 实例的默认构造函数。

参数：

参数名称	参数描述
context	指示应用程序上下文。

Slider

public Slider(Context context, AttrSet attrSet)

用于在 XML 文件解析后使用指定的属性集和默认样式创建 Slider 实例的构造函数。

参数：

参数名称	参数描述
context	指示应用程序上下文。
attrSet	指示要使用的属性集。

Slider

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

用于在 XML 文件解析后使用指定的属性集和指定的样式创建 Slider 实例的构造函数。

参数：

参数名称	参数描述
context	指示应用程序上下文。
attrSet	指示要使用的属性集。
styleName	指示要使用的样式名称。

方法详情

setValueChangedListener

public void setValueChangedListener(Slider.ValueChangedListener listener)

设置侦听器以侦听滑块的更改事件。

例如，当触摸滑块或拖动滑块以更改当前进度级别时，侦听器会侦听事件。

参数：

参数名称	参数描述
listener	表示监听器。

getValueChangedListener

public Slider.ValueChangedListener getValueChangedListener()

获取监听此 Slider 变化事件的监听器。

返回:

返回监听器。

Since:

4

setIncreaseButton

public void setIncreaseButton(Element element, Component.ClickedListener listener)

为此滑块设置一个增加按钮。

增加按钮位于垂直滑块的顶部或水平滑块的右侧。

参数：

参数名称	参数描述
element	表示增加按钮的元素对象。
listener	指示增加按钮侦听器。 如果该参数为null，则使用默认的增加按钮监听。

Since:

3

setIncreaseButtonElement

public void setIncreaseButtonElement(Element element)

设置此 Slider 的增加按钮。

参数：

参数名称	参数描述
element	指示增加按钮的 Element 对象。

Since:

4

setIncreaseButtonClickedListener

public void setIncreaseButtonClickedListener(Component.ClickedListener listener)

设置此 Slider 的增加按钮的侦听器。

参数：

参数名称	参数描述
listener	指示要设置的侦听器。 如果此参数为空，则默认监听器用于增加按钮。

Since:

4

getIncreaseButtonClickedListener

public Component.ClickedListener getIncreaseButtonClickedListener()

获取增加按钮的监听器。

返回:

返回监听器。

Since:

4

getIncreaseButton

public Element getIncreaseButton()

获取用于绘制增加按钮的对象。

返回:

返回用于绘制增加按钮的对象。

Since:

3

setDecreaseButton

public void setDecreaseButton(Element element, Component.ClickedListener listener)

为此滑块设置一个减小按钮。

减少按钮位于垂直滑块的底部或水平滑块的左侧。

参数：

参数名称	参数描述
element	表示减小按钮的元素对象。
listener	指示减小按钮侦听器。 如果此参数为 null，则将使用默认的减小按钮侦听器。

Since:

3

setDecreaseButtonElement

public void setDecreaseButtonElement(Element element)

设置此 Slider 的减小按钮。

参数：

参数名称	参数描述
element	指示减小按钮的 Element 对象。

Since:

4

setDecreaseButtonClickedListener

public void setDecreaseButtonClickedListener(Component.ClickedListener listener)

设置此 Slider 的减小按钮的侦听器。

参数：

参数名称	参数描述
listener	指示要设置的侦听器。 如果此参数为 null，则默认侦听器用于减小按钮。

Since:

4

getDecreaseButtonClickedListener

public Component.ClickedListener getDecreaseButtonClickedListener()

获取减小按钮的侦听器。

返回:

返回监听器。

Since:

4

getDecreaseButton

public Element getDecreaseButton()

获取用于绘制减小按钮的对象。

返回:

返回用于绘制减小按钮的对象。

Since:

3

setAdjustButtons

public void setAdjustButtons(Element increaseElement, Component.ClickedListener increaseListener, Element decreaseElement, Component.ClickedListener decreaseListener)

设置此 Slider 的增加和减少按钮。

增加按钮位于垂直滑块的顶部或水平滑块的右侧； 减少按钮位于垂直滑块的底部或水平滑块的左侧。

参数：

参数名称	参数描述
increaseElement	指示增加按钮的 Element 对象。
increaseListener	指示增加按钮的侦听器。 如果此参数为空，则默认监听器用于增加按钮。
decreaseElement	指示减小按钮的 Element 对象。
decreaseListener	指示减小按钮的侦听器。 如果此参数为 null，则默认侦听器用于减小按钮。

Since:

4

getAdjustButtonsElements

public Element[] getAdjustButtonsElements()

获取所有增减按钮的Element对象。

返回:

返回 Element 对象的列表。

Since:

4

getThumbElement

public Element getThumbElement()

从类复制的描述：AbsSlider

获取当前元素拇指。

覆盖：

类 AbsSlider 中的 getThumbElement

返回:

指示当前元素缩略图。

setThumbElement

public void setThumbElement(Element element)

从类复制的描述：AbsSlider

设置元素拇指。

覆盖：

类 AbsSlider 中的 setThumbElement

参数：

参数名称	参数描述
element	指示元素拇指。