de.ipcon.form.combobox

Class FComboBoxEditor

java.lang.Object

javax.swing.plaf.basic.BasicComboBoxEditor

javax.swing.plaf.basic.BasicComboBoxEditor.UIResource

de.ipcon.form.combobox.FComboBoxEditor

All Implemented Interfaces:

java.awt.event.FocusListener, java.util.EventListener, javax.swing.ComboBoxEditor, javax.swing.plaf.UIResource

public class FComboBoxEditor
extends javax.swing.plaf.basic.BasicComboBoxEditor.UIResource

A custom BasicComboBoxEditor descendant that handles bidirectional string-to-value conversion based on a given AttributeI. This editor is designed to work with FComboBox to ensure that the user's text input is correctly converted into the appropriate object type for the underlying data model and that the data model's object values are correctly converted into displayable strings. It manages two primary conversion flows:

1. From the editor's text field (String) to a model entry (Object).
2. From a model entry (Object) to the editor's text field (String).

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.plaf.basic.BasicComboBoxEditor

javax.swing.plaf.basic.BasicComboBoxEditor.UIResource

Constructor Summary

Constructors

Constructor and Description
FComboBoxEditor(AttributeI _attr, AbstractModel _model) Constructs an FComboBoxEditor.
FComboBoxEditor(AttributeI _attr, AbstractModel _model, java.lang.String _nullChoiceTitle)

Method Summary

Modifier and Type	Method and Description
java.lang.String	comboBoxValueToEditorValue(java.lang.Object _entry) Converts a combo box entry (an Object) to a displayable string for the editor.
java.lang.Object	editorValueToComboBoxValue(java.lang.Object _editorValue) Converts an editor's value (a String) to a corresponding combo box entry (an Object).
AttributeI	getAttr()
java.lang.Object	getItem() Retrieves the converted value from the editor component.
AbstractModel	getModel()
java.lang.String	getNullChoiceTitle()
void	setAttr(AttributeI $5)
void	setItem(java.lang.Object _entry) Sets the value in the editor's text component based on a combo box entry.
void	setModel(AbstractModel $6)
void	setNullChoiceTitle(java.lang.String $7)

Methods inherited from class javax.swing.plaf.basic.BasicComboBoxEditor

addActionListener, focusGained, focusLost, getEditorComponent, removeActionListener, selectAll

Methods inherited from class java.lang.Object

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

Constructor Detail

FComboBoxEditor

public FComboBoxEditor(AttributeI _attr,
                       AbstractModel _model)

Constructs an FComboBoxEditor.

Parameters:

_attr - The attribute that defines the type of value to be handled.

_model - The data model of the combo box.

_nullChoiceTitle - The label to use for a null entry. If null, an empty string is used.

FComboBoxEditor

public FComboBoxEditor(AttributeI _attr,
                       AbstractModel _model,
                       java.lang.String _nullChoiceTitle)

Method Detail

getItem

public java.lang.Object getItem()

Retrieves the converted value from the editor component. This method is called by the combo box to get the final object value from the user's input in the text field. It delegates the conversion logic to editorValueToComboBoxValue(Object).

Specified by:

getItem in interface javax.swing.ComboBoxEditor

Overrides:

getItem in class javax.swing.plaf.basic.BasicComboBoxEditor

Returns:

The object value corresponding to the current text in the editor.

editorValueToComboBoxValue

public java.lang.Object editorValueToComboBoxValue(java.lang.Object _editorValue)

Converts an editor's value (a String) to a corresponding combo box entry (an Object). This is the core conversion method. It performs a linear search through the model's entries to find a match for the string value from the editor. This is a simple but effective approach, given that combo box models typically do not contain a vast number of entries.

Parameters:

editorValue - The string value from the editor's text field.

Returns:

The matching model entry, which can be an instance of EntryValueWrapper, a converted value, or null if no match is found.

setItem

public void setItem(java.lang.Object _entry)

Sets the value in the editor's text component based on a combo box entry. This method is called when an item is selected from the dropdown list. It delegates the conversion of the entry object to a string to comboBoxValueToEditorValue(Object).

Specified by:

setItem in interface javax.swing.ComboBoxEditor

Overrides:

setItem in class javax.swing.plaf.basic.BasicComboBoxEditor

Parameters:

entry - The combo box model entry to display.

comboBoxValueToEditorValue

public java.lang.String comboBoxValueToEditorValue(java.lang.Object _entry)

Converts a combo box entry (an Object) to a displayable string for the editor. This method handles various types of entries to ensure the correct string representation is shown to the user.

Parameters:

entry - The combo box model entry to convert.

Returns:

A String representing the entry, or the nullChoiceTitle if the entry is null.

getAttr

public AttributeI getAttr()

setAttr

public void setAttr(AttributeI $5)

getModel

public AbstractModel getModel()

setModel

public void setModel(AbstractModel $6)

getNullChoiceTitle

public java.lang.String getNullChoiceTitle()

setNullChoiceTitle

public void setNullChoiceTitle(java.lang.String $7)