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