com.haulmont.cuba.gui.components

Interface SuggestionField

All Superinterfaces:

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

All Known Subinterfaces:

SuggestionPickerField

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

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	SuggestionField.ArrowDownActionHandler
static interface	SuggestionField.EnterActionHandler
static class	SuggestionField.OptionWrapper Represent value and its string representation.
static interface	SuggestionField.ParametrizedSearchExecutor<E>
static interface	SuggestionField.SearchExecutor<E>

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.ContextHelpIconClickEvent, Component.Disposable, Component.Editable, Component.EditableChangeEvent, Component.EditableChangeListener, Component.EditableChangeNotifier, Component.ExpandedStateChangeEvent, Component.ExpandedStateChangeListener, Component.Focusable, Component.HasBorder, Component.HasButtonsPanel, Component.HasCaption, Component.HasContextHelp, Component.HasFormatter, Component.HasIcon, Component.HasInputPrompt, Component.HasNamedComponents, Component.HasOptionsStyleProvider, Component.HasPresentations, Component.HasRowsCount, Component.HasSettings, Component.HasValue, Component.HasXmlDescriptor, Component.LayoutClickEvent, Component.LayoutClickListener, Component.LayoutClickNotifier, Component.Margin, Component.MouseEventDetails, Component.OptionsStyleProvider, 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
static java.lang.String	POPUP_AUTO_WIDTH
static java.lang.String	POPUP_PARENT_WIDTH

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()
java.lang.String	getPopupWidth()
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	setPopupWidth(java.lang.String width) Sets the given width to the component popup.
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<?> 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, setIconFromSet

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

getContextHelpIconClickHandler, getContextHelpText, isContextHelpTextHtmlEnabled, setContextHelpIconClickHandler, setContextHelpText, setContextHelpTextHtmlEnabled

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

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

getOptionsStyleProvider, setOptionsStyleProvider

Field Detail

NAME

static final java.lang.String NAME

See Also:

Constant Field Values

POPUP_AUTO_WIDTH

static final java.lang.String POPUP_AUTO_WIDTH

See Also:

Constant Field Values

POPUP_PARENT_WIDTH

static final java.lang.String POPUP_PARENT_WIDTH

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<?> suggestions)

Show passed suggestions in popup.

Parameters:

suggestions - suggestions to show

setPopupWidth

void setPopupWidth(java.lang.String width)

Sets the given width to the component popup.

Parameters:

width - width of the component popup

getPopupWidth

java.lang.String getPopupWidth()

Returns:

component popup width

getCaptionMode

CaptionMode getCaptionMode()

setCaptionMode

void setCaptionMode(CaptionMode captionMode)

getCaptionProperty

java.lang.String getCaptionProperty()

setCaptionProperty

void setCaptionProperty(java.lang.String captionProperty)