Module is.codion.swing.common.ui

Package is.codion.swing.common.ui.component.combobox

Class DefaultComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

java.lang.Object

is.codion.swing.common.ui.component.builder.AbstractComponentBuilder<C,B>

is.codion.swing.common.ui.component.builder.AbstractComponentValueBuilder<T,C,B>

is.codion.swing.common.ui.component.combobox.DefaultComboBoxBuilder<T,C,B>

All Implemented Interfaces:

ComponentBuilder<C,B>, ComponentValueBuilder<T,C,B>, ComboBoxBuilder<T,C,B>, Supplier<C>

public class DefaultComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>
extends AbstractComponentValueBuilder<T,C,B>
implements ComboBoxBuilder<T,C,B>

Nested Class Summary

Nested classes/interfaces inherited from interface is.codion.swing.common.ui.component.combobox.ComboBoxBuilder

ComboBoxBuilder.ModelStep

Field Summary

Fields

Modifier and Type	Field	Description
protected final ComboBoxModel<T>	comboBoxModel

Fields inherited from interface is.codion.swing.common.ui.component.combobox.ComboBoxBuilder

MOUSE_WHEEL_SCROLLING

Fields inherited from interface is.codion.swing.common.ui.component.builder.ComponentValueBuilder

COMPONENT_VALUE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DefaultComboBoxBuilder(ComboBoxModel<T> comboBoxModel)

Method Summary

Modifier and Type	Method	Description
final B	completionMode(Completion.Mode completionMode)
protected C	createComboBox()
protected final C	createComponent()	Creates the component.
protected final ComponentValue<T,C>	createComponentValue(C component)	Creates the component value
final B	editable(boolean editable)
final B	editor(@Nullable ComboBoxEditor editor)
final B	itemListener(ItemListener itemListener)
final B	maximumRowCount(int maximumRowCount)
final B	mouseWheelScrolling(boolean mouseWheelScrolling)	Enable mouse wheel scrolling on the combo box
final B	mouseWheelScrollingWithWrapAround(boolean mouseWheelScrollingWithWrapAround)	Enable mouse wheel scrolling on the combo box, with wrap around
final B	moveCaretToFrontOnSelection(boolean moveCaretToFrontOnSelection)	When a JComboBox is editable, and a long item is selected, the caret is moved to the end, hiding the start of the selected item.
final B	normalize(boolean normalize)	Specifies whether to normalize strings during auto-completion
final B	popupWidth(int popupWidth)	Only applicable for the system and cross-platform Look and Feels.
final B	renderer(@Nullable ListCellRenderer<T> renderer)

Methods inherited from class is.codion.swing.common.ui.component.builder.AbstractComponentValueBuilder

buildValue, buildValue, configureComponent, consumer, link, link, listener, modifiedIndicator, modifiedIndicatorFactory, onBuildValue, validator, validIndicator, validIndicator, validIndicatorFactory, value

Methods inherited from class is.codion.swing.common.ui.component.builder.AbstractComponentBuilder

background, border, build, build, clientProperty, componentListener, componentOrientation, enabled, enabled, enableTransferFocusOnEnter, enableValidIndicator, focusable, focusable, focusCycleRoot, focusListener, font, foreground, keyEvent, keyListener, label, label, maximumHeight, maximumSize, maximumWidth, minimumHeight, minimumSize, minimumWidth, mouseListener, mouseMotionListener, mouseWheelListener, name, onBuild, onSetVisible, opaque, popupMenu, popupMenuControl, popupMenuControls, preferredHeight, preferredSize, preferredWidth, propertyChangeListener, propertyChangeListener, scrollPane, self, supportsNull, toolTipText, toolTipText, transferFocusOnEnter, transferFocusOnEnter, transferHandler, visible, visible

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface is.codion.swing.common.ui.component.builder.ComponentBuilder

background, border, build, build, clientProperty, componentListener, componentOrientation, enabled, enabled, focusable, focusable, focusCycleRoot, focusListener, font, foreground, get, keyEvent, keyListener, label, label, maximumHeight, maximumSize, maximumWidth, minimumHeight, minimumSize, minimumWidth, mouseListener, mouseMotionListener, mouseWheelListener, name, onBuild, onSetVisible, opaque, popupMenu, popupMenuControl, popupMenuControls, preferredHeight, preferredSize, preferredWidth, propertyChangeListener, propertyChangeListener, scrollPane, toolTipText, toolTipText, transferFocusOnEnter, transferFocusOnEnter, transferHandler, visible, visible

Methods inherited from interface is.codion.swing.common.ui.component.builder.ComponentValueBuilder

buildValue, buildValue, consumer, link, link, listener, modifiedIndicator, modifiedIndicatorFactory, onBuildValue, validator, validIndicator, validIndicator, validIndicatorFactory, value

Field Details

comboBoxModel

protected final ComboBoxModel<T> comboBoxModel

Constructor Details

DefaultComboBoxBuilder

protected DefaultComboBoxBuilder(ComboBoxModel<T> comboBoxModel)

Method Details

editable

public final B editable(boolean editable)

Specified by:

editable in interface ComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Parameters:

editable - specifies whether the combo box should be editable

Returns:

this builder instance

See Also:

• JComboBox.setEditable(boolean)

completionMode

public final B completionMode(Completion.Mode completionMode)

Specified by:

completionMode in interface ComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Parameters:

completionMode - the completion mode

Returns:

this builder instance

normalize

public final B normalize(boolean normalize)

Description copied from interface: ComboBoxBuilder

Specifies whether to normalize strings during auto-completion

Specified by:

normalize in interface ComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Parameters:

normalize - true if strings should be normalized during autocomplete

Returns:

this builder instance

See Also:

• ComboBoxBuilder.completionMode(Completion.Mode)

renderer

public final B renderer(@Nullable ListCellRenderer<T> renderer)

Specified by:

renderer in interface ComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Parameters:

renderer - the renderer for the combo box

Returns:

this builder instance

See Also:

• JComboBox.setRenderer(ListCellRenderer)

editor

public final B editor(@Nullable ComboBoxEditor editor)

Specified by:

editor in interface ComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Parameters:

editor - the editor for the combo box

Returns:

this builder instance

See Also:

• JComboBox.setEditor(ComboBoxEditor)

mouseWheelScrolling

public final B mouseWheelScrolling(boolean mouseWheelScrolling)

Description copied from interface: ComboBoxBuilder

Enable mouse wheel scrolling on the combo box

Specified by:

mouseWheelScrolling in interface ComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Parameters:

mouseWheelScrolling - true if mouse wheel scrolling should be enabled

Returns:

this builder instance

See Also:

• ComboBoxBuilder.MOUSE_WHEEL_SCROLLING

mouseWheelScrollingWithWrapAround

public final B mouseWheelScrollingWithWrapAround(boolean mouseWheelScrollingWithWrapAround)

Description copied from interface: ComboBoxBuilder

Enable mouse wheel scrolling on the combo box, with wrap around

Specified by:

mouseWheelScrollingWithWrapAround in interface ComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Parameters:

mouseWheelScrollingWithWrapAround - true if mouse wheel scrolling with wrap around should be enabled

Returns:

this builder instance

maximumRowCount

public final B maximumRowCount(int maximumRowCount)

Specified by:

maximumRowCount in interface ComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Parameters:

maximumRowCount - the maximum row count before a scroll bar is shown

Returns:

this builder instance

See Also:

• JComboBox.setMaximumRowCount(int)

moveCaretToFrontOnSelection

public final B moveCaretToFrontOnSelection(boolean moveCaretToFrontOnSelection)

Description copied from interface: ComboBoxBuilder

When a JComboBox is editable, and a long item is selected, the caret is moved to the end, hiding the start of the selected item. Enabling this moves the caret to the front on selection, thereby showing the start of the selected item. Note that this only works in conjunction with a FilterComboBoxModel. This is enabled by default.

Specified by:

moveCaretToFrontOnSelection in interface ComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Parameters:

moveCaretToFrontOnSelection - if true the caret is moved to the front of the editor component on selection, displaying the start of the selected item, instead of the end

Returns:

this builder instance

popupWidth

public final B popupWidth(int popupWidth)

Description copied from interface: ComboBoxBuilder

Only applicable for the system and cross-platform Look and Feels.

Specified by:

popupWidth in interface ComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Parameters:

popupWidth - a fixed popup width

Returns:

this builder instance

itemListener

public final B itemListener(ItemListener itemListener)

Specified by:

itemListener in interface ComboBoxBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Parameters:

itemListener - the item listener

Returns:

this builder instance

See Also:

• JComboBox.addItemListener(ItemListener)

createComponent

protected final C createComponent()

Description copied from class: AbstractComponentBuilder

Creates the component.

Specified by:

createComponent in class AbstractComponentBuilder<C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Returns:

a new component instance

createComponentValue

protected final ComponentValue<T,C> createComponentValue(C component)

Description copied from class: AbstractComponentValueBuilder

Creates the component value

Specified by:

createComponentValue in class AbstractComponentValueBuilder<T,C extends JComboBox<T>,B extends ComboBoxBuilder<T,C,B>>

Parameters:

component - the component

Returns:

a component value based on the component

createComboBox

protected C createComboBox()