de.willuhn.jameica.gui.parts

Class TablePart

java.lang.Object

de.willuhn.jameica.gui.parts.AbstractTablePart

de.willuhn.jameica.gui.parts.TablePart

All Implemented Interfaces:

Part

Direct Known Subclasses:

BackupVersionsList, CertificateList, LogList, PluginList, RepositoryList, ServiceList

public class TablePart
extends AbstractTablePart

Erzeugt eine Standard-Tabelle.

Author:

willuhn

Field Summary

Fields

Modifier and Type	Field and Description
protected TableFormatter	tableFormatter

Fields inherited from class de.willuhn.jameica.gui.parts.AbstractTablePart

action, changeable, checkable, columns, menu, multi, rememberColWidth, rememberOrder, rememberState, selectionListeners, settings

Constructor Summary

Constructors

Constructor and Description
TablePart(Action action) Erzeugt eine neue leere Standard-Tabelle auf dem uebergebenen Composite.
TablePart(de.willuhn.datasource.GenericIterator list, Action action) Erzeugt eine neue Standard-Tabelle auf dem uebergebenen Composite.
TablePart(java.util.List list, Action action) Erzeugt eine neue Standard-Tabelle auf dem uebergebenen Composite.

Method Summary

Methods

Modifier and Type	Method and Description
void	addChangeListener(TableChangeListener l) fuegt der Tabelle einen Listener hinzu, der ausgeloest wird, wenn ein Feld aenderbar ist und vom Benutzer geaendert wurde.
void	addFeature(Feature feature) Fuegt ein Feature hinzu.
void	addItem(java.lang.Object object) Fuegt der Tabelle am Ende ein Element hinzu.
void	addItem(java.lang.Object object, boolean checked) Fuegt der Tabelle am Ende ein Element hinzu.
void	addItem(java.lang.Object object, int index) Fuegt der Tabelle ein Element hinzu.
void	addItem(java.lang.Object object, int index, boolean checked) Fuegt der Tabelle ein Element hinzu.
protected java.text.Collator	getCollator() Liefert den Collator fuer die Sortierung.
protected java.lang.String	getControlValue(org.eclipse.swt.widgets.Control control) Liefert den eingegebenen Wert im Editor.
protected org.eclipse.swt.widgets.Control	getEditorControl(int row, org.eclipse.swt.widgets.TableItem item, java.lang.String oldValue) Liefert das Editor-Control.
java.util.List	getItems() Liefert die Fach-Objekte der Tabelle.
java.util.List	getItems(boolean onlyChecked) Liefert die Fach-Objekte der Tabelle.
java.lang.Object	getSelection() Liefert die markierten Objekte.
protected java.lang.String	getSummary() Liefert den anzuzeigenden Summen-Text.
boolean	isEnabled() Prueft, ob die Tabelle aktiv ist.
protected void	orderBy(int index) Sortiert die Tabelle nach der angegebenen Spaltennummer.
protected void	orderBy(java.lang.String colName) Gibt an, nach welcher Spalte sortiert werden soll.
void	paint(org.eclipse.swt.widgets.Composite parent) Malt die Komponente in das angegebene Composite.
protected void	refreshSummary() Aktualisiert die Summenzeile.
void	removeAll() Entfernt alle Elemente aus der Tabelle.
int	removeItem(java.lang.Object item) Entfernt das genannte Element aus der Tabelle.
void	restoreState() Stellt den Zustand wieder her (markierte Objekte und Scroll-Position).
void	select(java.lang.Object[] objects) Markiert die Liste der uebergebenen Objekte.
void	setChecked(java.lang.Object[] objects, boolean checked) Wenn die Tabelle mit Checkboxen versehen ist, kann man damit bei einem Element das Haeckchen setzen oder entfernen.
void	setEnabled(boolean enabled) Aktiviert oder deaktiviert die Tabelle.
void	setFormatter(TableFormatter formatter) Definiert einen optionalen Formatierer, mit dem man SWT-maessig ganze Zeilen formatieren kann.
void	setSummary(boolean show) Legt fest, ob eine Summenzeile am Ende angezeigt werden soll.
void	setTopIndex(int i) Legt fest, bis zu welchem Element gescrollt werden soll.
int	size() Liefert die Anzahl der Elemente in dieser Tabelle.
void	sort() Sortiert die Datensaetze in der Tabelle anhand der aktuellen Spalte neu.
void	updateItem(java.lang.Object oldVersion, java.lang.Object newVersion) Aktualisiert ein einzelnes Objekt in der Tabelle.

Methods inherited from class de.willuhn.jameica.gui.parts.AbstractTablePart

addColumn, addColumn, addColumn, addColumn, addColumn, addSelectionListener, asList, select, setCheckable, setChecked, setContextMenu, setMulti, setRememberColWidths, setRememberOrder, setRememberState

Methods inherited from class java.lang.Object

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

Field Detail

tableFormatter

protected TableFormatter tableFormatter

Constructor Detail

TablePart

public TablePart(Action action)

Erzeugt eine neue leere Standard-Tabelle auf dem uebergebenen Composite.

Parameters:

action - die beim Doppelklick auf ein Element ausgefuehrt wird.

TablePart

public TablePart(de.willuhn.datasource.GenericIterator list,
         Action action)

Erzeugt eine neue Standard-Tabelle auf dem uebergebenen Composite.

Parameters:

list - Liste mit Objekten, die angezeigt werden soll.

action - die beim Doppelklick auf ein Element ausgefuehrt wird.

TablePart

public TablePart(java.util.List list,
         Action action)

Erzeugt eine neue Standard-Tabelle auf dem uebergebenen Composite.

Parameters:

list - Liste mit Objekten, die angezeigt werden soll.

action - die beim Doppelklick auf ein Element ausgefuehrt wird.

Method Detail

addFeature

public void addFeature(Feature feature)

Fuegt ein Feature hinzu.

Parameters:

feature - das Feature.

setFormatter

public void setFormatter(TableFormatter formatter)

Definiert einen optionalen Formatierer, mit dem man SWT-maessig ganze Zeilen formatieren kann.

Parameters:

formatter - Formatter.

addChangeListener

public void addChangeListener(TableChangeListener l)

fuegt der Tabelle einen Listener hinzu, der ausgeloest wird, wenn ein Feld aenderbar ist und vom Benutzer geaendert wurde.

Parameters:

l - der Listener.

setSummary

public void setSummary(boolean show)

Legt fest, ob eine Summenzeile am Ende angezeigt werden soll.

Parameters:

show - true, wenn die Summenzeile angezeigt werden soll (Default) oder false wenn sie nicht angezeigt werden soll.

getItems

public java.util.List getItems()
                        throws java.rmi.RemoteException

Description copied from class: AbstractTablePart

Liefert die Fach-Objekte der Tabelle.

Specified by:

getItems in class AbstractTablePart

Returns:

Liste der Fachobjekte.

Throws:

java.rmi.RemoteException

See Also:

Entspricht getItems(true)

getItems

public java.util.List getItems(boolean onlyChecked)
                        throws java.rmi.RemoteException

Liefert die Fach-Objekte der Tabelle.

Parameters:

onlyChecked - true, falls bei Aktivierung des Features setCheckable(true) nur genau die Objekte geliefert werden sollen, bei denen das Haekchen gesetzt ist. Die Objekte werden genau in der angezeigten Reihenfolge zurueckgeliefert.

Returns:

die Liste der Objekte.

Throws:

java.rmi.RemoteException

setTopIndex

public void setTopIndex(int i)

Legt fest, bis zu welchem Element gescrollt werden soll.

Parameters:

i - Index des Elementes, welches nach dem Scrollen als erstes angezeigt werden soll.

removeAll

public void removeAll()

Description copied from class: AbstractTablePart

Entfernt alle Elemente aus der Tabelle.

Specified by:

removeAll in class AbstractTablePart

See Also:

AbstractTablePart.removeAll()

removeItem

public int removeItem(java.lang.Object item)

Entfernt das genannte Element aus der Tabelle. Wurde die Tabelle mit einer Liste von Objekten erzeugt, die von DBObject abgeleitet sind, muss das Loeschen nicht manuell vorgenommen werden. Die Tabelle fuegt in diesem Fall automatisch jedem Objekt einen Listener hinzu, der beim Loeschen des Objektes benachrichtigt wird. Die Tabelle entfernt das Element dann selbstaendig.

Parameters:

item - zu entfernendes Element.

Returns:

die Position des entfernten Objektes oder -1 wenn es nicht gefunden wurde.

addItem

public void addItem(java.lang.Object object)
             throws java.rmi.RemoteException

Fuegt der Tabelle am Ende ein Element hinzu.

Parameters:

object - hinzuzufuegendes Element.

Throws:

java.rmi.RemoteException

addItem

public void addItem(java.lang.Object object,
           boolean checked)
             throws java.rmi.RemoteException

Fuegt der Tabelle am Ende ein Element hinzu.

Parameters:

object - hinzuzufuegendes Element.

checked - true, wenn die Tabelle checkable ist und das Objekt gecheckt sein soll.

Throws:

java.rmi.RemoteException

addItem

public void addItem(java.lang.Object object,
           int index)
             throws java.rmi.RemoteException

Fuegt der Tabelle ein Element hinzu.

Parameters:

object - hinzuzufuegendes Element.

index - Position, an der es eingefuegt werden soll.

Throws:

java.rmi.RemoteException

updateItem

public void updateItem(java.lang.Object oldVersion,
              java.lang.Object newVersion)
                throws java.rmi.RemoteException

Aktualisiert ein einzelnes Objekt in der Tabelle.

Parameters:

oldVersion - das alte Objekt.

newVersion - das neue Objekt, welches den Platz des vorherigen einnehmen soll.

Throws:

java.rmi.RemoteException

addItem

public void addItem(java.lang.Object object,
           int index,
           boolean checked)
             throws java.rmi.RemoteException

Fuegt der Tabelle ein Element hinzu.

Parameters:

object - hinzuzufuegendes Element.

index - Position, an der es eingefuegt werden soll.

checked - true, wenn die Tabelle checkable ist und das Objekt gecheckt sein soll.

Throws:

java.rmi.RemoteException

size

public int size()

Liefert die Anzahl der Elemente in dieser Tabelle.

Returns:

Anzahl der Elemente.

paint

public void paint(org.eclipse.swt.widgets.Composite parent)
           throws java.rmi.RemoteException

Description copied from interface: Part

Malt die Komponente in das angegebene Composite.

Parameters:

parent - das Composite.

Throws:

java.rmi.RemoteException

See Also:

Part.paint(org.eclipse.swt.widgets.Composite)

select

public void select(java.lang.Object[] objects)

Description copied from class: AbstractTablePart

Markiert die Liste der uebergebenen Objekte.

Specified by:

select in class AbstractTablePart

Parameters:

objects - Liste der zu markierenden Objekte.

See Also:

AbstractTablePart.select(java.lang.Object[])

setChecked

public void setChecked(java.lang.Object[] objects,
              boolean checked)

Description copied from class: AbstractTablePart

Wenn die Tabelle mit Checkboxen versehen ist, kann man damit bei einem Element das Haeckchen setzen oder entfernen. Hinweis: Dies hier ist eine leere Dummy-Implementierung. Sie muss von abgeleiteten Klassen ueberschrieben werden.

Overrides:

setChecked in class AbstractTablePart

Parameters:

objects - Liste der zu checkenden Objekte.

checked - true, wenn das Haekchen gesetzt werden soll.

See Also:

AbstractTablePart.setChecked(java.lang.Object[], boolean)

getSelection

public java.lang.Object getSelection()

Description copied from class: AbstractTablePart

Liefert die markierten Objekte. Die Funktion liefert je nach Markierung Object oder Object[].

Specified by:

getSelection in class AbstractTablePart

Returns:

das/die markierten Objekte.

See Also:

AbstractTablePart.getSelection()

refreshSummary

protected void refreshSummary()

Aktualisiert die Summenzeile.

getSummary

protected java.lang.String getSummary()

Liefert den anzuzeigenden Summen-Text. Kann von abgeleiteten Klassen ueberschrieben werde, um etwas anderes anzuzeigen.

Returns:

anzuzeigender Text oder null, wenn nichts angezeigt werden soll.

orderBy

protected void orderBy(java.lang.String colName)

Gibt an, nach welcher Spalte sortiert werden soll.

Parameters:

colName - Name der Spalte

sort

public void sort()

Sortiert die Datensaetze in der Tabelle anhand der aktuellen Spalte neu.

restoreState

public void restoreState()

Description copied from class: AbstractTablePart

Stellt den Zustand wieder her (markierte Objekte und Scroll-Position). Geschieht jedoch nur, wenn das Feature mit setRememberState(true) aktiviert wurde. Das ist eine Dummy-Implementierung, die in den abgeleiteten Klassen ueberschrieben werden kann.

Overrides:

restoreState in class AbstractTablePart

See Also:

AbstractTablePart.restoreState()

setEnabled

public void setEnabled(boolean enabled)

Aktiviert oder deaktiviert die Tabelle.

Parameters:

enabled - true, wenn sie aktiv sein soll.

isEnabled

public boolean isEnabled()

Prueft, ob die Tabelle aktiv ist.

Returns:

true, wenn sie aktiv ist.

getCollator

protected java.text.Collator getCollator()

Liefert den Collator fuer die Sortierung.

Returns:

der Collator fuer die Sortierung.

orderBy

protected void orderBy(int index)

Sortiert die Tabelle nach der angegebenen Spaltennummer.

Parameters:

index - Spaltennummer.

getEditorControl

protected org.eclipse.swt.widgets.Control getEditorControl(int row,
                                               org.eclipse.swt.widgets.TableItem item,
                                               java.lang.String oldValue)

Liefert das Editor-Control.

Parameters:

row - die Spalte.

item - das Tabellen-Element.

oldValue - der bisherige Wert.

Returns:

der Editor oder NULL, wenn das Bearbeiten nicht erlaubt werden soll.

getControlValue

protected java.lang.String getControlValue(org.eclipse.swt.widgets.Control control)

Liefert den eingegebenen Wert im Editor.

Parameters:

control - das Control des Editors.

Returns:

der eingegebene Wert.