Package com.amalgamasimulation.desktop.ui.builders

Class EnumComboEditingSupport.Builder<T,E,R extends IEditableColumn<T,E,R>>

java.lang.Object

com.amalgamasimulation.desktop.ui.builders.EnumComboEditingSupport.Builder<T,E,R>

Type Parameters:

T - type of row value

E - type of column value (cell value)

R - column type

All Implemented Interfaces:

EnumComboEditingSupport.ButtonListenerBuilder<T,E,R>, EnumComboEditingSupport.ElementsBuilder<T,E,R>, EnumComboEditingSupport.FinalBuilder<T,E,R>, EnumComboEditingSupport.NameBuilder<T,E,R>

Enclosing class:

EnumComboEditingSupport

public static class EnumComboEditingSupport.Builder<T,E,R extends IEditableColumn<T,E,R>>
extends Object
implements EnumComboEditingSupport.ElementsBuilder<T,E,R>, EnumComboEditingSupport.NameBuilder<T,E,R>, EnumComboEditingSupport.FinalBuilder<T,E,R>, EnumComboEditingSupport.ButtonListenerBuilder<T,E,R>

A builder class to set up the properties of an enum combobox editing support. Instances of this class are created by EditableColumn objects.

The build() method is used to actually set the properties to the column.

Field Summary

Fields

Modifier and Type	Field	Description
protected final R	columnDescriptor
protected EnumComboBoxEditingSupport<T,E>	editingSupport

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Builder(R columnDescriptor)

Method Summary

Modifier and Type	Method	Description
R	build()	This is the finalization method.
EnumComboEditingSupport.FinalBuilder<T,E,R>	canEdit(Predicate<T> canEdit)	Set function that returns a value that indicates whether the cell can be edited
EnumComboEditingSupport.FinalBuilder<T,E,R>	comparator(Comparator<E> comparator)	Add a comparator that is used to sort combobox values.
static <T1, E1, R1 extends IEditableColumn<T1, E1, R1>> EnumComboEditingSupport.ElementsBuilder<T1,E1,R1>	create(R1 columnDescriptor)
EnumComboEditingSupport.NameBuilder<T,E,R>	elements(E[] elements)	Set the elements to be shown in the combobox
EnumComboEditingSupport.FinalBuilder<T,E,R>	enableNullElement(String notSetLiteral)	Add an element on top of other elements in the combobox to clear the table cell value.
EnumComboEditingSupport.FinalBuilder<T,E,R>	filter(BiPredicate<T,E> filter)	Add a filter.
EnumComboEditingSupport.FinalBuilder<T,E,R>	filter(Predicate<E> filter)	Add a filter.
EnumComboEditingSupport.ButtonListenerBuilder<T,E,R>	format(Function<E,String> nameExtractor)	Set up the combobox elements naming.
EnumComboEditingSupport.FinalBuilder<T,E,R>	handler(BiConsumer<T,E> listener)	Set function that will be executed after losing focus on the combo box editor or after pressing the Enter button
EnumComboEditingSupport.FinalBuilder<T,E,R>	maxComboBoxElementsCount(int maxComboBoxElementsCount)	Set up a maxComboBoxElementsCount that limits the number of values in the combo box

Methods inherited from class java.lang.Object

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

Field Details

columnDescriptor

protected final R extends IEditableColumn<T,E,R> columnDescriptor

editingSupport

protected EnumComboBoxEditingSupport<T,E> editingSupport

Constructor Details

Builder

protected Builder(R columnDescriptor)

Method Details

create

public static <T1,
E1,
R1 extends IEditableColumn<T1,
E1,
R1>>
EnumComboEditingSupport.ElementsBuilder<T1,E1,R1> create(R1 columnDescriptor)

elements

public EnumComboEditingSupport.NameBuilder<T,E,R> elements(E[] elements)

Description copied from interface: EnumComboEditingSupport.ElementsBuilder

Set the elements to be shown in the combobox

Specified by:

elements in interface EnumComboEditingSupport.ElementsBuilder<T,E,R extends IEditableColumn<T,E,R>>

Parameters:

elements - list of elements

Returns:

builder object

format

public EnumComboEditingSupport.ButtonListenerBuilder<T,E,R> format(Function<E,String> nameExtractor)

Description copied from interface: EnumComboEditingSupport.NameBuilder

Set up the combobox elements naming. The name extractor.

Specified by:

format in interface EnumComboEditingSupport.NameBuilder<T,E,R extends IEditableColumn<T,E,R>>

Parameters:

nameExtractor - function that converts a combobox element to a String displayed in the combobox

Returns:

builder object

handler

public EnumComboEditingSupport.FinalBuilder<T,E,R> handler(BiConsumer<T,E> listener)

Description copied from interface: EnumComboEditingSupport.ButtonListenerBuilder

Set function that will be executed after losing focus on the combo box editor or after pressing the Enter button

Specified by:

handler in interface EnumComboEditingSupport.ButtonListenerBuilder<T,E,R extends IEditableColumn<T,E,R>>

Parameters:

listener -

Returns:

builder object

enableNullElement

public EnumComboEditingSupport.FinalBuilder<T,E,R> enableNullElement(String notSetLiteral)

Description copied from interface: EnumComboEditingSupport.FinalBuilder

Add an element on top of other elements in the combobox to clear the table cell value.

Specified by:

enableNullElement in interface EnumComboEditingSupport.FinalBuilder<T,E,R extends IEditableColumn<T,E,R>>

Parameters:

notSetLiteral - the label of the new combobox element that clears the cell value (typical values are: "", etc.)

Returns:

the builder object

filter

public EnumComboEditingSupport.FinalBuilder<T,E,R> filter(Predicate<E> filter)

Description copied from interface: EnumComboEditingSupport.FinalBuilder

Add a filter. Only matching items will be displayed in the combobox.
Note that there may be at most one filter. If you call this method several times, only the last method call will be effective.

Specified by:

filter in interface EnumComboEditingSupport.FinalBuilder<T,E,R extends IEditableColumn<T,E,R>>

filter

public EnumComboEditingSupport.FinalBuilder<T,E,R> filter(BiPredicate<T,E> filter)

Description copied from interface: EnumComboEditingSupport.FinalBuilder

Add a filter. Only matching items will be displayed in the combobox.
Note that there may be at most one filter. If you call this method several times, only the last method call will be effective.

Specified by:

filter in interface EnumComboEditingSupport.FinalBuilder<T,E,R extends IEditableColumn<T,E,R>>

comparator

public EnumComboEditingSupport.FinalBuilder<T,E,R> comparator(Comparator<E> comparator)

Description copied from interface: EnumComboEditingSupport.FinalBuilder

Add a comparator that is used to sort combobox values.
Note that there may be at most one comparator. If you call this method several times, only the last method call will be effective.

Specified by:

comparator in interface EnumComboEditingSupport.FinalBuilder<T,E,R extends IEditableColumn<T,E,R>>

maxComboBoxElementsCount

public EnumComboEditingSupport.FinalBuilder<T,E,R> maxComboBoxElementsCount(int maxComboBoxElementsCount)

Description copied from interface: EnumComboEditingSupport.FinalBuilder

Set up a maxComboBoxElementsCount that limits the number of values in the combo box

Specified by:

maxComboBoxElementsCount in interface EnumComboEditingSupport.FinalBuilder<T,E,R extends IEditableColumn<T,E,R>>

Parameters:

maxComboBoxElementsCount - limitation on the number of elements in the combo box

canEdit

public EnumComboEditingSupport.FinalBuilder<T,E,R> canEdit(Predicate<T> canEdit)

Description copied from interface: EnumComboEditingSupport.FinalBuilder

Set function that returns a value that indicates whether the cell can be edited

Specified by:

canEdit in interface EnumComboEditingSupport.FinalBuilder<T,E,R extends IEditableColumn<T,E,R>>

Parameters:

canEdit -

Returns:

builder object

build

public R build()

Description copied from interface: EnumComboEditingSupport.FinalBuilder

This is the finalization method. Call this method to install the auto-complete combobox editing support on a table column.

Specified by:

build in interface EnumComboEditingSupport.FinalBuilder<T,E,R extends IEditableColumn<T,E,R>>