鸿蒙OS开发文档 鸿蒙OS Picker

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

Picker

java.lang.Object
|---ohos.agp.components.Component
|---|---ohos.agp.components.ComponentContainer
|---|---|---ohos.agp.components.DirectionalLayout
|---|---|---|---ohos.agp.components.Picker

public class Picker
extends DirectionalLayout

提供一个数字选择器,允许从预定义的范围中选择数字。

该类配置数字选择器的属性,以便用户可以在屏幕上的取值范围内选择特定的数字。

Since:

3

嵌套类摘要

修饰符和类型描述
static interfacePicker.ElementFormatter为 Picker 的每一项格式化左右复合元素对象。
static interfacePicker.Formatter格式化 Picker 的值并将其转换为字符串。
static interfacePicker.ScrolledListener处理 Picker 实例的滚动事件。
static interfacePicker.ValueChangedListener侦听 Picker 实例的值更改事件。
从类 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.ShadowDevice, Component.ShadowMode, Component.ShadowSize, Component.SpeechEventListener, Component.TouchEventListener, Component.UnconsumedKeyEventListener, Component.VoiceEvent
从类 ohos.agp.components.ComponentContainer 继承的嵌套类/接口
ComponentContainer.ArrangeListener
从类 ohos.agp.components.DirectionalLayout 继承的嵌套类/接口
DirectionalLayout.LayoutConfig

字段摘要

修饰符和类型字段描述
static floatROTATION_SENSITIVITY_DEFAULT指示 Picker 响应旋转表冠事件的默认旋转灵敏度。
static floatROTATION_SENSITIVITY_HIGH表示 Picker 响应旋转表冠事件的高旋转灵敏度。
static floatROTATION_SENSITIVITY_LOW指示 Picker 响应旋转表冠事件的低旋转灵敏度。
从类 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
从类 ohos.agp.components.ComponentContainer 继承的字段
FOCUS_CHILDREN_FIRST, FOCUS_CHILDREN_HIDE, FOCUS_PARENT_FIRST, mArrangeListener

构造函数摘要

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

方法总结

修饰符和类型方法描述
intgetCompoundElementPadding()获取文本和 Element 对象之间的填充。
ElementgetDisplayedBottomElement()获取用于在选定数字底部绘制分割线的 Element 实例。
String[]getDisplayedData()获取与要显示的数字匹配的字符串数组。
Element[]getDisplayedLinesElements()获取用于在选定文本的顶部和底部绘制显示线条的 Element 实例。
ElementgetDisplayedTopElement()获取用于在选定数字顶部绘制分割线的 Element 实例。
Picker.ElementFormattergetElementFormatter()获取每个项目左右显示的Element的格式化程序。
Picker.FormattergetFormatter()获取格式化显示内容的格式化程序。
intgetMaxValue()获取数字选择器的最大值。
intgetMinValue()获取数字选择器的最小值。
ColorgetNormalTextColor()获取数字选择器上取消选择的文本的颜色。
FontgetNormalTextFont()获取此选取器中普通文本的字体。
intgetNormalTextSize()获取数字选择器上取消选择的文本的字体大小。
Picker.ScrolledListenergetScrollListener()获取监听picker滚动状态的监听器。
floatgetSelectedNormalTextMarginRatio()获取此数字选择器中所选文本边距与正常文本边距的比率。
ElementgetSelectedTextBackgroundElement()获取元素集作为此选择器选择的文本的背景。
ColorgetSelectedTextColor()获取数字选择器上选定文本的颜色。
FontgetSelectedTextFont()获取此选取器中选定文本的字体。
intgetSelectedTextSize()获取数字选择器上选定文本的字体大小。
intgetSelectorItemNum()获取选择轮上显示的项目数。
ColorgetShaderColor()获取数字选择器的着色器颜色。
intgetValue()获取数字选择器上显示的值。
Picker.ValueChangedListenergetValueChangedListener()获取监听picker值变化的监听器。
booleanisWheelModeEnabled()获取数字选择器的选择器包装模式。
voidsetCompoundElementPadding(int padding)设置文本和元素对象之间的填充。
voidsetDisplayedData(String[] displayedData)设置要显示的字符串数组。
voidsetDisplayedLinesBottomElement(Element bottom)设置一个 Element 实例,用于在选定文本的底部绘制一条显示线。
voidsetDisplayedLinesElements(Element top, Element bottom)设置用于为选定文本绘制分割线的 Element 实例。
voidsetDisplayedLinesTopElement(Element top)设置一个 Element 实例,用于在选定文本的顶部绘制一条显示线。
voidsetElementFormatter(Picker.ElementFormatter formatter)设置格式化程序以格式化显示在每个项目的左侧和右侧的元素内容。
voidsetFormatter(Picker.Formatter formatter)设置格式化程序以标准化显示的内容。
voidsetMaxValue(int maxValue)设置数字选择器的最大值。
voidsetMinValue(int minValue)设置数字选择器的最小值。
voidsetNormalTextColor(Color color)为数字选择器上取消选择的文本设置颜色。
voidsetNormalTextFont(Font font)设置此选择器中普通文本的字体。
voidsetNormalTextSize(int textSize)为数字选择器上取消选择的文本设置字体大小。
voidsetScrollListener(Picker.ScrolledListener scrollListener)设置选择器的滚动状态侦听器。
voidsetSelectedNormalTextMarginRatio(float textMarginRatio)在此数字选择器中设置所选文本边距与正常文本边距的比率。
voidsetSelectedTextBackground(Element element)将元素设置为此选择器选择的文本的背景。
voidsetSelectedTextColor(Color color)为数字选择器上的选定文本设置颜色。
voidsetSelectedTextFont(Font font)设置此选取器中选定文本的字体。
voidsetSelectedTextSize(int textSize)为数字选择器上的选定文本设置字体大小。
voidsetSelectorItemNum(int itemNum)设置要在选择器上显示的项目数。
voidsetShaderColor(Color color)为数字选择器设置着色器颜色。
voidsetValue(int value)设置数字选择器上的当前值。
voidsetValueChangedListener(Picker.ValueChangedListener valueChangedListener)设置数字选择器的值更改侦听器。
booleansetWheelModeEnabled(boolean isEnabled)设置Selector Wheel模式,该模式确定Picker#GetMinvalue()和Picker#getMaxValue()的值是否在最大范围内滚动滚动时彼此相邻显示。
从类 ohos.agp.components.Component 继承的方法
addDrawTask, addDrawTask, addScrolledListener, announceAccessibility, arrange, bindCornerMark, callOnClick, canScroll, clearFocus, createAnimatorProperty, disableFadeEffect, draw, enableCornerMark, enableFadeEffect, enableSaveState, enableScrollBar, estimateSize, executeDoubleClick, executeLongClick, 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, invalidate, isBoundaryFadeEffectEnable, isBoundToWindow, isClickable, isClipToContourEnabled, isComponentDisplayed, isEnabled, isFadeEffected, isFocusable, isFocused, isIdentityMatrix, isLongClickOn, isPressed, isRtl, isSaveStateEnabled, isScrollbarFadingOn, isScrollBarOn, isScrollbarOverlapEnabled, isSelected, isSoundEnable, isTouchFocusable, isVibrationEffectEnabled, notifyAccessibility, onAttributeConfigChanged, 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
从类 ohos.agp.components.ComponentContainer 继承的方法
addComponent, addComponent, addComponent, addComponent, addComponent, dispatchRestoreState, dispatchSaveState, findComponentById, findComponentHolderById, getAutoLayout, getChildCount, getChildIndex, getComponentAt, getComponentTransition, getFocusOrder, getLayoutManager, informConfigurationChanged, isClipToChildBoundsEnabled, isClipToPaddingBoundsEnabled, isTouchEventSplitable, moveChildToFront, onDrag, removeAllComponents, removeComponent, removeComponentAt, removeComponentById, removeComponents, setArrangeListener, setAutoLayout, setAutoLayout, setClipToChildBoundsEnabled, setClipToPaddingBoundsEnabled, setComponentTransition, setFocusOrder, setLayoutManager, setTouchEventSplitable
从接口 ohos.agp.components.ComponentParent 继承的方法
getComponentParent, postLayout
从类 ohos.agp.components.DirectionalLayout 继承的方法
createLayoutConfig, getAlignment, getOrientation, getTotalWeight, isLayoutBaselined, setAlignment, setLayoutBaselined, setOrientation, setTotalWeight, verifyLayoutConfig
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

ROTATION_SENSITIVITY_DEFAULT

public static final float ROTATION_SENSITIVITY_DEFAULT

指示 Picker 响应旋转表冠事件的默认旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。

ROTATION_SENSITIVITY_HIGH

public static final float ROTATION_SENSITIVITY_HIGH

表示 Picker 响应旋转表冠事件的高旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。

ROTATION_SENSITIVITY_LOW

public static final float ROTATION_SENSITIVITY_LOW

指示 Picker 响应旋转表冠事件的低旋转灵敏度。 您可以使用 Component.setRotationSensitivity(float) 进行设置。

构造函数详细信息

Picker

public Picker(Context context)

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

参数:

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

Picker

public Picker(Context context, AttrSet attrSet)

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

参数:

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

Picker

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

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

参数:

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

方法详情

setSelectorItemNum

public void setSelectorItemNum(int itemNum)

设置要在选择器上显示的项目数。

参数:

参数名称参数描述
itemNum指示要在选择器上显示的项目数。

Throws:

Throw名称Throw描述
IllegalArgumentException如果要在数字选择器上显示的项目数量小于或等于 0,则引发此异常。

Since:

4

setValue

public void setValue(int value)

设置数字选择器上的当前值。

如果 value 小于 Picker#getMinValue() 且 Picker#isWheelModeEnabled() 设置为 false,则当前值为 Picker#getMinValue() 获取的值。

如果 value 小于 Picker#getMinValue() 并且 Picker#isWheelModeEnabled() 设置为 true,则当前值是 Picker#getMaxValue() 获得的值。

如果 value 大于 Picker#getMaxValue() 且 Picker#isWheelModeEnabled() 设置为 false,则当前值为 Picker#getMaxValue() 获取的值。

如果 value 大于 Picker#getMaxValue() 并且 Picker#isWheelModeEnabled() 设置为 true,则当前值是 Picker#getMinValue() 获得的值。

参数:

参数名称参数描述
value指示要设置的当前值。

Throws:

Throw名称Throw描述
IllegalArgumentException如果参数值小于 0,则抛出此异常。

setMaxValue

public void setMaxValue(int maxValue)

设置数字选择器的最大值。

参数:

参数名称参数描述
maxValue表示要设置的最大值。 该值必须大于或等于 0。

Throws:

Throw名称Throw描述
IllegalArgumentException如果参数值小于 0,则抛出此异常。

setMinValue

public void setMinValue(int minValue)

设置数字选择器的最小值。

参数:

参数名称参数描述
minValue表示要设置的最小值。 该值必须大于或等于 0。

Throws:

Throw名称Throw描述
IllegalArgumentException如果参数值小于 0,则抛出此异常。

setNormalTextSize

public void setNormalTextSize(int textSize)

为数字选择器上取消选择的文本设置字体大小。

参数:

参数名称参数描述
textSize指示取消选择文本的字体大小。

Throws:

Throw名称Throw描述
IllegalArgumentException如果参数值不是正数,则引发此异常。

setSelectedTextSize

public void setSelectedTextSize(int textSize)

为数字选择器上的选定文本设置字体大小。

参数:

参数名称参数描述
textSize指示所选文本的字体大小。

Throws:

Throw名称Throw描述
IllegalArgumentException如果参数值不是正数,则引发此异常。

setNormalTextColor

public void setNormalTextColor(Color color)

为数字选择器上取消选择的文本设置颜色。

参数:

参数名称参数描述
color指示取消选择文本的颜色。

Throws:

Throw名称Throw描述
IllegalArgumentException如果参数值为 null,则引发此异常。

setSelectedTextColor

public void setSelectedTextColor(Color color)

为数字选择器上的选定文本设置颜色。

参数:

参数名称参数描述
color指示所选文本的颜色。

Throws:

Throw名称Throw描述
IllegalArgumentException如果参数值为 null,则引发此异常。

setNormalTextFont

public void setNormalTextFont(Font font)

设置此选择器中普通文本的字体。

参数:

参数名称参数描述
font指示要设置的字体。

Since:

4

getNormalTextFont

public Font getNormalTextFont()

获取此选取器中普通文本的字体。

返回:

返回字体。

Since:

4

setSelectedTextFont

public void setSelectedTextFont(Font font)

设置此选取器中选定文本的字体。

参数:

参数名称参数描述
font指示要设置的字体。

Since:

4

getSelectedTextFont

public Font getSelectedTextFont()

获取此选取器中选定文本的字体。

返回:

返回所选文本的字体。

Since:

4

setSelectedNormalTextMarginRatio

public void setSelectedNormalTextMarginRatio(float textMarginRatio)

在此数字选择器中设置所选文本边距与正常文本边距的比率。

参数:

参数名称参数描述
textMarginRatio表示要设置的比率。 该值必须大于或等于 0.0f。 默认值为 1.0f。

Throws:

Throw名称Throw描述
IllegalArgumentException如果参数值小于 0.0f,则抛出此异常。

setShaderColor

public void setShaderColor(Color color)

为数字选择器设置着色器颜色。

参数:

参数名称参数描述
color指示数字选择器的着色器颜色。

Throws:

Throw名称Throw描述
IllegalArgumentException如果参数值为 null,则引发此异常。

setWheelModeEnabled

public boolean setWheelModeEnabled(boolean isEnabled)

设置Selector Wheel模式,该模式确定Picker#GetMinvalue()和Picker#getMaxValue()的值是否在最大范围内滚动滚动时彼此相邻显示。

默认情况下,如果最大值和最小值之间的数字的数量小于选择器上可以显示的数字的总数,则在滚动选择器时,最大值和最小值并排显示 它的最大程度。

参数:

参数名称参数描述
isEnabled指示是否启用选择轮模式。

返回:

如果启用了选择轮模式,则返回 true; 否则返回 false。

Since:

4

setDisplayedData

public void setDisplayedData(String[] displayedData)

设置要显示的字符串数组。

该方法可以使不能直接显示数字的控件以字符串的形式显示数字。 字符串的长度必须等于取值范围内取值的总数。

参数:

参数名称参数描述
displayedData表示要显示的字符串数组。

Since:

4

setFormatter

public void setFormatter(Picker.Formatter formatter)

设置格式化程序以标准化显示的内容。

如果您设置了数字以字符串的形式显示,格式化程序将不会生效。

参数:

参数名称参数描述
formatter表示格式化程序。

getFormatter

public Picker.Formatter getFormatter()

获取格式化显示内容的格式化程序。

返回:

返回格式化程序。

Since:

4

setDisplayedLinesElements

public void setDisplayedLinesElements(Element top, Element bottom)

设置用于为选定文本绘制分割线的 Element 实例。

参数:

参数名称参数描述
top指示用于在选定文本顶部绘制分割线的 Element 实例。
bottom指示用于在选定文本底部绘制分割线的 Element 实例。

getDisplayedLinesElements

public Element[] getDisplayedLinesElements()

获取用于在选定文本的顶部和底部绘制显示线条的 Element 实例。

返回:

返回元素实例。

Since:

4

setDisplayedLinesTopElement

public void setDisplayedLinesTopElement(Element top)

设置一个 Element 实例,用于在选定文本的顶部绘制一条显示线。

参数:

参数名称参数描述
top指示要设置的 Element 实例。

Since:

4

setDisplayedLinesBottomElement

public void setDisplayedLinesBottomElement(Element bottom)

设置一个 Element 实例,用于在选定文本的底部绘制一条显示线。

参数:

参数名称参数描述
bottom指示要设置的 Element 实例。

Since:

4

setElementFormatter

public void setElementFormatter(Picker.ElementFormatter formatter)

设置格式化程序以格式化显示在每个项目的左侧和右侧的元素内容。

参数:

参数名称参数描述
formatter表示格式化程序。

getElementFormatter

public Picker.ElementFormatter getElementFormatter()

获取每个项目左右显示的Element的格式化程序。

返回:

返回格式化程序。

Since:

4

setSelectedTextBackground

public void setSelectedTextBackground(Element element)

将元素设置为此选择器选择的文本的背景。

参数:

参数名称参数描述
element指示要设置的元素。

Since:

4

getSelectedTextBackgroundElement

public Element getSelectedTextBackgroundElement()

获取元素集作为此选择器选择的文本的背景。

返回:

返回元素。

Since:

4

setCompoundElementPadding

public void setCompoundElementPadding(int padding)

设置文本和元素对象之间的填充。

参数:

参数名称参数描述
padding指示文本和元素对象之间的填充。

setValueChangedListener

public void setValueChangedListener(Picker.ValueChangedListener valueChangedListener)

设置数字选择器的值更改侦听器。

参数:

参数名称参数描述
valueChangedListener表示选取器的值变化监听器。

getValueChangedListener

public Picker.ValueChangedListener getValueChangedListener()

获取监听picker值变化的监听器。

返回:

返回监听器。

Since:

4

setScrollListener

public void setScrollListener(Picker.ScrolledListener scrollListener)

设置选择器的滚动状态侦听器。

参数:

参数名称参数描述
scrollListener表示数字选择器的滚动状态监听器。

getScrollListener

public Picker.ScrolledListener getScrollListener()

获取监听picker滚动状态的监听器。

返回:

返回监听器。

Since:

4

getSelectorItemNum

public int getSelectorItemNum()

获取选择轮上显示的项目数。

返回:

返回选择轮上显示的项目数。 默认值为 0。

Since:

4

getValue

public int getValue()

获取数字选择器上显示的值。

返回:

返回数字选择器上显示的值。 默认值为 1。

getMaxValue

public int getMaxValue()

获取数字选择器的最大值。

返回:

返回数字选择器的最大值。 默认值为 9。

getMinValue

public int getMinValue()

获取数字选择器的最小值。

返回:

返回数字选择器的最小值。 默认值为 0。

getNormalTextSize

public int getNormalTextSize()

获取数字选择器上取消选择的文本的字体大小。

返回:

返回数字选择器上取消选择的文本的字体大小。

getSelectedTextSize

public int getSelectedTextSize()

获取数字选择器上选定文本的字体大小。

返回:

返回数字选择器上选定文本的字体大小。

getNormalTextColor

public Color getNormalTextColor()

获取数字选择器上取消选择的文本的颜色。

返回:

返回数字选择器上取消选择的文本的颜色。

getSelectedTextColor

public Color getSelectedTextColor()

获取数字选择器上选定文本的颜色。

返回:

返回数字选择器上选定文本的颜色。

getSelectedNormalTextMarginRatio

public float getSelectedNormalTextMarginRatio()

获取此数字选择器中所选文本边距与正常文本边距的比率。

返回:

返回比率。

getShaderColor

public Color getShaderColor()

获取数字选择器的着色器颜色。

返回:

返回数字选择器的着色器颜色。

isWheelModeEnabled

public boolean isWheelModeEnabled()

获取数字选择器的选择器包装模式。

如果启用了选择器环绕模式,则最大值和最小值会在选择轮上彼此相邻显示。

返回:

如果启用了选择器包装模式,则返回 true; 否则返回 false。

Since:

4

getDisplayedData

public String[] getDisplayedData()

获取与要显示的数字匹配的字符串数组。

该方法可以获取每个数字设置为字符串显示后的所有字符串。

返回:

返回与数字匹配的字符串数组。

Since:

4

getDisplayedTopElement

public Element getDisplayedTopElement()

获取用于在选定数字顶部绘制分割线的 Element 实例。

返回:

返回用于在所选数字顶部绘制分割线的 Element 实例。

getDisplayedBottomElement

public Element getDisplayedBottomElement()

获取用于在选定数字底部绘制分割线的 Element 实例。

返回:

返回用于在所选数字底部绘制分割线的 Element 实例。

getCompoundElementPadding

public int getCompoundElementPadding()

获取文本和 Element 对象之间的填充。

返回:

返回文本和元素对象之间的填充。