Package com.amalgamasimulation.desktop.binding.widgets

Class AbstractComboboxDataBinding<V>

java.lang.Object

com.amalgamasimulation.desktop.binding.widgets.AbstractComboboxDataBinding<V>

Type Parameters:

V - The type of selectable values

All Implemented Interfaces:

AbstractDataBinding<V>, AbstractSelectObjectDataBinding<V>

Direct Known Subclasses:

ComboboxDataBinding, ContainerComboboxDataBinding

public abstract class AbstractComboboxDataBinding<V>
extends Object
implements AbstractSelectObjectDataBinding<V>

Abstract base class for combo box data bindings with support for filtering, sorting, and validation of selectable values. Provides core functionality for binding SWT ComboViewer controls to model values.

Author:

Ionov Ivan

See Also:

• AbstractSelectObjectDataBinding

Field Summary

Fields

Modifier and Type	Field	Description
protected BooleanSupplier	canBeNull	Supplier determining whether null values are allowed.
protected org.eclipse.jface.viewers.ComboViewer	comboViewer	The bound combo viewer control.
protected Comparator<V>	comparator	Comparator for sorting values in the combo box.
protected org.eclipse.jface.viewers.IStructuredContentProvider	contentProvider	Content provider for the combo viewer.
protected org.eclipse.jface.fieldassist.ControlDecoration	controlDecoration	Control decoration for displaying validation errors.
protected Predicate<V>	filter	Filter predicate for limiting available values in the combo box.
protected List<V>	values	The list of available values for selection.

Constructor Summary

Constructors

Constructor	Description
AbstractComboboxDataBinding()

Method Summary

Modifier and Type	Method	Description
void	canBeNull(BooleanSupplier canBeNull)	Sets whether null values are permitted in the combo box.
void	createBinding()	Creates and initializes the data binding.
void	enable(boolean enable)	Enables or disables the bound control.
void	executeToModel()	Executes the binding to pull data from UI control to model.
void	executeToTarget()	Executes the binding to push data from model to UI control (target).
protected org.eclipse.jface.viewers.IBaseLabelProvider	getLabelProvider()	Gets the label provider for the combo viewer.
void	setComparator(Comparator<V> comparator)	Sets a comparator to define the sorting order of values.
void	setControl(Object control)	Sets the UI control for this binding.
void	setFilter(Predicate<V> filter)	Sets a filter predicate to determine which values should be included.
void	values(List<V> values)	Sets the complete list of available values for selection.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.amalgamasimulation.desktop.binding.widgets.AbstractDataBinding

createControlDecoration, doAction, getValue

Field Details

comboViewer

protected org.eclipse.jface.viewers.ComboViewer comboViewer

The bound combo viewer control.

filter

protected Predicate<V> filter

Filter predicate for limiting available values in the combo box. Null means no filtering is applied.

comparator

protected Comparator<V> comparator

Comparator for sorting values in the combo box. Null means no sorting is applied.

values

protected List<V> values

The list of available values for selection.

canBeNull

protected BooleanSupplier canBeNull

Supplier determining whether null values are allowed. Defaults to false (null values not allowed).

controlDecoration

protected org.eclipse.jface.fieldassist.ControlDecoration controlDecoration

Control decoration for displaying validation errors.

contentProvider

protected org.eclipse.jface.viewers.IStructuredContentProvider contentProvider

Content provider for the combo viewer. Defaults to ArrayContentProvider.

Constructor Details

AbstractComboboxDataBinding

public AbstractComboboxDataBinding()

Method Details

getLabelProvider

protected org.eclipse.jface.viewers.IBaseLabelProvider getLabelProvider()

Gets the label provider for the combo viewer. Can be overridden by subclasses to provide custom labeling.

Returns:

The label provider instance

executeToTarget

public void executeToTarget()

Description copied from interface: AbstractDataBinding

Executes the binding to push data from model to UI control (target).

Specified by:

executeToTarget in interface AbstractDataBinding<V>

executeToModel

public void executeToModel()

Description copied from interface: AbstractDataBinding

Executes the binding to pull data from UI control to model.

Specified by:

executeToModel in interface AbstractDataBinding<V>

createBinding

public void createBinding()

Description copied from interface: AbstractDataBinding

Creates and initializes the data binding.

Specified by:

createBinding in interface AbstractDataBinding<V>

enable

public void enable(boolean enable)

Description copied from interface: AbstractDataBinding

Enables or disables the bound control.

Specified by:

enable in interface AbstractDataBinding<V>

Parameters:

enable - true to enable, false to disable

values

public void values(List<V> values)

Description copied from interface: AbstractSelectObjectDataBinding

Sets the complete list of available values for selection.

Specified by:

values in interface AbstractSelectObjectDataBinding<V>

Parameters:

values - List of all possible values

setControl

public void setControl(Object control)

Description copied from interface: AbstractDataBinding

Sets the UI control for this binding.

Specified by:

setControl in interface AbstractDataBinding<V>

Parameters:

control - The control to bind to

setFilter

public void setFilter(Predicate<V> filter)

Description copied from interface: AbstractSelectObjectDataBinding

Sets a filter predicate to determine which values should be included.

Specified by:

setFilter in interface AbstractSelectObjectDataBinding<V>

Parameters:

filter - Predicate that returns true for values to include

setComparator

public void setComparator(Comparator<V> comparator)

Description copied from interface: AbstractSelectObjectDataBinding

Sets a comparator to define the sorting order of values.

Specified by:

setComparator in interface AbstractSelectObjectDataBinding<V>

Parameters:

comparator - Comparator to use for sorting values

canBeNull

public void canBeNull(BooleanSupplier canBeNull)

Sets whether null values are permitted in the combo box.

Parameters:

canBeNull - Supplier that returns true if null values are allowed