鸿蒙OS开发文档 鸿蒙OS Slider

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 2

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 interfaceSlider.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.ValueChangedListenermValueChangedListener指示接收进度级别更改通知的侦听器。
从类 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对象。
ElementgetDecreaseButton()获取用于绘制减小按钮的对象。
Component.ClickedListenergetDecreaseButtonClickedListener()获取减小按钮的侦听器。
ElementgetIncreaseButton()获取用于绘制增加按钮的对象。
Component.ClickedListenergetIncreaseButtonClickedListener()获取增加按钮的监听器。
ElementgetThumbElement()获取当前元素拇指。
Slider.ValueChangedListenergetValueChangedListener()获取监听此 Slider 变化事件的监听器。
voidsetAdjustButtons(Element increaseElement, Component.ClickedListener increaseListener, Element decreaseElement, Component.ClickedListener decreaseListener)设置此 Slider 的增加和减少按钮。
voidsetDecreaseButton(Element element, Component.ClickedListener listener)为此滑块设置一个减小按钮。
voidsetDecreaseButtonClickedListener(Component.ClickedListener listener)设置此 Slider 的减小按钮的侦听器。
voidsetDecreaseButtonElement(Element element)设置此 Slider 的减小按钮。
voidsetIncreaseButton(Element element, Component.ClickedListener listener)为此滑块设置一个增加按钮。
voidsetIncreaseButtonClickedListener(Component.ClickedListener listener)设置此 Slider 的增加按钮的侦听器。
voidsetIncreaseButtonElement(Element element)设置此 Slider 的增加按钮。
voidsetThumbElement(Element element)设置元素拇指。
voidsetValueChangedListener(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指示元素拇指。