Picker

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

所有已实现的接口:

ComponentParent
```
public class Picker
extends DirectionalLayout
```
Provides a number picker that allows number selection from a predefined range.
This class configures the attributes of the number picker so that users can select a specific number within the value range on the screen.

从以下版本开始:

3

嵌套类概要

嵌套类
限定符和类型	类	说明
`static interface`	`Picker.ElementFormatter`	Formats the left and right compound element objects for every item of `Picker`.
`static interface`	`Picker.Formatter`	Formats the value of `Picker` and converts it into a string.
`static interface`	`Picker.ScrolledListener`	Processes scroll events of a `Picker` instance.
`static interface`	`Picker.ValueChangedListener`	Listens for value change events of a `Picker` instance.

从类继承的嵌套类/接口 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`	Indicates the default rotation sensitivity of `Picker` to respond to rotating crown events.
`static float`	`ROTATION_SENSITIVITY_HIGH`	Indicates the high rotation sensitivity of `Picker` to respond to rotating crown events.
`static float`	`ROTATION_SENSITIVITY_LOW`	Indicates the low rotation sensitivity of `Picker` to respond to rotating crown events.

从类继承的字段 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)`	Default constructor used to create a `Picker` instance by using the default attribute set and style.
`Picker(Context context, AttrSet attrSet)`	A constructor used to create a `Picker` instance by using specified attribute set and default style after the XML file is parsed.
`Picker(Context context, AttrSet attrSet, String styleName)`	A constructor used to create a `Picker` instance by using specified attribute set and specified style after the XML file is parsed.

方法概要

所有方法实例方法具体方法
限定符和类型	方法	说明
`int`	`getCompoundElementPadding()`	Obtains the padding between the text and `Element` objects.
`Element`	`getDisplayedBottomElement()`	Obtains the `Element` instance used to draw the split line at the bottom of a selected number.
`String[]`	`getDisplayedData()`	Obtains the string array matching the numbers to display.
`Element[]`	`getDisplayedLinesElements()`	Obtains the `Element` instance used to draw displayed lines at the top and bottom of selected text.
`Element`	`getDisplayedTopElement()`	Obtains the `Element` instance used to draw the split line on the top of a selected number.
`Picker.ElementFormatter`	`getElementFormatter()`	Obtains the formatter of the `Element` displayed on the left and right of each item.
`Picker.Formatter`	`getFormatter()`	Obtains the formatter for formatting the displayed content.
`int`	`getMaxValue()`	Obtains the maximum value of the number picker.
`int`	`getMinValue()`	Obtains the minimum value of the number picker.
`Color`	`getNormalTextColor()`	Obtains the color of deselected text on a number picker.
`Font`	`getNormalTextFont()`	Obtains the font of the normal text in this picker.
`int`	`getNormalTextSize()`	Obtains the font size of deselected text on a number picker.
`Picker.ScrolledListener`	`getScrollListener()`	Obtains the listener for monitoring the picker scrolling status.
`float`	`getSelectedNormalTextMarginRatio()`	Obtains the ratio of the selected to normal text margin in this number picker.
`Element`	`getSelectedTextBackgroundElement()`	Obtains the `Element` set as the background of the text selected by this picker.
`Color`	`getSelectedTextColor()`	Obtains the color of selected text on a number picker.
`Font`	`getSelectedTextFont()`	Obtains the font of the selected text in this picker.
`int`	`getSelectedTextSize()`	Obtains the font size of selected text on a number picker.
`int`	`getSelectorItemNum()`	Obtains the number of items displayed on a selector wheel.
`Color`	`getShaderColor()`	Obtains the shader color of a number picker.
`int`	`getValue()`	Obtains the value displayed on the number picker.
`Picker.ValueChangedListener`	`getValueChangedListener()`	Obtains the listener for monitoring picker value changes.
`boolean`	`isWheelModeEnabled()`	Obtains the selector wrapping mode of a number picker.
`void`	`setCompoundElementPadding(int padding)`	Sets the padding between text and `Element` objects.
`void`	`setDisplayedData(String[] displayedData)`	Sets the string array to be displayed.
`void`	`setDisplayedLinesBottomElement(Element bottom)`	Sets an `Element` instance used to draw a displayed line at the bottom of selected text.
`void`	`setDisplayedLinesElements(Element top, Element bottom)`	Sets a `Element` instance used to draw the split line for selected text.
`void`	`setDisplayedLinesTopElement(Element top)`	Sets an `Element` instance used to draw a displayed line at the top of selected text.
`void`	`setElementFormatter(Picker.ElementFormatter formatter)`	Sets a formatter to format the `Element` contents displayed on the left and right of every item.
`void`	`setFormatter(Picker.Formatter formatter)`	Sets a formatter to standardize the displayed content.
`void`	`setMaxValue(int maxValue)`	Sets the maximum value of the number picker.
`void`	`setMinValue(int minValue)`	Sets the minimum value of the number picker.
`void`	`setNormalTextColor(Color color)`	Sets a color for deselected text on the number picker.
`void`	`setNormalTextFont(Font font)`	Sets the font for the normal text in this picker.
`void`	`setNormalTextSize(int textSize)`	Sets a font size for deselected text on the number picker.
`void`	`setScrollListener(Picker.ScrolledListener scrollListener)`	Sets the scroll state listener for a picker.
`void`	`setSelectedNormalTextMarginRatio(float textMarginRatio)`	Sets the ratio of the selected to normal text margin in this number picker.
`void`	`setSelectedTextBackground(Element element)`	Sets an `Element` as the background of the text selected by this picker.
`void`	`setSelectedTextColor(Color color)`	Sets a color for selected text on the number picker.
`void`	`setSelectedTextFont(Font font)`	Sets the font for the selected text in this picker.
`void`	`setSelectedTextSize(int textSize)`	Sets a font size for selected text on the number picker.
`void`	`setSelectorItemNum(int itemNum)`	Sets the number of items to display on a selector.
`void`	`setShaderColor(Color color)`	Sets a shader color for the number picker.
`void`	`setValue(int value)`	Sets the current value on the number picker.
`void`	`setValueChangedListener(Picker.ValueChangedListener valueChangedListener)`	Sets the value change listener for a number picker.
`boolean`	`setWheelModeEnabled(boolean isEnabled)`	Sets the selector wheel mode, which determines whether the values of `Picker#getMinValue()` and `Picker#getMaxValue()` are displayed next to each other when the selector is scrolled to its furthest extent.

从类继承的方法 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.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
```
    Indicates the default rotation sensitivity of Picker to respond to rotating crown events. You can use Component.setRotationSensitivity(float) to set.
    
    另请参阅:
    
    常量字段值
  - ROTATION_SENSITIVITY_HIGH
```
public static final float ROTATION_SENSITIVITY_HIGH
```
    Indicates the high rotation sensitivity of Picker to respond to rotating crown events. You can use Component.setRotationSensitivity(float) to set.
    
    另请参阅:
    
    常量字段值
  - ROTATION_SENSITIVITY_LOW
```
public static final float ROTATION_SENSITIVITY_LOW
```
    Indicates the low rotation sensitivity of Picker to respond to rotating crown events. You can use Component.setRotationSensitivity(float) to set.
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - Picker
```
public Picker(Context context)
```
    Default constructor used to create a Picker instance by using the default attribute set and style.
    
    参数:
    
    context - Indicates the application context.
  - Picker
```
public Picker(Context context,
              AttrSet attrSet)
```
    A constructor used to create a Picker instance by using specified attribute set and default style after the XML file is parsed.
    
    参数:
    
    context - Indicates the application context.
    
    attrSet - Indicates the attribute set to be used.
  - Picker
```
public Picker(Context context,
              AttrSet attrSet,
              String styleName)
```
    A constructor used to create a Picker instance by using specified attribute set and specified style after the XML file is parsed.
    
    参数:
    
    context - Indicates the application context.
    
    attrSet - Indicates the attribute set to be used.
    
    styleName - Indicates the style name to use.
- 方法详细资料
  - setSelectorItemNum
```
public void setSelectorItemNum(int itemNum)
```
    Sets the number of items to display on a selector.
    
    参数:
    
    itemNum - Indicates the number of items to display on the selector.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the quantity of items to display on the number selector is less than or equal to 0.
    
    从以下版本开始:
    
    4
  - setValue
```
public void setValue(int value)
```
    Sets the current value on the number picker.
    If value is less than Picker#getMinValue() and Picker#isWheelModeEnabled() is set to false, the current value is the one obtained by Picker#getMinValue().
    If value is less than Picker#getMinValue() and Picker#isWheelModeEnabled() is set to true, the current value is the one obtained by Picker#getMaxValue().
    If value is greater than Picker#getMaxValue() and Picker#isWheelModeEnabled() is set to false, the current value is the one obtained by Picker#getMaxValue().
    If value is greater than Picker#getMaxValue() and Picker#isWheelModeEnabled() is set to true, the current value is the one obtained by Picker#getMinValue().
    
    参数:
    
    value - Indicates the current value to set.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the parameter value is less than 0.
    
    另请参阅:
    
    setMinValue(int), setMaxValue(int)
  - setMaxValue
```
public void setMaxValue(int maxValue)
```
    Sets the maximum value of the number picker.
    
    参数:
    
    maxValue - Indicates the maximum value to set. The value must be greater than or equal to 0.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the parameter value is less than 0.
  - setMinValue
```
public void setMinValue(int minValue)
```
    Sets the minimum value of the number picker.
    
    参数:
    
    minValue - Indicates the minimum value to set. The value must be greater than or equal to 0.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the parameter value is less than 0.
  - setNormalTextSize
```
public void setNormalTextSize(int textSize)
```
    Sets a font size for deselected text on the number picker.
    
    参数:
    
    textSize - Indicates the font size of deselected text.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the parameter value isn't positive.
  - setSelectedTextSize
```
public void setSelectedTextSize(int textSize)
```
    Sets a font size for selected text on the number picker.
    
    参数:
    
    textSize - Indicates the font size of selected text.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the parameter value isn't positive.
  - setNormalTextColor
```
public void setNormalTextColor(Color color)
```
    Sets a color for deselected text on the number picker.
    
    参数:
    
    color - Indicates the color of deselected text.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the parameter value is null.
  - setSelectedTextColor
```
public void setSelectedTextColor(Color color)
```
    Sets a color for selected text on the number picker.
    
    参数:
    
    color - Indicates the color of selected text.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the parameter value is null.
  - setNormalTextFont
```
public void setNormalTextFont(Font font)
```
    Sets the font for the normal text in this picker.
    
    参数:
    
    font - Indicates the font to set. For details, see Font.
    
    从以下版本开始:
    
    4
  - getNormalTextFont
```
public Font getNormalTextFont()
```
    Obtains the font of the normal text in this picker.
    
    返回:
    
    Returns the font.
    
    从以下版本开始:
    
    4
  - setSelectedTextFont
```
public void setSelectedTextFont(Font font)
```
    Sets the font for the selected text in this picker.
    
    参数:
    
    font - Indicates the font to set. For details, see Font.
    
    从以下版本开始:
    
    4
  - getSelectedTextFont
```
public Font getSelectedTextFont()
```
    Obtains the font of the selected text in this picker.
    
    返回:
    
    Returns the font of the selected text.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setSelectedTextFont(Font)
  - setSelectedNormalTextMarginRatio
```
public void setSelectedNormalTextMarginRatio(float textMarginRatio)
```
    Sets the ratio of the selected to normal text margin in this number picker.
    
    参数:
    
    textMarginRatio - Indicates the ratio to set. The value must be greater than or equal to 0.0f. The default value is 1.0f.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the parameter value is less than 0.0f.
    
    另请参阅:
    
    getSelectedNormalTextMarginRatio()
  - setShaderColor
```
public void setShaderColor(Color color)
```
    Sets a shader color for the number picker.
    
    参数:
    
    color - Indicates the shader color of the number picker.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the parameter value is null.
    
    另请参阅:
    
    getShaderColor()
  - setWheelModeEnabled
```
public boolean setWheelModeEnabled(boolean isEnabled)
```
    Sets the selector wheel mode, which determines whether the values of Picker#getMinValue() and Picker#getMaxValue() are displayed next to each other when the selector is scrolled to its furthest extent.
    By default, if the quantity of the numbers between the maximum value and the minimum value is less than the total quantity of numbers that can be displayed on the selector, the maximum and minimum values are displayed next to each other when the selector is scrolled to its furthest extent.
    
    参数:
    
    isEnabled - Indicates whether selector wheel mode is enabled.
    
    返回:
    
    Returns true if selector wheel mode is enabled; returns false otherwise.
    
    从以下版本开始:
    
    4
  - setDisplayedData
```
public void setDisplayedData(String[] displayedData)
```
    Sets the string array to be displayed.
    This method enables numbers to be display in the form of character strings for controls that cannot display numbers directly. The length of the character string must be equal to the total number of values within the value range.
    
    参数:
    
    displayedData - Indicates the string array to be displayed.
    
    从以下版本开始:
    
    4
  - setFormatter
```
public void setFormatter(Picker.Formatter formatter)
```
    Sets a formatter to standardize the displayed content.
    If you have set the numbers to be displayed in the form of character strings, the formatter will not take effect.
    
    参数:
    
    formatter - Indicates the formatter.
  - getFormatter
```
public Picker.Formatter getFormatter()
```
    Obtains the formatter for formatting the displayed content.
    
    返回:
    
    Returns the formatter.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setFormatter(Formatter)
  - setDisplayedLinesElements
```
public void setDisplayedLinesElements(Element top,
                                      Element bottom)
```
    Sets a Element instance used to draw the split line for selected text.
    
    参数:
    
    top - Indicates the Element instance used to draw the split line on the top of selected text.
    
    bottom - Indicates the Element instance used to draw the split line at the bottom of selected text.
    
    另请参阅:
    
    getDisplayedTopElement(), getDisplayedBottomElement()
  - getDisplayedLinesElements
```
public Element[] getDisplayedLinesElements()
```
    Obtains the Element instance used to draw displayed lines at the top and bottom of selected text.
    
    返回:
    
    Returns the Element instance.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setDisplayedLinesElements(Element, Element)
  - setDisplayedLinesTopElement
```
public void setDisplayedLinesTopElement(Element top)
```
    Sets an Element instance used to draw a displayed line at the top of selected text.
    
    参数:
    
    top - Indicates the Element instance to set.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    getDisplayedTopElement()
  - setDisplayedLinesBottomElement
```
public void setDisplayedLinesBottomElement(Element bottom)
```
    Sets an Element instance used to draw a displayed line at the bottom of selected text.
    
    参数:
    
    bottom - Indicates the Element instance to set.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    getDisplayedBottomElement()
  - setElementFormatter
```
public void setElementFormatter(Picker.ElementFormatter formatter)
```
    Sets a formatter to format the Element contents displayed on the left and right of every item.
    
    参数:
    
    formatter - Indicates the formatter.
  - getElementFormatter
```
public Picker.ElementFormatter getElementFormatter()
```
    Obtains the formatter of the Element displayed on the left and right of each item.
    
    返回:
    
    Returns the formatter.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    getElementFormatter()
  - setSelectedTextBackground
```
public void setSelectedTextBackground(Element element)
```
    Sets an Element as the background of the text selected by this picker.
    
    参数:
    
    element - Indicates the Element to set.
    
    从以下版本开始:
    
    4
  - getSelectedTextBackgroundElement
```
public Element getSelectedTextBackgroundElement()
```
    Obtains the Element set as the background of the text selected by this picker.
    
    返回:
    
    Returns the Element.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setSelectedTextBackground(Element)
  - setCompoundElementPadding
```
public void setCompoundElementPadding(int padding)
```
    Sets the padding between text and Element objects.
    
    参数:
    
    padding - Indicates the padding between text and Element objects.
    
    另请参阅:
    
    getCompoundElementPadding()
  - setValueChangedListener
```
public void setValueChangedListener(Picker.ValueChangedListener valueChangedListener)
```
    Sets the value change listener for a number picker.
    
    参数:
    
    valueChangedListener - Indicates the value change listener of the picker.
  - getValueChangedListener
```
public Picker.ValueChangedListener getValueChangedListener()
```
    Obtains the listener for monitoring picker value changes.
    
    返回:
    
    Returns the listener.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setValueChangedListener(ValueChangedListener)
  - setScrollListener
```
public void setScrollListener(Picker.ScrolledListener scrollListener)
```
    Sets the scroll state listener for a picker.
    
    参数:
    
    scrollListener - Indicates the scroll state listener of the number picker.
  - getScrollListener
```
public Picker.ScrolledListener getScrollListener()
```
    Obtains the listener for monitoring the picker scrolling status.
    
    返回:
    
    Returns the listener.
    
    从以下版本开始:
    
    4
    
    另请参阅:
    
    setScrollListener(ScrolledListener)
  - getSelectorItemNum
```
public int getSelectorItemNum()
```
    Obtains the number of items displayed on a selector wheel.
    
    返回:
    
    Returns the number of items displayed on the selector wheel. The default value is 0.
    
    从以下版本开始:
    
    4
  - getValue
```
public int getValue()
```
    Obtains the value displayed on the number picker.
    
    返回:
    
    Returns the value displayed on the number picker. The default value is 1.
  - getMaxValue
```
public int getMaxValue()
```
    Obtains the maximum value of the number picker.
    
    返回:
    
    Returns the maximum value of the number picker. The default value is 9.
  - getMinValue
```
public int getMinValue()
```
    Obtains the minimum value of the number picker.
    
    返回:
    
    Returns the minimum value of the number picker. The default value is 0.
  - getNormalTextSize
```
public int getNormalTextSize()
```
    Obtains the font size of deselected text on a number picker.
    
    返回:
    
    Returns the font size of deselected text on the number picker.
  - getSelectedTextSize
```
public int getSelectedTextSize()
```
    Obtains the font size of selected text on a number picker.
    
    返回:
    
    Returns the font size of selected text on the number picker.
  - getNormalTextColor
```
public Color getNormalTextColor()
```
    Obtains the color of deselected text on a number picker.
    
    返回:
    
    Returns the color of deselected text on the number picker.
  - getSelectedTextColor
```
public Color getSelectedTextColor()
```
    Obtains the color of selected text on a number picker.
    
    返回:
    
    Returns the color of selected text on the number picker.
  - getSelectedNormalTextMarginRatio
```
public float getSelectedNormalTextMarginRatio()
```
    Obtains the ratio of the selected to normal text margin in this number picker.
    
    返回:
    
    Returns the ratio.
    
    另请参阅:
    
    setSelectedNormalTextMarginRatio(float)
  - getShaderColor
```
public Color getShaderColor()
```
    Obtains the shader color of a number picker.
    
    返回:
    
    Returns the shader color of the number picker.
    
    另请参阅:
    
    setShaderColor(Color)
  - isWheelModeEnabled
```
public boolean isWheelModeEnabled()
```
    Obtains the selector wrapping mode of a number picker.
    If selector wrapping mode is enabled, the maximum and minimum values are displayed next to each other on the selector wheel.
    
    返回:
    
    Returns true if selector wrapping mode is enabled; returns false otherwise.
    
    从以下版本开始:
    
    4
  - getDisplayedData
```
public String[] getDisplayedData()
```
    Obtains the string array matching the numbers to display.
    This method can obtain all character strings after each number is set to be displayed as a character string.
    
    返回:
    
    Returns the character string array matching the numbers.
    
    从以下版本开始:
    
    4
  - getDisplayedTopElement
```
public Element getDisplayedTopElement()
```
    Obtains the Element instance used to draw the split line on the top of a selected number.
    
    返回:
    
    Returns the Element instance used to draw the split line on the top of the selected number.
    
    另请参阅:
    
    setDisplayedLinesElements(Element, Element)
  - getDisplayedBottomElement
```
public Element getDisplayedBottomElement()
```
    Obtains the Element instance used to draw the split line at the bottom of a selected number.
    
    返回:
    
    Returns the Element instance used to draw the split line at the bottom of the selected number.
    
    另请参阅:
    
    setDisplayedLinesElements(Element, Element)
  - getCompoundElementPadding
```
public int getCompoundElementPadding()
```
    Obtains the padding between the text and Element objects.
    
    返回:
    
    Returns the padding between text and Element objects.
    
    另请参阅:
    
    setCompoundElementPadding(int)

类 Picker

嵌套类概要

从类继承的嵌套类/接口 ohos.agp.components.Component

从类继承的嵌套类/接口 ohos.agp.components.ComponentContainer

从类继承的嵌套类/接口 ohos.agp.components.DirectionalLayout

字段概要

从类继承的字段 ohos.agp.components.Component

从类继承的字段 ohos.agp.components.ComponentContainer

构造器概要

方法概要

从类继承的方法 ohos.agp.components.Component

从类继承的方法 ohos.agp.components.ComponentContainer

从接口继承的方法 ohos.agp.components.ComponentParent

从类继承的方法 ohos.agp.components.DirectionalLayout

从类继承的方法 java.lang.Object

字段详细资料

ROTATION_SENSITIVITY_DEFAULT

ROTATION_SENSITIVITY_HIGH

ROTATION_SENSITIVITY_LOW

构造器详细资料

Picker

Picker

Picker

方法详细资料

setSelectorItemNum

setValue

setMaxValue

setMinValue

setNormalTextSize

setSelectedTextSize

setNormalTextColor

setSelectedTextColor

setNormalTextFont

getNormalTextFont

setSelectedTextFont

getSelectedTextFont

setSelectedNormalTextMarginRatio

setShaderColor

setWheelModeEnabled

setDisplayedData

setFormatter

getFormatter

setDisplayedLinesElements

getDisplayedLinesElements

setDisplayedLinesTopElement

setDisplayedLinesBottomElement

setElementFormatter

getElementFormatter

setSelectedTextBackground

getSelectedTextBackgroundElement

setCompoundElementPadding

setValueChangedListener

getValueChangedListener

setScrollListener

getScrollListener

getSelectorItemNum

getValue

getMaxValue

getMinValue

getNormalTextSize

getSelectedTextSize

getNormalTextColor

getSelectedTextColor

getSelectedNormalTextMarginRatio

getShaderColor

isWheelModeEnabled

getDisplayedData

getDisplayedTopElement

getDisplayedBottomElement

getCompoundElementPadding