Komponenten modified by Manuel Geier

Manuel Geier — Sun, 01 Jun 2014 14:05:20 -0000

Komponenten

Im folgenden werden alle Komponenten die zur Verfügung stehen beschrieben:

Alle Komponenten werden über die CWComponentFactory erzeugt, haben das Prefix CW und befinden sich im Package cw.boardingschoolmanagement.gui.component. Beachten Sie die Hinweise zur Freigabe und zur Verwendung des ComponentContainers.

Label

Klasse:

CWLabel

Namenskonvention:

l: lBezeichnung

Erzeugen:

CWComponentFactory.createLabel(String text);
CWComponentFactory.createLabel(ValueModel valueModel);
CWComponentFactory.createLabel(ValueModel valueModel, Format format);
CWComponentFactory.createLabel(String text, Icon icon);
CWComponentFactory.createLabel(ValueModel valueModel, Icon icon);
CWComponentFactory.createLabel(ValueModel valueModel, Icon icon, Format format);

Parameter:

String text:
Hier wird der anzuzeigende Text mitgegeben. (Wird intern automatisch in ein ValueModel umgewandelt)

ValueModel valueModel:
Hier wird ein ValueModel (Typ: String) mitgegeben, dass dann angezeigt wird. Wird das ValueModel geändert, ändert sich auch der Anzeigetext des Labels automatisch mit.

Format format:
Hier können Sie ein spezielles Format für das Label mitgeben.

Icon icon:
Hier können Sie ein Icon angeben, das vor dem Label angezeigt wird. (Icon laden, siehe hier)

Screenshot:

LabelBoolean

LabelDate

List

Table

Tree

ComboBox

DateChooser

Button

RadioButton

ButtonGroup

CheckBox

CheckBoxList

MenuItem

PopupMenu

TrueFalsePanel

TextField

IntegerTextField

CurrencyTextField

FormattedTextField

TextArea

Panel

View

BackView

ScrollPane

Freigabe (ComponentContainer)

Einige Komponenten besitzen interne Listener und diese müssen auch wieder freigegeben werden. Um dies zu bewerkstelligen werden alle benutzen Komponenten in einen Container gegeben und am Schluss wird dieser freigegeben. Durch die freigabe des Containers werden automatisch die enthaltenden Komponenten freigegeben. Dies ist wichtig um gegebenfalls Memory-Leaks zu vermeiden.

Container erstellen

Um einen Container zu erstellen gibt es folgende Methode:

CWComponentContainer componentContainer = CWComponentFactory.createComponentContainer();

Komponenten hinzufügen

Um eine Komponenten den Container hinzuzufügen gibt es zwei Methoden.

componentContainer.addComponent(JComponent component); // return: CWComponentContainer
// oder
componentContainer.addComponentAndReturn(JComponent component); // return: JComponent

Bei der ersten Methode wird der Container zurückgeliefert (damit es ist möglich gleich mehrere Komponenten hintereinander hinzuzufügen (Verkettung)) und bei der zweiten Methode wird die hinzugefügte Komponente selbst wieder zurückgeliefert.

Beispiel einer Verkettung inklusive Erstellung:

CWComponentContainer componentContainer = CWComponentFactory.createComponentContainer()
       .addComponent(comp1)
       .addComponent(comp2)
       .addComponent(comp3);

Container freigeben

Um eine Container freizugeben gibt es die Methode dispose(). Nach der Freigabe sollten die Komponenten nicht mehr weiter verwendet werden, da wichtige interne Verknüpfungen entfernt werden.

componentContainer.dispose();

Namenskonventionen

Hier werden einzelne Komponenten aufgezählt und wie sie als Variablen benannt werden sollen. Das Präfix ist immer ausschlaggebend, welchen Typ die Variable hat. Nach dem Präfix folgt dann mit Großbuchstaben beginnend der Variablenbezeichnung:

Label
l
lLabelBezeichnung

Button
b
bButtonBezeichnung

Tree
tr
trTreeBezeichnung

Table
t
tTableBezeichnung

Liste
li
liListeBezeichnung

ComboBox
cb
cbComboBoxBezeichnung

CheckBox
c
cCheckBoxBezeichnung

RadioButton
rb
rbRadioButtonBezeichnung

ButtonGroup
bg
gbButtonGroupBezeichnung

Calendar
date
dateCalendarBezeichnung

Slider
sl
slSliderBezeichnung

!Textfeld
tf
tfTextfeldBezeichnung

!Textbereich
ta
taTextbereichBezeichnung

Recent changes to Komponenten