Picker (Codename One API)

java.lang.Object
- com.codename1.ui.Component
- - com.codename1.ui.Label
  - - com.codename1.ui.Button
    - - com.codename1.ui.spinner.Picker

All Implemented Interfaces:

Animation, Editable, ActionSource, StyleListener, IconHolder, ReleasableComponent, SelectableIconHolder, TextHolder
```
public class Picker
extends Button
```
Picker is a component and API that allows either popping up a spinner or using the native picker API when applicable. This is quite important for some platforms where the native spinner behavior is very hard to replicate.

Field Summary
- Fields inherited from class com.codename1.ui.Button
  STATE_DEFAULT, STATE_PRESSED, STATE_ROLLOVER
- Fields inherited from class com.codename1.ui.Component
  BASELINE, BOTTOM, BRB_CENTER_OFFSET, BRB_CONSTANT_ASCENT, BRB_CONSTANT_DESCENT, BRB_OTHER, CENTER, CROSSHAIR_CURSOR, DEFAULT_CURSOR, DRAG_REGION_IMMEDIATELY_DRAG_X, DRAG_REGION_IMMEDIATELY_DRAG_XY, DRAG_REGION_IMMEDIATELY_DRAG_Y, DRAG_REGION_LIKELY_DRAG_X, DRAG_REGION_LIKELY_DRAG_XY, DRAG_REGION_LIKELY_DRAG_Y, DRAG_REGION_NOT_DRAGGABLE, DRAG_REGION_POSSIBLE_DRAG_X, DRAG_REGION_POSSIBLE_DRAG_XY, DRAG_REGION_POSSIBLE_DRAG_Y, E_RESIZE_CURSOR, HAND_CURSOR, LEFT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NW_RESIZE_CURSOR, RIGHT, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, TOP, W_RESIZE_CURSOR, WAIT_CURSOR

Constructor Summary

Constructors
Constructor and Description

Picker()
Default constructor

Constructors
Constructor and Description
`Picker()` Default constructor

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Date`	`getDate()` Returns the date, this value is used both for type date/date and time.
`long`	`getDuration()` This value is used for the duration type.
`int`	`getDurationHours()` Gets the duration hours.
`int`	`getDurationMinutes()` Gets the duration minutes.
`Date`	`getEndDate()` Gets the end date of the picker.
`SimpleDateFormat`	`getFormatter()` Allows us to define a date format for the display of dates/times
`int`	`getMaxHour()` Gets the minimum hour to show for time and datetime pickers.
`int`	`getMinHour()` Gets the minimum hour to show for time and datetime pickers.
`int`	`getPreferredPopupHeight()` The preferred height of the popup dialog.
`int`	`getPreferredPopupWidth()` The preferred width of the popup dialog.
`String[]`	`getPropertyNames()` A component may expose mutable property names for a UI designer to manipulate, this API is designed for usage internally by the GUI builder code
`String[]`	`getPropertyTypeNames()` This method is here to workaround an XMLVM array type bug where property types aren't identified properly, it returns the names of the types using the following type names: String,int,double,long,byte,short,char,String[],String[][],byte[],Image,Image[],Object[],ListModel,ListCellRenderer
`Class[]`	`getPropertyTypes()` Matches the property names method (see that method for further details).
`Object`	`getPropertyValue(String name)` Returns the current value of the property name, this method is used by the GUI builder
`Object`	`getRenderingPrototype()` When using a lightweight spinner this will be used as the rendering prototype
`String`	`getSelectedString()` Returns the current string
`int`	`getSelectedStringIndex()` Returns the index of the selected string
`Date`	`getStartDate()` Gets the start date of the picker.
`String[]`	`getStrings()` Returns the String array matching the metadata
`Style`	`getStyle()` Returns the current Component Style allowing code to draw the current component, you should normally use getUnselected/Pressed/DisabledStyle() and not this method since it will return different values based on component state.
`int`	`getTime()` This value is only used for time type and is ignored in the case of date and time where both are embedded within the date.
`int`	`getType()` Returns the type of the picker
`Object`	`getValue()` Returns the value which works for all picker types
`static boolean`	`isDefaultUseLightweightPopup()` Whether useLightweightPopup should default to true, this can be set via the theme constant `lightweightPickerBool`
`boolean`	`isEditable()` Checks to see if the component is editable.
`boolean`	`isEditing()` Checks if the component is currently being edited.
`boolean`	`isShowMeridiem()` Indicates whether hours should be rendered as AM/PM or 24hr format
`boolean`	`isUseLightweightPopup()` Checks if this picker is in lightweight mode.
`void`	`paint(Graphics g)` This method paints the Component on the screen, it should be overriden by subclasses to perform custom drawing or invoke the UI API's to let the PLAF perform the rendering.
`void`	`setDate(Date d)` Sets the date, this value is used both for type date/date and time.
`static void`	`setDefaultUseLightweightPopup(boolean aDefaultUseLightweightPopup)` Whether useLightweightPopup should default to true, this can be set via the theme constant `lightweightPickerBool`
`void`	`setDuration(int hour, int minute)` Convenience method for setting duration in hours and minutes.
`void`	`setDuration(long duration)` This value is only used for duration type.
`void`	`setEndDate(Date end)` Sets the end date of the picker.
`void`	`setFormatter(SimpleDateFormat formatter)` Allows us to define a date format for the display of dates/times
`void`	`setHourRange(int min, int max)` Sets the hour range for this picker.
`void`	`setMinuteStep(int step)` Sets the minute step size for PICKER_TYPE_DURATION, and PICKER_TYPE_DURATION_TIME types.
`void`	`setPreferredPopupHeight(int height)` The preferred height of the popup dialog for the picker.
`void`	`setPreferredPopupWidth(int width)` The preferred width of the popup dialog for the picker.
`String`	`setPropertyValue(String name, Object value)` Sets a new value to the given property, returns an error message if failed and null if successful.
`void`	`setRenderingPrototype(Object renderingPrototype)` When using a lightweight spinner this will be used as the rendering prototype
`void`	`setSelectedString(String str)` Sets the current value in a string array picker
`void`	`setSelectedStringIndex(int index)` Returns the index of the selected string
`void`	`setShowMeridiem(boolean showMeridiem)` Indicates whether hours should be rendered as AM/PM or 24hr format
`void`	`setStartDate(Date start)` Sets the start date of the picker.
`void`	`setStrings(String... strs)` Sets the string entries for the string picker.
`void`	`setTime(int time)` This value is only used for time type and is ignored in the case of date and time where both are embedded within the date.
`void`	`setTime(int hour, int minute)` Convenience method equivalent to invoking setTime(hour * 60 + minute);
`void`	`setType(int type)` Sets the type of the picker to one of Display.PICKER_TYPE_DATE, Display.PICKER_TYPE_DATE_AND_TIME, Display.PICKER_TYPE_STRINGS, Display.PICKER_TYPE_DURATION, Display.PICKER_TYPE_DURATION_HOURS, Display.PICKER_TYPE_DURATION_MINUTES or Display.PICKER_TYPE_TIME
`void`	`setUseLightweightPopup(boolean useLightweightPopup)` Sets the picker to use lightweight mode for its widgets.
`void`	`startEditingAsync()` If the component `Component.isEditable()`, then this will start the editing process.
`void`	`stopEditing(Runnable onFinish)` Stops the editing process.
`protected void`	`updateValue()` Updates the display value of the picker, subclasses can override this to invoke set text with the right value

Methods inherited from class com.codename1.ui.Button
addActionListener, addStateChangeListener, animate, bindStateTo, calcPreferredSize, dragInitiated, fireActionEvent, fireClicked, getActionListeners, getBorder, getCommand, getDisabledIcon, getIconFromState, getListeners, getPressedIcon, getReleaseRadius, getRolloverIcon, getRolloverPressedIcon, getState, isAutoRelease, isButtonRippleEffectDefault, isCapsText, isCapsTextDefault, isOppositeSide, isSelectableInteraction, isSelected, isToggle, keyPressed, keyReleased, keyRepeated, pointerHover, pointerHoverReleased, pointerPressed, pointerReleased, pressed, released, released, removeActionListener, removeStateChangeListener, resetFocusable, setAlignment, setAutoRelease, setButtonRippleEffectDefault, setCapsText, setCapsTextDefault, setCommand, setDisabledIcon, setPressedIcon, setReleased, setReleaseRadius, setRolloverIcon, setRolloverPressedIcon, setText, setToggle, setUIID, unbindStateFrom

Methods inherited from class com.codename1.ui.Label
bindProperty, getAlignment, getBadgeStyleComponent, getBadgeText, getBaseline, getBaselineResizeBehavior, getBindablePropertyNames, getBindablePropertyTypes, getBoundPropertyValue, getDefaultGap, getFontIcon, getFontIconSize, getGap, getIcon, getIconFont, getIconStyleComponent, getIconUIID, getMask, getMaskedIcon, getMaskName, getMaterialIcon, getMaterialIconSize, getMaxAutoSize, getMinAutoSize, getShiftMillimeters, getShiftMillimetersF, getShiftText, getStringWidth, getText, getTextPosition, getTextSelectionSupport, getVerticalAlignment, initLaf, initUnselectedStyle, isAutoSizeMode, isDefaultTickerEnabled, isEndsWith3Points, isLegacyRenderer, isShouldLocalize, isShowEvenIfBlank, isTextSelectionEnabled, isTickerEnabled, isTickerRunning, laidOut, paramString, refreshTheme, setAutoSizeMode, setBadgeText, setBadgeUIID, setBoundPropertyValue, setDefaultGap, setDefaultTickerEnabled, setEndsWith3Points, setFontIcon, setFontIcon, setFontIcon, setGap, setIcon, setIconUIID, setLegacyRenderer, setMask, setMaskName, setMaterialIcon, setMaterialIcon, setMaxAutoSize, setMinAutoSize, setShiftMillimeters, setShiftMillimeters, setShiftText, setShouldLocalize, setShowEvenIfBlank, setTextPosition, setTextSelectionEnabled, setTickerEnabled, setVerticalAlignment, shouldTickerStart, startTicker, startTicker, stopTicker, styleChanged, unbindProperty

Methods inherited from class com.codename1.ui.Component
addDragFinishedListener, addDragOverListener, addDropListener, addFocusListener, addLongPressListener, addPointerDraggedListener, addPointerPressedListener, addPointerReleasedListener, addPullToRefresh, addScrollListener, blocksSideSwipe, calcScrollSize, cancelRepaints, clearClientProperties, contains, containsOrOwns, createStyleAnimation, deinitialize, deinitializeCustomStyle, dragEnter, dragExit, dragFinished, draggingOver, drawDraggedImage, drop, focusGained, focusLost, getAbsoluteX, getAbsoluteY, getAllStyles, getAnimationManager, getBottomGap, getBounds, getBounds, getClientProperty, getCloudBoundProperty, getCloudDestinationProperty, getComponentForm, getComponentState, getCursor, getDirtyRegion, getDisabledStyle, getDraggedx, getDraggedy, getDragImage, getDragRegionStatus, getDragSpeed, getEditingDelegate, getGridPosX, getGridPosY, getHeight, getInlineAllStyles, getInlineDisabledStyles, getInlinePressedStyles, getInlineSelectedStyles, getInlineStylesTheme, getInlineUnselectedStyles, getInnerHeight, getInnerPreferredH, getInnerPreferredW, getInnerWidth, getInnerX, getInnerY, getLabelForComponent, getName, getNativeOverlay, getNextFocusDown, getNextFocusLeft, getNextFocusRight, getNextFocusUp, getOuterHeight, getOuterPreferredH, getOuterPreferredW, getOuterWidth, getOuterX, getOuterY, getOwner, getParent, getPreferredH, getPreferredSize, getPreferredSizeStr, getPreferredTabIndex, getPreferredW, getPressedStyle, getSameHeight, getSameWidth, getScrollable, getScrollAnimationSpeed, getScrollDimension, getScrollOpacity, getScrollOpacityChangeSpeed, getScrollX, getScrollY, getSelectCommandText, getSelectedRect, getSelectedStyle, getSideGap, getTabIndex, getTensileLength, getTooltip, getUIID, getUIManager, getUnselectedStyle, getVisibleBounds, getVisibleBounds, getWidth, getX, getY, growShrink, handlesInput, hasFixedPreferredSize, hasFocus, hideNativeOverlay, initComponent, initCustomStyle, initDisabledStyle, initPressedStyle, initSelectedStyle, installDefaultPainter, isAlwaysTensile, isBlockLead, isCellRenderer, isChildOf, isDragActivated, isDragAndDropOperation, isDraggable, isDragRegion, isDropTarget, isEnabled, isFlatten, isFocusable, isGrabsPointerEvents, isHidden, isHidden, isHideInLandscape, isHideInPortrait, isIgnorePointerEvents, isInClippingRegion, isInitialized, isOpaque, isOwnedBy, isRippleEffect, isRTL, isScrollable, isScrollableX, isScrollableY, isScrollVisible, isSetCursorSupported, isSmoothScrolling, isSnapToGrid, isStickyDrag, isTactileTouch, isTactileTouch, isTensileDragEnabled, isTraversable, isVisible, longKeyPress, longPointerPress, onScrollX, onScrollY, paintBackground, paintBackgrounds, paintBorder, paintBorderBackground, paintComponent, paintComponent, paintIntersectingComponentsAbove, paintLock, paintLockRelease, paintRippleOverlay, paintScrollbars, paintScrollbarX, paintScrollbarY, paintShadows, parsePreferredSize, pinch, pinchReleased, pointerDragged, pointerDragged, pointerHoverPressed, pointerPressed, pointerReleased, putClientProperty, refreshTheme, refreshTheme, remove, removeDragFinishedListener, removeDragOverListener, removeDropListener, removeFocusListener, removeLongPressListener, removePointerDraggedListener, removePointerPressedListener, removePointerReleasedListener, removeScrollListener, repaint, repaint, requestFocus, respondsToPointerEvents, scrollRectToVisible, scrollRectToVisible, setAlwaysTensile, setBlockLead, setCellRenderer, setCloudBoundProperty, setCloudDestinationProperty, setComponentState, setCursor, setDirtyRegion, setDisabledStyle, setDraggable, setDropTarget, setEditingDelegate, setEnabled, setFlatten, setFocus, setFocusable, setGrabsPointerEvents, setHandlesInput, setHeight, setHidden, setHidden, setHideInLandscape, setHideInPortrait, setIgnorePointerEvents, setInitialized, setInlineAllStyles, setInlineDisabledStyles, setInlinePressedStyles, setInlineSelectedStyles, setInlineStylesTheme, setInlineUnselectedStyles, setIsScrollVisible, setLabelForComponent, setName, setNextFocusDown, setNextFocusLeft, setNextFocusRight, setNextFocusUp, setOpaque, setOwner, setPreferredH, setPreferredSize, setPreferredSizeStr, setPreferredTabIndex, setPreferredW, setPressedStyle, setRippleEffect, setRTL, setSameHeight, setSameSize, setSameWidth, setScrollAnimationSpeed, setScrollOpacityChangeSpeed, setScrollSize, setScrollVisible, setScrollX, setScrollY, setSelectCommandText, setSelectedStyle, setShouldCalcPreferredSize, setSize, setSmoothScrolling, setSnapToGrid, setTabIndex, setTactileTouch, setTensileDragEnabled, setTensileLength, setTooltip, setTraversable, setUIID, setUnselectedStyle, setVisible, setWidth, setX, setY, shouldBlockSideSwipe, shouldBlockSideSwipeLeft, shouldBlockSideSwipeRight, shouldRenderComponentSelection, showNativeOverlay, stripMarginAndPadding, toImage, toString, updateNativeOverlay, visibleBoundsContains

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.codename1.ui.IconHolder
getGap, getIcon, getIconStyleComponent, getIconUIID, getTextPosition, setFontIcon, setGap, setIcon, setIconUIID, setMaterialIcon, setTextPosition

- Constructor Detail
  - Picker
```
public Picker()
```
    Default constructor
- Method Detail
  - isDefaultUseLightweightPopup
```
public static boolean isDefaultUseLightweightPopup()
```
    Whether useLightweightPopup should default to true, this can be set via the theme constant lightweightPickerBool
    
    Returns:
    
    the defaultUseLightweightPopup
  - setDefaultUseLightweightPopup
```
public static void setDefaultUseLightweightPopup(boolean aDefaultUseLightweightPopup)
```
    Whether useLightweightPopup should default to true, this can be set via the theme constant lightweightPickerBool
    
    Parameters:
    
    aDefaultUseLightweightPopup - the defaultUseLightweightPopup to set
  - setHourRange
```
public void setHourRange(int min,
                         int max)
```
    Sets the hour range for this picker. Only applicable for types CN1Constants.PICKER_TYPE_DATE_AND_TIME and CN1Constants.PICKER_TYPE_TIME. Also, only applicable to lightweight picker (i.e. isUseLightweightPopup() == true.
    
    Parameters:
    
    min - The minimum hour to display (0-24) or -1 for no limit.
    
    max - The maximum hour to display (0-24) or -1 for no limit
    
    Since:
    
    6.0
    
    See Also:
    
    getMinHour(), getMaxHour()
  - getMinHour
```
public int getMinHour()
```
    Gets the minimum hour to show for time and datetime pickers. Only applicable for types CN1Constants.PICKER_TYPE_DATE_AND_TIME and CN1Constants.PICKER_TYPE_TIME. Also, only applicable to lightweight picker (i.e. isUseLightweightPopup() == true.
    
    Returns:
    
    The minimum hour. 0-24, or -1 for no limit.
    
    Since:
    
    6.0
    
    See Also:
    
    getMaxHour(), setHourRange(int, int)
  - getMaxHour
```
public int getMaxHour()
```
    Gets the minimum hour to show for time and datetime pickers. Only applicable for types CN1Constants.PICKER_TYPE_DATE_AND_TIME and CN1Constants.PICKER_TYPE_TIME. Also, only applicable to lightweight picker (i.e. isUseLightweightPopup() == true.
    
    Returns:
    
    The minimum hour. 0-24, or -1 for no limit.
    
    Since:
    
    6.0
    
    See Also:
    
    getMinHour(), setHourRange(int, int)
  - setStartDate
```
public void setStartDate(Date start)
```
    Sets the start date of the picker. Only applicable for types CN1Constants.PICKER_TYPE_DATE_AND_TIME and CN1Constants.PICKER_TYPE_DATE. Also, only applicable to lightweight picker (i.e. isUseLightweightPopup() == true.
    This does not affect the time. Only the date. You can set the hour range using setHourRange(int, int).
    
    Parameters:
    
    start - The start date.
    
    Since:
    
    6.0
    
    See Also:
    
    getStartDate(), setEndDate(java.util.Date)
  - setEndDate
```
public void setEndDate(Date end)
```
    Sets the end date of the picker. Only applicable for types CN1Constants.PICKER_TYPE_DATE_AND_TIME and CN1Constants.PICKER_TYPE_DATE. Also, only applicable to lightweight picker (i.e. isUseLightweightPopup() == true.
    This does not affect the time. Only the date. You can set the hour range using setHourRange(int, int).
    
    Parameters:
    
    end - The end date.
    
    Since:
    
    6.0
    
    See Also:
    
    setStartDate(java.util.Date), getEndDate()
  - getStartDate
```
public Date getStartDate()
```
    Gets the start date of the picker. Only applicable for types CN1Constants.PICKER_TYPE_DATE_AND_TIME and CN1Constants.PICKER_TYPE_DATE. Also, only applicable to lightweight picker (i.e. isUseLightweightPopup() == true.
    
    Returns:
    
    The start date or null if there is none set.
    This does not apply to the time. Only the date. You can set the hour range using setHourRange(int, int).
    
    Since:
    
    6.0
    
    See Also:
    
    getEndDate(), setStartDate(java.util.Date), getMinHour()
  - getEndDate
```
public Date getEndDate()
```
    Gets the end date of the picker. Only applicable for types CN1Constants.PICKER_TYPE_DATE_AND_TIME and CN1Constants.PICKER_TYPE_DATE. Also, only applicable to lightweight picker (i.e. isUseLightweightPopup() == true.
    
    Returns:
    
    The end date or null if there is none set.
    This does not apply to the time. Only the date. You can set the hour range using setHourRange(int, int).
    
    Since:
    
    6.0
    
    See Also:
    
    getStartDate(), setEndDate(java.util.Date), getMaxHour()
  - setUseLightweightPopup
```
public void setUseLightweightPopup(boolean useLightweightPopup)
```
    Sets the picker to use lightweight mode for its widgets. With this mode enabled the picker will use cross-platform lightweight widgets instead of native widgets.
    
    Parameters:
    
    useLightweightPopup -
  - isUseLightweightPopup
```
public boolean isUseLightweightPopup()
```
    Checks if this picker is in lightweight mode. If this returns true, then the picker will use cross-platform lightweight widgets instead of native widgets.
  - startEditingAsync
```
public void startEditingAsync()
```
    Description copied from class: Component
    
    If the component Component.isEditable(), then this will start the editing process. For TextFields, this results in showing the keyboard and allowing the user to edit the input. For the Picker, this will display the popup.
    
    Specified by:
    
    startEditingAsync in interface Editable
    
    Overrides:
    
    startEditingAsync in class Component
    
    See Also:
    
    Component.stopEditing(java.lang.Runnable), Component.isEditing(), Component.isEditable(), Component.getEditingDelegate(), Component.setEditingDelegate(com.codename1.ui.Editable)
  - stopEditing
```
public void stopEditing(Runnable onFinish)
```
    Description copied from class: Component
    
    Stops the editing process.
    
    Specified by:
    
    stopEditing in interface Editable
    
    Overrides:
    
    stopEditing in class Component
    
    Parameters:
    
    onFinish - Callback called when the editing is complete.
    
    See Also:
    
    Component.startEditingAsync(), Component.isEditing(), Component.isEditable(), Component.getEditingDelegate(), Component.setEditingDelegate(com.codename1.ui.Editable)
  - isEditing
```
public boolean isEditing()
```
    Description copied from class: Component
    
    Checks if the component is currently being edited.
    
    Specified by:
    
    isEditing in interface Editable
    
    Overrides:
    
    isEditing in class Component
    
    Returns:
    
    True if the component is currently being edited.
    
    See Also:
    
    Component.startEditingAsync(), Component.stopEditing(java.lang.Runnable), Component.isEditable(), Component.getEditingDelegate(), Component.setEditingDelegate(com.codename1.ui.Editable)
  - isEditable
```
public boolean isEditable()
```
    Description copied from class: Component
    
    Checks to see if the component is editable. This is used for next/previous focus traversal on forms.
    
    Specified by:
    
    isEditable in interface Editable
    
    Overrides:
    
    isEditable in class Component
    
    Returns:
    
    See Also:
    
    Component.getEditingDelegate(), Component.setEditingDelegate(com.codename1.ui.Editable), Component.isEditing(), Component.startEditingAsync(), Component.stopEditing(java.lang.Runnable)
  - setType
```
public void setType(int type)
```
    Sets the type of the picker to one of Display.PICKER_TYPE_DATE, Display.PICKER_TYPE_DATE_AND_TIME, Display.PICKER_TYPE_STRINGS, Display.PICKER_TYPE_DURATION, Display.PICKER_TYPE_DURATION_HOURS, Display.PICKER_TYPE_DURATION_MINUTES or Display.PICKER_TYPE_TIME
    
    Parameters:
    
    type - the type
  - getType
```
public int getType()
```
    Returns the type of the picker
    
    Returns:
    
    one of Display.PICKER_TYPE_DATE, Display.PICKER_TYPE_DATE_AND_TIME, Display.PICKER_TYPE_STRINGS, Display.PICKER_TYPE_DURATION, Display.PICKER_TYPE_DURATION_HOURS, Display.PICKER_TYPE_DURATION_MINUTES, or Display.PICKER_TYPE_TIME
  - getDate
```
public Date getDate()
```
    Returns the date, this value is used both for type date/date and time. Notice that this value isn't used for time
    
    Returns:
    
    the date object
  - setDate
```
public void setDate(Date d)
```
    Sets the date, this value is used both for type date/date and time. Notice that this value isn't used for time. Notice that this value will have no effect if the picker is currently showing.
    
    Parameters:
    
    d - the new date
  - setStrings
```
public void setStrings(String... strs)
```
    Sets the string entries for the string picker.
    sample usage for this method below:
    
    Parameters:
    
    strs - string array
  - getStrings
```
public String[] getStrings()
```
    Returns the String array matching the metadata
    
    Returns:
    
    a string array
  - setSelectedString
```
public void setSelectedString(String str)
```
    Sets the current value in a string array picker
    
    Parameters:
    
    str - the current value
  - getSelectedString
```
public String getSelectedString()
```
    Returns the current string
    
    Returns:
    
    the selected string
  - getSelectedStringIndex
```
public int getSelectedStringIndex()
```
    Returns the index of the selected string
    
    Returns:
    
    the selected string offset or -1
  - setSelectedStringIndex
```
public void setSelectedStringIndex(int index)
```
    Returns the index of the selected string
    
    Parameters:
    
    index - sets the index of the selected string
  - updateValue
```
protected void updateValue()
```
    Updates the display value of the picker, subclasses can override this to invoke set text with the right value
  - setTime
```
public void setTime(int time)
```
    This value is only used for time type and is ignored in the case of date and time where both are embedded within the date.
    
    Parameters:
    
    time - the time value as minutes since midnight e.g. 630 is 10:30am
  - setTime
```
public void setTime(int hour,
                    int minute)
```
    Convenience method equivalent to invoking setTime(hour * 60 + minute);
    
    Parameters:
    
    hour - the hour in 24hr format
    
    minute - the minute within the hour
  - getTime
```
public int getTime()
```
    This value is only used for time type and is ignored in the case of date and time where both are embedded within the date.
    
    Returns:
    
    the time value as minutes since midnight e.g. 630 is 10:30am
  - setDuration
```
public void setDuration(long duration)
```
    This value is only used for duration type.
    
    Parameters:
    
    duration - The duration value in milliseconds.
    
    See Also:
    
    setDuration(int, int), getDuration(), getDurationHours(), getDurationMinutes()
  - setMinuteStep
```
public void setMinuteStep(int step)
```
    Sets the minute step size for PICKER_TYPE_DURATION, and PICKER_TYPE_DURATION_TIME types.
    
    Parameters:
    
    step - The step size in minutes.
  - setDuration
```
public void setDuration(int hour,
                        int minute)
```
    Convenience method for setting duration in hours and minutes.
    
    Parameters:
    
    hour - The hours for duration.
    
    minute - The minutes for duration.
    
    See Also:
    
    setDuration(long), getDuration(), getDurationHours(), getDurationMinutes()
  - getDuration
```
public long getDuration()
```
    This value is used for the duration type.
    
    Returns:
    
    The duration in milliseconds.
    
    See Also:
    
    getDurationHours(), getDurationMinutes()
  - getDurationHours
```
public int getDurationHours()
```
    Gets the duration hours. Used only for duration type.
    
    Returns:
    
    The duration hours.
    
    See Also:
    
    getDurationMinutes(), getDuration()
  - getDurationMinutes
```
public int getDurationMinutes()
```
    Gets the duration minutes. Used only for duration type.
    
    Returns:
    
    The duration minutes.
    
    See Also:
    
    getDurationHours(), getDuration()
  - isShowMeridiem
```
public boolean isShowMeridiem()
```
    Indicates whether hours should be rendered as AM/PM or 24hr format
    
    Returns:
    
    the showMeridiem
  - setShowMeridiem
```
public void setShowMeridiem(boolean showMeridiem)
```
    Indicates whether hours should be rendered as AM/PM or 24hr format
    
    Parameters:
    
    showMeridiem - the showMeridiem to set
  - getRenderingPrototype
```
public Object getRenderingPrototype()
```
    When using a lightweight spinner this will be used as the rendering prototype
    
    Returns:
    
    the renderingPrototype
  - setRenderingPrototype
```
public void setRenderingPrototype(Object renderingPrototype)
```
    When using a lightweight spinner this will be used as the rendering prototype
    
    Parameters:
    
    renderingPrototype - the renderingPrototype to set
  - getFormatter
```
public SimpleDateFormat getFormatter()
```
    Allows us to define a date format for the display of dates/times
    
    Returns:
    
    the defined formatter
  - setFormatter
```
public void setFormatter(SimpleDateFormat formatter)
```
    Allows us to define a date format for the display of dates/times
    
    Parameters:
    
    formatter - the new formatter
  - setPreferredPopupWidth
```
public void setPreferredPopupWidth(int width)
```
    The preferred width of the popup dialog for the picker. This will only be used on devices where the popup width and height are configurable, such as the iPad or tablets. On iPhone, the picker always spans the width of the screen along the bottom.
    
    Parameters:
    
    width - The preferred width of the popup.
  - setPreferredPopupHeight
```
public void setPreferredPopupHeight(int height)
```
    The preferred height of the popup dialog for the picker. This will only be used on devices where the popup width and height are configurable, such as the iPad or tablets. On iPhone, the picker always spans the width of the screen along the bottom.
    
    Parameters:
    
    height - The preferred height of the popup.
  - getPreferredPopupWidth
```
public int getPreferredPopupWidth()
```
    The preferred width of the popup dialog. This will only be used on devices where the popup width and height are configurable, such as the iPad or tablets. On iPhone, the picker always spans the width of the screen along the bottom.
    
    Returns:
  - getPreferredPopupHeight
```
public int getPreferredPopupHeight()
```
    The preferred height of the popup dialog. This will only be used on devices where the popup width and height are configurable, such as the iPad or tablets. On iPhone, the picker always spans the width of the screen along the bottom.
    
    Returns:
  - getPropertyNames
```
public String[] getPropertyNames()
```
    A component may expose mutable property names for a UI designer to manipulate, this API is designed for usage internally by the GUI builder code
    
    Overrides:
    
    getPropertyNames in class Label
    
    Returns:
    
    the property names allowing mutation
  - getPropertyTypes
```
public Class[] getPropertyTypes()
```
    Matches the property names method (see that method for further details).
    
    Overrides:
    
    getPropertyTypes in class Label
    
    Returns:
    
    the types of the properties
  - getPropertyTypeNames
```
public String[] getPropertyTypeNames()
```
    This method is here to workaround an XMLVM array type bug where property types aren't identified properly, it returns the names of the types using the following type names: String,int,double,long,byte,short,char,String[],String[][],byte[],Image,Image[],Object[],ListModel,ListCellRenderer
    
    Overrides:
    
    getPropertyTypeNames in class Label
    
    Returns:
    
    Array of type names
  - getPropertyValue
```
public Object getPropertyValue(String name)
```
    Returns the current value of the property name, this method is used by the GUI builder
    
    Overrides:
    
    getPropertyValue in class Label
    
    Parameters:
    
    name - the name of the property
    
    Returns:
    
    the value of said property
  - setPropertyValue
```
public String setPropertyValue(String name,
                               Object value)
```
    Sets a new value to the given property, returns an error message if failed and null if successful. Notice that some builtin properties such as "$designMode" might be sent to components to indicate application state.
    
    Overrides:
    
    setPropertyValue in class Label
    
    Parameters:
    
    name - the name of the property
    
    value - new value for the property
    
    Returns:
    
    error message or null
  - getValue
```
public Object getValue()
```
    Returns the value which works for all picker types
    
    Returns:
    
    the value object
  - paint
```
public void paint(Graphics g)
```
    Description copied from class: Label
    
    This method paints the Component on the screen, it should be overriden by subclasses to perform custom drawing or invoke the UI API's to let the PLAF perform the rendering.
    
    Specified by:
    
    paint in interface Animation
    
    Overrides:
    
    paint in class Button
    
    Parameters:
    
    g - the component graphics
  - getStyle
```
public Style getStyle()
```
    Description copied from class: Component
    
    Returns the current Component Style allowing code to draw the current component, you should normally use getUnselected/Pressed/DisabledStyle() and not this method since it will return different values based on component state.
    
    Overrides:
    
    getStyle in class Component
    
    Returns:
    
    the component Style object

Class Picker

Field Summary

Fields inherited from class com.codename1.ui.Button

Fields inherited from class com.codename1.ui.Component

Constructor Summary

Method Summary

Methods inherited from class com.codename1.ui.Button

Methods inherited from class com.codename1.ui.Label

Methods inherited from class com.codename1.ui.Component

Methods inherited from class java.lang.Object

Methods inherited from interface com.codename1.ui.IconHolder

Constructor Detail

Picker

Method Detail

isDefaultUseLightweightPopup

setDefaultUseLightweightPopup

setHourRange

getMinHour

getMaxHour

setStartDate

setEndDate

getStartDate

getEndDate

setUseLightweightPopup

isUseLightweightPopup

startEditingAsync

stopEditing

isEditing

isEditable

setType

getType

getDate

setDate

setStrings

getStrings

setSelectedString

getSelectedString

getSelectedStringIndex

setSelectedStringIndex

updateValue

setTime

setTime

getTime

setDuration

setMinuteStep

setDuration

getDuration

getDurationHours

getDurationMinutes

isShowMeridiem

setShowMeridiem

getRenderingPrototype

setRenderingPrototype

getFormatter

setFormatter

setPreferredPopupWidth

setPreferredPopupHeight

getPreferredPopupWidth

getPreferredPopupHeight

getPropertyNames

getPropertyTypes

getPropertyTypeNames

getPropertyValue

setPropertyValue

getValue

paint

getStyle