com.haulmont.cuba.gui.components

Interface SuggestionField

All Superinterfaces:

Component, Component.BelongToFrame, Component.Editable, Component.Focusable, Component.HasCaption, Component.HasIcon, Component.HasInputPrompt, Component.HasValue, Component.Validatable, DatasourceComponent, Field

All Known Subinterfaces:

SuggestionPickerField

All Known Implementing Classes:

DesktopSuggestionField, DesktopSuggestionPickerField, WebSuggestionField, WebSuggestionPickerField

public interface SuggestionField
extends Field, Component.Focusable, Component.HasInputPrompt

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	SuggestionField.ArrowDownActionHandler
static interface	SuggestionField.EnterActionHandler
static interface	SuggestionField.ParametrizedSearchExecutor<E extends Entity>
static interface	SuggestionField.SearchExecutor<E extends Entity>

Nested classes/interfaces inherited from interface com.haulmont.cuba.gui.components.Field

Field.Validator

Nested classes/interfaces inherited from interface com.haulmont.cuba.gui.components.Component

Component.ActionOwner, Component.ActionsHolder, Component.Alignment, Component.BelongToFrame, Component.Buffered, Component.ChildEditableController, Component.Collapsable, Component.Container, Component.Disposable, Component.Editable, Component.EditableChangeEvent, Component.EditableChangeListener, Component.EditableChangeNotifier, Component.ExpandedStateChangeEvent, Component.ExpandedStateChangeListener, Component.Focusable, Component.HasBorder, Component.HasButtonsPanel, Component.HasCaption, Component.HasFormatter, Component.HasIcon, Component.HasInputPrompt, Component.HasNamedComponents, Component.HasPresentations, Component.HasRowsCount, Component.HasSettings, Component.HasValue, Component.HasXmlDescriptor, Component.LayoutClickEvent, Component.LayoutClickListener, Component.LayoutClickNotifier, Component.Margin, Component.MouseEventDetails, Component.OrderedContainer, Component.OuterMargin, Component.SecuredActionsHolder, Component.ShortcutAction, Component.ShortcutNotifier, Component.ShortcutTriggeredEvent, Component.Spacing, Component.UiPermissionAware, Component.Validatable, Component.ValueChangeEvent, Component.ValueChangeListener, Component.Wrapper

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NAME

Fields inherited from interface com.haulmont.cuba.gui.components.Component

AUTO_SIZE, AUTO_SIZE_PX, UNITS_PERCENTAGE, UNITS_PIXELS

Method Summary

Modifier and Type	Method and Description
SuggestionField.ArrowDownActionHandler	getArrowDownActionHandler()
int	getAsyncSearchDelayMs()
int	getAsyncSearchTimeoutMs() Deprecated. Use getAsyncSearchDelayMs() instead.
CaptionMode	getCaptionMode()
java.lang.String	getCaptionProperty()
SuggestionField.EnterActionHandler	getEnterActionHandler()
int	getMinSearchStringLength()
SuggestionField.SearchExecutor	getSearchExecutor()
int	getSuggestionsLimit()
void	setArrowDownActionHandler(SuggestionField.ArrowDownActionHandler arrowDownActionHandler) Sets SuggestionField.ArrowDownActionHandler which handles ARROW_DOWN key pressing.
void	setAsyncSearchDelayMs(int asyncSearchDelayMs) Sets delay between the last key press action and async search.
void	setAsyncSearchTimeoutMs(int asyncSearchTimeoutMs) Deprecated. Use setAsyncSearchDelayMs(int) instead.
void	setCaptionMode(CaptionMode captionMode)
void	setCaptionProperty(java.lang.String captionProperty)
void	setEnterActionHandler(SuggestionField.EnterActionHandler enterActionHandler) Sets SuggestionField.EnterActionHandler which handles ENTER key pressing.
void	setMinSearchStringLength(int minSearchStringLength) Sets min string length which is required to perform suggestions search.
void	setSearchExecutor(SuggestionField.SearchExecutor searchExecutor) Sets SuggestionField.SearchExecutor which performs search.
void	setSuggestionsLimit(int suggestionsLimit) Sets limit of suggestions which will be shown.
void	showSuggestions(java.util.List<? extends Entity> suggestions) Show passed suggestions in popup.

Methods inherited from interface com.haulmont.cuba.gui.components.Field

addValidator, getRequiredMessage, getValidators, isRequired, removeValidator, setRequired, setRequiredMessage

Methods inherited from interface com.haulmont.cuba.gui.components.DatasourceComponent

getDatasource, getMetaProperty, getMetaPropertyPath, setDatasource

Methods inherited from interface com.haulmont.cuba.gui.components.Component.HasValue

addListener, addValueChangeListener, getValue, removeListener, removeValueChangeListener, setValue

Methods inherited from interface com.haulmont.cuba.gui.components.Component.Editable

isEditable, isEditableWithParent, setEditable

Methods inherited from interface com.haulmont.cuba.gui.components.Component.BelongToFrame

getFrame, setFrame

Methods inherited from interface com.haulmont.cuba.gui.components.Component

addStyleName, getAlignment, getDebugId, getHeight, getHeightUnits, getId, getParent, getStyleName, getWidth, getWidthUnits, isEnabled, isEnabledItself, isResponsive, isVisible, isVisibleItself, removeStyleName, requestFocus, setAlignment, setDebugId, setEnabled, setHeight, setHeightAuto, setHeightFull, setId, setParent, setResponsive, setSizeAuto, setSizeFull, setStyleName, setVisible, setWidth, setWidthAuto, setWidthFull, unwrap, unwrapComposition

Methods inherited from interface com.haulmont.cuba.gui.components.Component.HasCaption

getCaption, getDescription, setCaption, setDescription

Methods inherited from interface com.haulmont.cuba.gui.components.Component.Validatable

isValid, isValidateOnCommit, validate

Methods inherited from interface com.haulmont.cuba.gui.components.Component.HasIcon

getIcon, setIcon

Methods inherited from interface com.haulmont.cuba.gui.components.Component.Focusable

getTabIndex, isFocusable, setFocusable, setTabIndex

Methods inherited from interface com.haulmont.cuba.gui.components.Component.HasInputPrompt

getInputPrompt, setInputPrompt

Field Detail

NAME

static final java.lang.String NAME

See Also:

Constant Field Values

Method Detail

getAsyncSearchTimeoutMs

@Deprecated
int getAsyncSearchTimeoutMs()

Deprecated. Use getAsyncSearchDelayMs() instead.

Returns:

delay between the last key press action and async search

setAsyncSearchTimeoutMs

@Deprecated
void setAsyncSearchTimeoutMs(int asyncSearchTimeoutMs)

Deprecated. Use setAsyncSearchDelayMs(int) instead.

Sets delay between the last key press action and async search.

Parameters:

asyncSearchTimeoutMs - delay in ms

getAsyncSearchDelayMs

int getAsyncSearchDelayMs()

Returns:

delay between the last key press action and async search

setAsyncSearchDelayMs

void setAsyncSearchDelayMs(int asyncSearchDelayMs)

Sets delay between the last key press action and async search.

Parameters:

asyncSearchDelayMs - delay in ms

getSearchExecutor

SuggestionField.SearchExecutor getSearchExecutor()

Returns:

SuggestionField.SearchExecutor which performs search

setSearchExecutor

void setSearchExecutor(SuggestionField.SearchExecutor searchExecutor)

Sets SuggestionField.SearchExecutor which performs search.

Parameters:

searchExecutor - SearchExecutor instance

getEnterActionHandler

SuggestionField.EnterActionHandler getEnterActionHandler()

Returns:

SuggestionField.EnterActionHandler which handles ENTER key pressing

setEnterActionHandler

void setEnterActionHandler(SuggestionField.EnterActionHandler enterActionHandler)

Sets SuggestionField.EnterActionHandler which handles ENTER key pressing.

Parameters:

enterActionHandler - EnterActionHandler instance

getArrowDownActionHandler

SuggestionField.ArrowDownActionHandler getArrowDownActionHandler()

Returns:

SuggestionField.ArrowDownActionHandler which handles ARROW_DOWN key pressing

setArrowDownActionHandler

void setArrowDownActionHandler(SuggestionField.ArrowDownActionHandler arrowDownActionHandler)

Sets SuggestionField.ArrowDownActionHandler which handles ARROW_DOWN key pressing.

Parameters:

arrowDownActionHandler - ArrowDownActionHandler instance

getMinSearchStringLength

int getMinSearchStringLength()

Returns:

min string length to perform suggestions search

setMinSearchStringLength

void setMinSearchStringLength(int minSearchStringLength)

Sets min string length which is required to perform suggestions search.

Parameters:

minSearchStringLength - required string length to perform search

getSuggestionsLimit

int getSuggestionsLimit()

Returns:

limit of suggestions which will be shown

setSuggestionsLimit

void setSuggestionsLimit(int suggestionsLimit)

Sets limit of suggestions which will be shown.

Parameters:

suggestionsLimit - integer limit value

showSuggestions

void showSuggestions(java.util.List<? extends Entity> suggestions)

Show passed suggestions in popup.

Parameters:

suggestions - suggestions to show

getCaptionMode

CaptionMode getCaptionMode()

setCaptionMode

void setCaptionMode(CaptionMode captionMode)

getCaptionProperty

java.lang.String getCaptionProperty()

setCaptionProperty

void setCaptionProperty(java.lang.String captionProperty)