com.vaadin.ui.

java.lang.Object
- com.vaadin.server.AbstractClientConnector
- - com.vaadin.ui.AbstractComponent
  - - com.vaadin.ui.AbstractField<Object>
    - - com.vaadin.ui.AbstractSelect
      - com.vaadin.ui.NativeSelect

All Implemented Interfaces:

Buffered, BufferedValidatable, Container, Container.ItemSetChangeListener, Container.ItemSetChangeNotifier, Container.PropertySetChangeListener, Container.PropertySetChangeNotifier, Container.Viewer, Property<Object>, Property.Editor, Property.ReadOnlyStatusChangeListener, Property.ReadOnlyStatusChangeNotifier, Property.ValueChangeListener, Property.ValueChangeNotifier, Property.Viewer, Validatable, Action.ShortcutNotifier, ConnectorEventListener, ContextClickEvent.ContextClickNotifier, FieldEvents.BlurNotifier, FieldEvents.FocusNotifier, MethodEventSource, ClientConnector, Sizeable, VariableOwner, Connector, Component, Component.Focusable, Field<Object>, LegacyComponent, Serializable, EventListener
```
public class NativeSelect
extends AbstractSelect
implements FieldEvents.BlurNotifier, FieldEvents.FocusNotifier
```
This is a simple drop-down select without, for instance, support for multiselect, new items, lazyloading, and other advanced features. Sometimes "native" select without all the bells-and-whistles of the ComboBox is a better choice.

See Also:

Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from class com.vaadin.ui.AbstractSelect
  AbstractSelect.AbstractSelectTargetDetails, AbstractSelect.AcceptItem, AbstractSelect.CaptionChangeListener, AbstractSelect.DefaultNewItemHandler, AbstractSelect.Filtering, AbstractSelect.ItemCaptionMode, AbstractSelect.ItemDescriptionGenerator, AbstractSelect.NewItemHandler, AbstractSelect.TargetItemIs, AbstractSelect.VerticalLocationIs
- Nested classes/interfaces inherited from class com.vaadin.ui.AbstractField
  AbstractField.FocusShortcut, AbstractField.ReadOnlyStatusChangeEvent
- Nested classes/interfaces inherited from interface com.vaadin.data.Container
  Container.Editor, Container.Filter, Container.Filterable, Container.Hierarchical, Container.Indexed, Container.ItemSetChangeListener, Container.ItemSetChangeNotifier, Container.Ordered, Container.PropertySetChangeListener, Container.PropertySetChangeNotifier, Container.SimpleFilterable, Container.Sortable, Container.Viewer
- Nested classes/interfaces inherited from interface com.vaadin.ui.Component
  Component.ErrorEvent, Component.Event, Component.Focusable, Component.Listener
- Nested classes/interfaces inherited from interface com.vaadin.server.ClientConnector
  ClientConnector.AttachEvent, ClientConnector.AttachListener, ClientConnector.ConnectorErrorEvent, ClientConnector.DetachEvent, ClientConnector.DetachListener
- Nested classes/interfaces inherited from interface com.vaadin.server.Sizeable
  Sizeable.Unit
- Nested classes/interfaces inherited from interface com.vaadin.ui.Field
  Field.ValueChangeEvent
- Nested classes/interfaces inherited from interface com.vaadin.data.Buffered
  Buffered.SourceException
- Nested classes/interfaces inherited from interface com.vaadin.data.Property
  Property.Editor, Property.ReadOnlyException, Property.ReadOnlyStatusChangeListener, Property.ReadOnlyStatusChangeNotifier, Property.Transactional<T>, Property.ValueChangeListener, Property.ValueChangeNotifier, Property.Viewer

Field Summary
- Fields inherited from class com.vaadin.ui.AbstractSelect
  ITEM_CAPTION_MODE_EXPLICIT, ITEM_CAPTION_MODE_EXPLICIT_DEFAULTS_ID, ITEM_CAPTION_MODE_ICON_ONLY, ITEM_CAPTION_MODE_ID, ITEM_CAPTION_MODE_INDEX, ITEM_CAPTION_MODE_ITEM, ITEM_CAPTION_MODE_PROPERTY, itemIdMapper, items
- Fields inherited from class com.vaadin.ui.AbstractComponent
  DESIGN_ATTR_PLAIN_TEXT
- Fields inherited from interface com.vaadin.server.Sizeable
  SIZE_UNDEFINED, UNITS_CM, UNITS_EM, UNITS_EX, UNITS_INCH, UNITS_MM, UNITS_PERCENTAGE, UNITS_PICAS, UNITS_PIXELS, UNITS_POINTS

Constructor Summary

Constructors
Constructor and Description
`NativeSelect()`
`NativeSelect(String caption)`
`NativeSelect(String caption, Collection<?> options)`
`NativeSelect(String caption, Container dataSource)`

Method Summary

All Methods
Modifier and Type	Method and Description
`void`	`addBlurListener(FieldEvents.BlurListener listener)` Adds a `BlurListener` to the Component which gets fired when a `Field` loses keyboard focus.
`void`	`addFocusListener(FieldEvents.FocusListener listener)` Adds a `FocusListener` to the Component which gets fired when a `Field` receives keyboard focus.
`void`	`addListener(FieldEvents.BlurListener listener)` Deprecated. As of 7.0, replaced by `#addBlurListener(BlurListener)`
`void`	`addListener(FieldEvents.FocusListener listener)` Deprecated. As of 7.0, replaced by `#addFocusListener(FocusListener)`
`int`	`getColumns()` Deprecated. As of 7.0. "Columns" does not reflect the exact number of characters that will be displayed. It is better to use setWidth together with "em" to control the width of the field.
`void`	`paintContent(PaintTarget target)` Paints the content of this component.
`void`	`removeBlurListener(FieldEvents.BlurListener listener)` Removes a `BlurListener` from the Component.
`void`	`removeFocusListener(FieldEvents.FocusListener listener)` Removes a `FocusListener` from the Component.
`void`	`removeListener(FieldEvents.BlurListener listener)` Deprecated. As of 7.0, replaced by `#removeBlurListener(BlurListener)`
`void`	`removeListener(FieldEvents.FocusListener listener)` Deprecated. As of 7.0, replaced by `#removeFocusListener(FocusListener)`
`void`	`setColumns(int columns)` Deprecated. As of 7.0. "Columns" does not reflect the exact number of characters that will be displayed. It is better to use setWidth together with "em" to control the width of the field.
`void`	`setMultiSelect(boolean multiSelect)` Sets the multiselect mode.
`void`	`setNewItemsAllowed(boolean allowNewOptions)` Enables or disables possibility to add new options by the user.

Methods inherited from class com.vaadin.ui.AbstractSelect
addContainerProperty, addItem, addItem, addItems, addItems, addItemSetChangeListener, addListener, addListener, addPropertySetChangeListener, attach, changeVariables, containerItemSetChange, containerPropertySetChange, containsId, detach, fireItemSetChange, firePropertySetChange, getCaptionChangeListener, getContainerDataSource, getContainerProperty, getContainerPropertyIds, getItem, getItemCaption, getItemCaptionMode, getItemCaptionPropertyId, getItemIcon, getItemIconPropertyId, getItemIds, getListeners, getNewItemHandler, getNullSelectionItemId, getState, getType, getType, getValue, getVisibleItemIds, isEmpty, isMultiSelect, isNewItemsAllowed, isNullSelectionAllowed, isSelected, paintItem, readDesign, readItem, readItems, removeAllItems, removeContainerProperty, removeItem, removeItemSetChangeListener, removeListener, removeListener, removePropertySetChangeListener, sanitizeSelection, select, setContainerDataSource, setItemCaption, setItemCaptionMode, setItemCaptionPropertyId, setItemIcon, setItemIconPropertyId, setNewItemHandler, setNullSelectionAllowed, setNullSelectionItemId, setValue, setValue, size, unselect, writeDesign, writeItem, writeItems

Methods inherited from class com.vaadin.ui.AbstractField
addListener, addListener, addReadOnlyStatusChangeListener, addValidator, addValueChangeListener, beforeClientResponse, clear, commit, discard, fireReadOnlyStatusChange, fireValueChange, focus, getConversionError, getConversionError, getConvertedValue, getConverter, getCurrentBufferedSourceException, getCustomAttributes, getErrorMessage, getInternalValue, getModelType, getPropertyDataSource, getRequiredError, getState, getTabIndex, getValidators, isBuffered, isImmediate, isInvalidAllowed, isInvalidCommitted, isModified, isReadOnly, isRequired, isValid, isValidationVisible, readOnlyStatusChange, removeAllValidators, removeListener, removeListener, removeReadOnlyStatusChangeListener, removeValidator, removeValueChangeListener, setBuffered, setConversionError, setConvertedValue, setConverter, setConverter, setCurrentBufferedSourceException, setInternalValue, setInvalidAllowed, setInvalidCommitted, setLocale, setPropertyDataSource, setReadOnly, setRequired, setRequiredError, setTabIndex, setValidationVisible, setValue, shouldHideErrors, toString, validate, validate, valueChange

Methods inherited from class com.vaadin.ui.AbstractComponent
addContextClickListener, addListener, addShortcutListener, addStyleName, findAncestor, fireComponentErrorEvent, fireComponentEvent, getActionManager, getCaption, getComponentError, getData, getDebugId, getDescription, getExplicitImmediateValue, getHeight, getHeightUnits, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getStyleName, getWidth, getWidthUnits, isCaptionAsHtml, isConnectorEnabled, isEnabled, isOrHasAncestor, isResponsive, isVisible, removeContextClickListener, removeListener, removeShortcutListener, removeStyleName, setCaption, setCaptionAsHtml, setComponentError, setData, setDebugId, setDescription, setEnabled, setHeight, setHeight, setHeightUndefined, setIcon, setId, setImmediate, setParent, setPrimaryStyleName, setResponsive, setSizeFull, setSizeUndefined, setStyleName, setStyleName, setVisible, setWidth, setWidth, setWidthUndefined

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

Methods inherited from interface com.vaadin.ui.LegacyComponent
markAsDirty

Methods inherited from interface com.vaadin.server.VariableOwner
isEnabled, isImmediate

Methods inherited from interface com.vaadin.ui.Component
addListener, addStyleName, getCaption, getDescription, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getStyleName, getUI, isEnabled, isReadOnly, isVisible, removeListener, removeStyleName, setCaption, setEnabled, setIcon, setId, setParent, setPrimaryStyleName, setReadOnly, setStyleName, setVisible

Methods inherited from interface com.vaadin.server.ClientConnector
addAttachListener, addDetachListener, beforeClientResponse, encodeState, getErrorHandler, getExtensions, getRpcManager, getStateType, handleConnectorRequest, isAttached, isConnectorEnabled, markAsDirtyRecursive, removeAttachListener, removeDetachListener, removeExtension, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler

Methods inherited from interface com.vaadin.shared.Connector
getConnectorId

Methods inherited from interface com.vaadin.server.Sizeable
getHeight, getHeightUnits, getWidth, getWidthUnits, setHeight, setHeight, setHeightUndefined, setSizeFull, setSizeUndefined, setWidth, setWidth, setWidthUndefined

Methods inherited from interface com.vaadin.event.Action.ShortcutNotifier
addShortcutListener, removeShortcutListener

- Constructor Detail
  - NativeSelect
```
public NativeSelect()
```
  - NativeSelect
```
public NativeSelect(String caption,
                    Collection<?> options)
```
  - NativeSelect
```
public NativeSelect(String caption,
                    Container dataSource)
```
  - NativeSelect
```
public NativeSelect(String caption)
```
- Method Detail
  - setColumns
```
@Deprecated
public void setColumns(int columns)
```
    Deprecated. As of 7.0. "Columns" does not reflect the exact number of characters that will be displayed. It is better to use setWidth together with "em" to control the width of the field.
    
    Sets the width of the component so that it can display approximately the given number of letters.
    Calling setColumns(10); is equivalent to calling setWidth("10em");
    
    Parameters:
    
    columns - the number of columns to set.
  - getColumns
```
@Deprecated
public int getColumns()
```
    Deprecated. As of 7.0. "Columns" does not reflect the exact number of characters that will be displayed. It is better to use setWidth together with "em" to control the width of the field.
    
    Gets the number of columns for the component.
    
    See Also:
    
    setColumns(int)
  - paintContent
```
public void paintContent(PaintTarget target)
                  throws PaintException
```
    Description copied from class: AbstractSelect
    
    Paints the content of this component.
    
    Specified by:
    
    paintContent in interface LegacyComponent
    
    Overrides:
    
    paintContent in class AbstractSelect
    
    Parameters:
    
    target - the Paint Event.
    
    Throws:
    
    PaintException - if the paint operation failed.
  - setMultiSelect
```
public void setMultiSelect(boolean multiSelect)
                    throws UnsupportedOperationException
```
    Description copied from class: AbstractSelect
    
    Sets the multiselect mode. Setting multiselect mode false may lose selection information: if selected items set contains one or more selected items, only one of the selected items is kept as selected. Subclasses of AbstractSelect can choose not to support changing the multiselect mode, and may throw UnsupportedOperationException.
    
    Overrides:
    
    setMultiSelect in class AbstractSelect
    
    Parameters:
    
    multiSelect - the New value of property multiSelect.
    
    Throws:
    
    UnsupportedOperationException
  - setNewItemsAllowed
```
public void setNewItemsAllowed(boolean allowNewOptions)
                        throws UnsupportedOperationException
```
    Description copied from class: AbstractSelect
    
    Enables or disables possibility to add new options by the user.
    
    Overrides:
    
    setNewItemsAllowed in class AbstractSelect
    
    Parameters:
    
    allowNewOptions - the New value of property allowNewOptions.
    
    Throws:
    
    UnsupportedOperationException
  - addFocusListener
```
public void addFocusListener(FieldEvents.FocusListener listener)
```
    Description copied from interface: FieldEvents.FocusNotifier
    
    Adds a FocusListener to the Component which gets fired when a Field receives keyboard focus.
    
    Specified by:
    
    addFocusListener in interface FieldEvents.FocusNotifier
    
    See Also:
    
    FieldEvents.FocusListener
  - addListener
```
@Deprecated
public void addListener(FieldEvents.FocusListener listener)
```
    Deprecated. As of 7.0, replaced by #addFocusListener(FocusListener)
    
    Specified by:
    
    addListener in interface FieldEvents.FocusNotifier
  - removeFocusListener
```
public void removeFocusListener(FieldEvents.FocusListener listener)
```
    Description copied from interface: FieldEvents.FocusNotifier
    
    Removes a FocusListener from the Component.
    
    Specified by:
    
    removeFocusListener in interface FieldEvents.FocusNotifier
    
    See Also:
    
    FieldEvents.FocusListener
  - removeListener
```
@Deprecated
public void removeListener(FieldEvents.FocusListener listener)
```
    Deprecated. As of 7.0, replaced by #removeFocusListener(FocusListener)
    
    Specified by:
    
    removeListener in interface FieldEvents.FocusNotifier
  - addBlurListener
```
public void addBlurListener(FieldEvents.BlurListener listener)
```
    Description copied from interface: FieldEvents.BlurNotifier
    
    Adds a BlurListener to the Component which gets fired when a Field loses keyboard focus.
    
    Specified by:
    
    addBlurListener in interface FieldEvents.BlurNotifier
    
    See Also:
    
    FieldEvents.BlurListener
  - addListener
```
@Deprecated
public void addListener(FieldEvents.BlurListener listener)
```
    Deprecated. As of 7.0, replaced by #addBlurListener(BlurListener)
    
    Specified by:
    
    addListener in interface FieldEvents.BlurNotifier
  - removeBlurListener
```
public void removeBlurListener(FieldEvents.BlurListener listener)
```
    Description copied from interface: FieldEvents.BlurNotifier
    
    Removes a BlurListener from the Component.
    
    Specified by:
    
    removeBlurListener in interface FieldEvents.BlurNotifier
    
    See Also:
    
    FieldEvents.BlurListener
  - removeListener
```
@Deprecated
public void removeListener(FieldEvents.BlurListener listener)
```
    Deprecated. As of 7.0, replaced by #removeBlurListener(BlurListener)
    
    Specified by:
    
    removeListener in interface FieldEvents.BlurNotifier

com.vaadin.ui.

Class NativeSelect

Nested Class Summary

Nested classes/interfaces inherited from class com.vaadin.ui.AbstractSelect

Nested classes/interfaces inherited from class com.vaadin.ui.AbstractField

Nested classes/interfaces inherited from interface com.vaadin.data.Container

Nested classes/interfaces inherited from interface com.vaadin.ui.Component

Nested classes/interfaces inherited from interface com.vaadin.server.ClientConnector

Nested classes/interfaces inherited from interface com.vaadin.server.Sizeable

Nested classes/interfaces inherited from interface com.vaadin.ui.Field

Nested classes/interfaces inherited from interface com.vaadin.data.Buffered

Nested classes/interfaces inherited from interface com.vaadin.data.Property

Field Summary

Fields inherited from class com.vaadin.ui.AbstractSelect

Fields inherited from class com.vaadin.ui.AbstractComponent

Fields inherited from interface com.vaadin.server.Sizeable

Constructor Summary

Method Summary

Methods inherited from class com.vaadin.ui.AbstractSelect

Methods inherited from class com.vaadin.ui.AbstractField

Methods inherited from class com.vaadin.ui.AbstractComponent

Methods inherited from class com.vaadin.server.AbstractClientConnector

Methods inherited from class java.lang.Object

Methods inherited from interface com.vaadin.ui.LegacyComponent

Methods inherited from interface com.vaadin.server.VariableOwner

Methods inherited from interface com.vaadin.ui.Component

Methods inherited from interface com.vaadin.server.ClientConnector

Methods inherited from interface com.vaadin.shared.Connector

Methods inherited from interface com.vaadin.server.Sizeable

Methods inherited from interface com.vaadin.event.Action.ShortcutNotifier

Constructor Detail

NativeSelect

NativeSelect

NativeSelect

NativeSelect

Method Detail

setColumns

getColumns

paintContent

setMultiSelect

setNewItemsAllowed

addFocusListener

addListener

removeFocusListener

removeListener

addBlurListener

addListener

removeBlurListener

removeListener