xdev.ui

Interface MasterDetailComponent<C extends JComponent>

Type Parameters:

C - The implementor's type

All Superinterfaces:

FormularComponent<C>, VirtualTableOwner

All Known Subinterfaces:

ExtendedList<C>, ExtendedTable<C>

All Known Implementing Classes:

DetailEditor.DetailComboBox, XdevComboBox, XdevListBox, XdevNmListBox, XdevTable

public interface MasterDetailComponent<C extends JComponent>
extends FormularComponent<C>, VirtualTableOwner

Extended FormularComponent which is used to display the detail records for a specific master record, or to display master records and control another MasterDetailComponent which displays the details.

A MasterDetailComponent can be connected to a Formular:

 MasterDetail.connect(MasterDetailComponent, Formular)
 

or to another MasterDetailComponent:

 MasterDetail.connect(MasterDetailComponent, MasterDetailComponent)
 

Author:

XDEV Software

See Also:

MasterDetail, MasterDetailHandler

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	MasterDetailComponent.DetailHandler Handles the detail view of a MasterDetailComponent which is used as detail of another MasterDetailComponent which is the master.

Nested classes/interfaces inherited from interface xdev.ui.FormularComponent

FormularComponent.ValueChangeListener

Field Summary

Fields inherited from interface xdev.ui.FormularComponent

DATA_FIELD_SEPARATOR

Method Summary

Modifier and Type	Method and Description
void	clearModel() Clears the underlying data model, mostly a VirtualTable, and the view.
VirtualTable.VirtualTableRow	getSelectedVirtualTableRow() Returns the selected VirtualTable.VirtualTableRow of this component, or null if nothing is selected.
void	refresh() Reloads the data from the underlying data source with the last executed resp.
void	setDetailHandler(MasterDetailComponent.DetailHandler detailHandler) Sets the handler which controls the corporation of two MasterDetailComponents.
void	setMasterValue(VirtualTable vt, Map<String,Object> record) Sets the value of this component (master), taking the value(s) of the record.

Methods inherited from interface xdev.ui.FormularComponent

addValidator, addValueChangeListener, getClientProperty, getDataField, getFilterOperator, getFormularName, getFormularValue, getValidators, hasStateChanged, isEnabled, isMultiSelect, isReadOnly, isVisible, putClientProperty, removeValidator, restoreState, saveState, setDataField, setFilterOperator, setFormularValue, setFormularValue, setReadOnly, validateState, validateState, verify

Methods inherited from interface xdev.ui.VirtualTableOwner

getVirtualTable, setVirtualTable, updateModel

Method Detail

getSelectedVirtualTableRow

VirtualTable.VirtualTableRow getSelectedVirtualTableRow()

Returns the selected VirtualTable.VirtualTableRow of this component, or null if nothing is selected.

Returns:

the selected VirtualTable.VirtualTableRow of this component

refresh

void refresh()

Reloads the data from the underlying data source with the last executed resp. default query.

clearModel

void clearModel()

Clears the underlying data model, mostly a VirtualTable, and the view.

setMasterValue

void setMasterValue(VirtualTable vt,
                    Map<String,Object> record)

Sets the value of this component (master), taking the value(s) of the record.

Called by the MasterDetailHandler if the client's value has changed.

Parameters:

vt - the underlying virtual table

record - the data <column,value>

Since:

3.2

setDetailHandler

void setDetailHandler(MasterDetailComponent.DetailHandler detailHandler)

Sets the handler which controls the corporation of two MasterDetailComponents.

Parameters:

detailHandler - the new MasterDetailComponent.DetailHandler