> For the complete documentation index, see [llms.txt](https://klst.gitbook.io/adempiere/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://klst.gitbook.io/adempiere/dev/swing.md).

# Swing vs SwingX

## java Package javax.swing

[Quelle wikipedia](https://de.wikipedia.org/wiki/Swing_%28Java%29) : Swing ist ein UI-Paket/Package in Java. Es gehört zu den Java Foundation Classes (JFC), die eine Sammlung von Bibliotheken zur Programmierung von grafischen Benutzerschnittstellen UI bereitstellen. Swing baut auf dem älteren [AWT](https://de.wikipedia.org/wiki/Abstract_Window_Toolkit) auf und ist mit den AWT APIs verwoben.

[Quelle oracle/javase/8](https://docs.oracle.com/javase/8/docs/api/javax/swing/package-summary.html#package.description) : Provides a set of "lightweight" components that, to the maximum degree possible, work the same on all platforms. For a programmer's guide to using these components, see [Creating a GUI with JFC/Swing](https://docs.oracle.com/javase/tutorial/uiswing/index.html), a trail in The Java Tutorial.

## SwingX Package [org.jdesktop](https://pirlwww.lpl.arizona.edu/resources/guide/software/SwingX/index.html?org/jdesktop/swingx/package-summary.html)

[Quelle rheinwerk-verlag.de](http://openbook.rheinwerk-verlag.de/java8/10_030.html) [tutego.de](http://www.tutego.de/blog/javainsel/2015/11/inselraus-die-zusatzkomponentenbibliothek-swingx/) : Die SwingX-Bibliothek erweitert Swing und füget Funktionalität hinzu und stellt ganz neue UI-Komponenten bereit, etwa eine Mischung aus Tabelle und Baum (JXTreeTable).

[Quelle javabeginners.de](https://javabeginners.de/Frameworks/SwingX/index.php) : SwingX ist ein Java-Package `org.jdesktop` von SwingLabs, das auf Swing aufsetzt und eine Reihe von Komponenten bereitstellt, die die Swing-Bibliothek erheblich erweitern und ergänzen.

Nach der Übernahme von Sun durch Oracle wurden alle [SwingLabs Projekte](https://en.wikipedia.org/wiki/SwingLabs) gestoppt und die Server [java.net](https://en.wikipedia.org/wiki/Java.net) abgeschaltet. Der Code wurde als open source [gerettet](https://github.com/homebeaver/SwingSet3#readme).

### VDate vs JXDatePicker

Ein konkretes Beispiel, das die Erweiterungen in SwingX zeigt, ist die Klasse `org.jdesktop.swingx.JXDatePicker`. JXDatePicker erlaubt Datumseingabe im Textfeld mit Popup-Menü. Im Adempiere swing Client gibt es eine ähnliche Funktionalität, die mit viel Programmieraufwand erstellt wurde. Es sind die Klassen `org.compiere.grid.ed.VDate` und `Calendar`:

![](/files/-M7bg6Scvkzv9IdcYPky)

Zum Vergleich ein Demo Screenshot mit JXDatePicker:

![](/files/-M7bg95u7XDI99-5Un6h)

### Alternative zu VCheckBox

Yes-No Datentypen werden in (swing) durch `org.compiere.grid.ed.VCheckBox` implementiert, das von `javax.swingJCheckBox` abgeleitet ist. Der Renderer für die Darstellung ist gleichzeitig Editor für die Eingabe. Diese Entwurfsentscheidung impliziert zwei Werte, eben die [Yes-No](/adempiere/adm/datatype.md#yes-no)-Werte.

Yes-No Datentype werden auch als Auwahlfelder genutzt. Zum Beispiel in [Infofenstern](/adempiere/usr/2.0-window.md#infofenster). Es ist bei diesen Auswahlen nicht möglich, beide Werte zu selektieren. Zur Lösung gibt es die Listenreferenz Yes-No, die auch optional, also ohne konnkreten Wert genutzt werden kann.

Seit in Unicode 6.0 sind Emojis einheitlich kodiert und als [UTF-Zeichen](https://emojipedia.org/) verfügbar. Das ist eine mögliche Alternative zur swing Darstellung. Es gibt mehrere Möglichkeiten, nur ein Beispiel:

* leer für Auswahl any/unknown
* ⬜ U+2B1C für No
* ✅ U+2705 für Yes , alternativ ✔️ U+2714

So kann die Listenreferenz und der Renderer für Felder einheitlich gestaltet werden. Mit `VCheckBox` und `VComboBox` läßt sich das aber nicht implementieren. Statt `VCheckBox` wurde `JRendererLabel` (Codeschnipsel), statt `VComboBox` eine Subklasse von `JXComboBox` verwendet. Beide Klassen gehören zum SwingX-Paket.

```java
    		int displayType = field.getDisplayType();
			switch(displayType) {
			...
			case DisplayType.YesNo:    // 20
				cellRendererComponent = getRenderer_YesNo(value, field);
			...
			
    // emojis for No:
    static final String white_large_square = "\u2B1C";
    // for Yes:    
    static final String heavy_check_mark = "\u2714";

    Component getRenderer_YesNo(Object value, GridField field) {
    	JRendererLabel jrl = new JRendererLabel();
    	if((Boolean)value) {
    		jrl.setText(heavy_check_mark);
    	} else {
    		jrl.setText(white_large_square);
    	}
    	jrl.setHorizontalAlignment(SwingConstants.CENTER);
    	return jrl;
    }
```

![](/files/-MClmyjOVwGqNB4UGTWf)

* zum Nachlesen [Manipulating emojis in Java](https://developers.redhat.com/blog/2019/08/16/manipulating-emojis-in-java-or-what-is-%F0%9F%90%BB-1/)

### andere Beispiele

* [JXCollapsiblePane](https://javabeginners.de/Frameworks/SwingX/JXCollapsiblePane-Beispiel.php) ist von JPanel abgeleitet. Es bietet dessen Funktionalität, kann jedoch bei Bedarf animiert unsichtbar gesetzt werden.
* [JXFrame](https://javabeginners.de/Frameworks/SwingX/JXFrame-Beispiel.php) ist von JFrame abgeleitet, kann einen solchen problemlos ersetzen und stellt einige Erweiterungen, wie eine StatusBar und einen Zugriffstimer bereit.
* [JXTaskPane](https://javabeginners.de/Frameworks/SwingX/JXTaskPane-Beispiel.php) ist ist ein Container mit dem die schrittweise Abarbeitung von Aufgaben vorgegeben werden kann. Mehrere JXTaskPane werden üblicher- aber nicht norwendigerweise in einem JXTaskPaneContainer zusammengefasst.
* [JXTitledPanel](https://javabeginners.de/Frameworks/SwingX/JXTitledPanel-Beispiel.php) ist von JPanel und JXPanel abgeleitet. Es besitzt eine Titelzeile und einen separat konfigurierbaren Inhaltsbereich.