鸿蒙OS Picker
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 interface | Picker.ElementFormatter | 为 Picker 的每一项格式化左右复合元素对象。 |
| static interface | Picker.Formatter | 格式化 Picker 的值并将其转换为字符串。 |
| static interface | Picker.ScrolledListener | 处理 Picker 实例的滚动事件。 |
| static interface | Picker.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 float | ROTATION_SENSITIVITY_DEFAULT | 指示 Picker 响应旋转表冠事件的默认旋转灵敏度。 |
| static float | ROTATION_SENSITIVITY_HIGH | 表示 Picker 响应旋转表冠事件的高旋转灵敏度。 |
| static float | ROTATION_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 实例的构造函数。 |
方法总结
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| int | getCompoundElementPadding() | 获取文本和 Element 对象之间的填充。 |
| Element | getDisplayedBottomElement() | 获取用于在选定数字底部绘制分割线的 Element 实例。 |
| String[] | getDisplayedData() | 获取与要显示的数字匹配的字符串数组。 |
| Element[] | getDisplayedLinesElements() | 获取用于在选定文本的顶部和底部绘制显示线条的 Element 实例。 |
| Element | getDisplayedTopElement() | 获取用于在选定数字顶部绘制分割线的 Element 实例。 |
| Picker.ElementFormatter | getElementFormatter() | 获取每个项目左右显示的Element的格式化程序。 |
| Picker.Formatter | getFormatter() | 获取格式化显示内容的格式化程序。 |
| int | getMaxValue() | 获取数字选择器的最大值。 |
| int | getMinValue() | 获取数字选择器的最小值。 |
| Color | getNormalTextColor() | 获取数字选择器上取消选择的文本的颜色。 |
| Font | getNormalTextFont() | 获取此选取器中普通文本的字体。 |
| int | getNormalTextSize() | 获取数字选择器上取消选择的文本的字体大小。 |
| Picker.ScrolledListener | getScrollListener() | 获取监听picker滚动状态的监听器。 |
| float | getSelectedNormalTextMarginRatio() | 获取此数字选择器中所选文本边距与正常文本边距的比率。 |
| Element | getSelectedTextBackgroundElement() | 获取元素集作为此选择器选择的文本的背景。 |
| Color | getSelectedTextColor() | 获取数字选择器上选定文本的颜色。 |
| Font | getSelectedTextFont() | 获取此选取器中选定文本的字体。 |
| int | getSelectedTextSize() | 获取数字选择器上选定文本的字体大小。 |
| int | getSelectorItemNum() | 获取选择轮上显示的项目数。 |
| Color | getShaderColor() | 获取数字选择器的着色器颜色。 |
| int | getValue() | 获取数字选择器上显示的值。 |
| Picker.ValueChangedListener | getValueChangedListener() | 获取监听picker值变化的监听器。 |
| boolean | isWheelModeEnabled() | 获取数字选择器的选择器包装模式。 |
| void | setCompoundElementPadding(int padding) | 设置文本和元素对象之间的填充。 |
| void | setDisplayedData(String[] displayedData) | 设置要显示的字符串数组。 |
| void | setDisplayedLinesBottomElement(Element bottom) | 设置一个 Element 实例，用于在选定文本的底部绘制一条显示线。 |
| void | setDisplayedLinesElements(Element top, Element bottom) | 设置用于为选定文本绘制分割线的 Element 实例。 |
| void | setDisplayedLinesTopElement(Element top) | 设置一个 Element 实例，用于在选定文本的顶部绘制一条显示线。 |
| void | setElementFormatter(Picker.ElementFormatter formatter) | 设置格式化程序以格式化显示在每个项目的左侧和右侧的元素内容。 |
| void | setFormatter(Picker.Formatter formatter) | 设置格式化程序以标准化显示的内容。 |
| void | setMaxValue(int maxValue) | 设置数字选择器的最大值。 |
| void | setMinValue(int minValue) | 设置数字选择器的最小值。 |
| void | setNormalTextColor(Color color) | 为数字选择器上取消选择的文本设置颜色。 |
| void | setNormalTextFont(Font font) | 设置此选择器中普通文本的字体。 |
| void | setNormalTextSize(int textSize) | 为数字选择器上取消选择的文本设置字体大小。 |
| void | setScrollListener(Picker.ScrolledListener scrollListener) | 设置选择器的滚动状态侦听器。 |
| void | setSelectedNormalTextMarginRatio(float textMarginRatio) | 在此数字选择器中设置所选文本边距与正常文本边距的比率。 |
| void | setSelectedTextBackground(Element element) | 将元素设置为此选择器选择的文本的背景。 |
| void | setSelectedTextColor(Color color) | 为数字选择器上的选定文本设置颜色。 |
| void | setSelectedTextFont(Font font) | 设置此选取器中选定文本的字体。 |
| void | setSelectedTextSize(int textSize) | 为数字选择器上的选定文本设置字体大小。 |
| void | setSelectorItemNum(int itemNum) | 设置要在选择器上显示的项目数。 |
| void | setShaderColor(Color color) | 为数字选择器设置着色器颜色。 |
| void | setValue(int value) | 设置数字选择器上的当前值。 |
| void | setValueChangedListener(Picker.ValueChangedListener valueChangedListener) | 设置数字选择器的值更改侦听器。 |
| boolean | setWheelModeEnabled(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 对象之间的填充。
返回:
返回文本和元素对象之间的填充。
更多建议：