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<T,C,B>

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

All Implemented Interfaces:

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

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

Field Summary

Fields

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

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

TRANSFER_FOCUS_ON_ENTER

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DefaultComboBoxBuilder(ComboBoxModel<T> comboBoxModel, is.codion.common.value.Value<T> linkedValue)

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(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	popupWidth(int popupWidth)	Only used for the system and cross-platform Look and Feels.
final B	renderer(ListCellRenderer<T> renderer)
protected final void	setInitialValue(C component, T initialValue)	Sets the initial value in the component, only called for non-null values.

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

background, border, build, build, buildValue, clear, clientProperty, componentListener, componentOrientation, enabled, enabled, enableTransferFocusOnEnter, focusable, focusCycleRoot, focusListener, font, foreground, initialValue, keyEvent, keyListener, label, link, link, maximumHeight, maximumSize, maximumWidth, minimumHeight, minimumSize, minimumWidth, mouseListener, mouseMotionListener, mouseWheelListener, onBuild, onSetVisible, opaque, popupMenu, popupMenuControl, popupMenuControls, preferredHeight, preferredSize, preferredWidth, propertyChangeListener, propertyChangeListener, scrollPane, supportsNull, toolTipText, transferFocusOnEnter, transferHandler, validator, 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, buildValue, clear, clientProperty, componentListener, componentOrientation, enabled, enabled, focusable, focusCycleRoot, focusListener, font, foreground, initialValue, keyEvent, keyListener, label, link, link, maximumHeight, maximumSize, maximumWidth, minimumHeight, minimumSize, minimumWidth, mouseListener, mouseMotionListener, mouseWheelListener, onBuild, onSetVisible, opaque, popupMenu, popupMenuControl, popupMenuControls, preferredHeight, preferredSize, preferredWidth, propertyChangeListener, propertyChangeListener, scrollPane, toolTipText, transferFocusOnEnter, transferHandler, validator, visible

Field Details

comboBoxModel

protected final ComboBoxModel<T> comboBoxModel

Constructor Details

DefaultComboBoxBuilder

protected DefaultComboBoxBuilder(ComboBoxModel<T> comboBoxModel,
 is.codion.common.value.Value<T> linkedValue)

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

renderer

public final B renderer(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(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

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 for FilteredComboBoxModel. 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 used 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<T,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: AbstractComponentBuilder

Creates the component value

Specified by:

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

Parameters:

component - the component

Returns:

a component value based on the component

setInitialValue

protected final void setInitialValue(C component,
 T initialValue)

Description copied from class: AbstractComponentBuilder

Sets the initial value in the component, only called for non-null values.

Specified by:

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

Parameters:

component - the component

initialValue - the initial value, not null

createComboBox

protected C createComboBox()