Package com.amalgamasimulation.desktop.ui.builders

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

java.lang.Object

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

Type Parameters:

T - type of row value

E - type of column value (cell value)

R - column type

All Implemented Interfaces:

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

Direct Known Subclasses:

AutoCompleteComboEditingSupport.Builder, DynamicAutoCompleteComboEditingSupport.Builder

Enclosing class:

ComboEditingSupport

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

A builder class to set up the properties of a 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 ComboBoxEditingSupport<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.
ComboEditingSupport.FinalBuilder<T,E,R>	canEdit(Predicate<T> canEdit)	Set function that returns a value that indicates whether the cell can be edited
ComboEditingSupport.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>> ComboEditingSupport.ElementsBuilder<T1,E1,R1>	create(R1 columnDescriptor)
ComboEditingSupport.NameBuilder<T,E,R>	elements(org.eclipse.core.databinding.observable.list.IObservableList<E> elements)	Set the elements to be shown in the combobox
ComboEditingSupport.FinalBuilder<T,E,R>	enableNullElement(String notSetLiteral)	Add an element on top of other elements in the combobox to clear the table cell value.
ComboEditingSupport.FinalBuilder<T,E,R>	filter(BiPredicate<T,E> filter)	Add a filter.
ComboEditingSupport.FinalBuilder<T,E,R>	filter(Predicate<E> filter)	Add a filter.
ComboEditingSupport.ButtonListenerBuilder<T,E,R>	format(Function<E,String> nameExtractor)	Set up the combobox elements naming.
ComboEditingSupport.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
ComboEditingSupport.FinalBuilder<T,E,R>	maxComboBoxElementsCount(int maxComboBoxElementsCount)	Set up the max 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 ComboBoxEditingSupport<T,E> editingSupport

Constructor Details

Builder

protected Builder(R columnDescriptor)

Method Details

create

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

elements

public ComboEditingSupport.NameBuilder<T,E,R> elements(org.eclipse.core.databinding.observable.list.IObservableList<E> elements)

Description copied from interface: ComboEditingSupport.ElementsBuilder

Set the elements to be shown in the combobox

Specified by:

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

Parameters:

elements - list of elements

Returns:

builder object

format

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

Description copied from interface: ComboEditingSupport.NameBuilder

Set up the combobox elements naming. The name extractor.

Specified by:

format in interface ComboEditingSupport.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 ComboEditingSupport.FinalBuilder<T,E,R> handler(BiConsumer<T,E> listener)

Description copied from interface: ComboEditingSupport.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 ComboEditingSupport.ButtonListenerBuilder<T,E,R extends IEditableColumn<T,E,R>>

Parameters:

listener -

Returns:

builder object

enableNullElement

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

Description copied from interface: ComboEditingSupport.FinalBuilder

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

Specified by:

enableNullElement in interface ComboEditingSupport.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 ComboEditingSupport.FinalBuilder<T,E,R> filter(Predicate<E> filter)

Description copied from interface: ComboEditingSupport.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 ComboEditingSupport.FinalBuilder<T,E,R extends IEditableColumn<T,E,R>>

filter

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

Description copied from interface: ComboEditingSupport.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 ComboEditingSupport.FinalBuilder<T,E,R extends IEditableColumn<T,E,R>>

comparator

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

Description copied from interface: ComboEditingSupport.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 ComboEditingSupport.FinalBuilder<T,E,R extends IEditableColumn<T,E,R>>

maxComboBoxElementsCount

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

Description copied from interface: ComboEditingSupport.FinalBuilder

Set up the max number of values in the combo box

Specified by:

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

Parameters:

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

canEdit

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

Description copied from interface: ComboEditingSupport.FinalBuilder

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

Specified by:

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

Parameters:

canEdit -

Returns:

builder object

build

public R build()

Description copied from interface: ComboEditingSupport.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 ComboEditingSupport.FinalBuilder<T,E,R extends IEditableColumn<T,E,R>>