Standardm\u00e4\u00dfig unterst\u00fctzt die JList und auch JComboBox keine Separatoren, doch die Unterteilung in Segmente ist in der Praxis sehr n\u00fctzlich. Microsoft Word und PowerPoint benutzt sie zum Beispiel, um die zuletzt vom Benutzer ausgew\u00e4hlten Zeichens\u00e4tze prominent oben in der Liste zu haben (Excel dagegen nicht).<\/p>\n
Wir wollen diese M\u00f6glichkeit nachbilden, und dabei noch einiges \u00fcber Modelle und Renderer lernen.<\/p>\n
<\/p>\n
Bei der Umsetzung gibt es unterschiedliche Varianten, die sich neben der technischen Implementierung darin unterscheiden, ob das Modell eine Markierung f\u00fcr den Separator enth\u00e4lt oder nicht. Wir stellen beide Ans\u00e4tze vor und beginnen mit der ersten Variante, einem Zellen-Renderer Positionen mitzugeben, die sagen, wo ein Trennstrich zu zeichnen ist.<\/p>\n
JFrame frame = new JFrame();<\/p>\n
frame.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );<\/p>\n
String[] items = { "Cambria", "Arial", "Verdana", "Times" };<\/p>\n
JComboBox<String> comboBox = new JComboBox<String>( items );<\/p>\n
ListCellRenderer<String> renderer = new SeparatorAwareListCellRenderer1<String>(<\/b><\/p>\n
comboBox.getRenderer(), 0 );<\/b><\/p>\n
comboBox.setRenderer( renderer );<\/b><\/p>\n
frame.add( comboBox );<\/p>\n
frame.pack();<\/p>\n
frame.setVisible( true );<\/p>\n
Die eigene Klasse SeparatorAwareListCellRenderer1 ist ein ListCellRenderer, den die JComboBox zur Darstellung der Komponenten nutzt. Im Konstruktor des Renderes geben wir den Original-Renderer mit \u2013 es kann ein bestimmter Renderer schon vorinstalliert sein, den wollen wir dekorieren \u2013 und ein variable Argumentliste von Positionen. Das Beispiel \u00fcbergibt nur 0, da nach dem ersten Element (Index = 0) ein Trennzeichen zu setzen sein soll, sodass Cambria und Arial abgetrennt sind.<\/p>\n
package com.tutego.insel.ui.list;<\/p>\n
import java.awt.*;<\/p>\n
import java.util.Arrays;<\/p>\n
import javax.swing.*;<\/p>\n
public class SeparatorAwareListCellRenderer1<E> implements ListCellRenderer<E><\/p>\n
{<\/p>\n
private final ListCellRenderer<? super E> delegate;<\/p>\n
private final int[] indexes;<\/p>\n
private final JPanel panel = new JPanel( new BorderLayout() );<\/p>\n
public SeparatorAwareListCellRenderer1( ListCellRenderer<? super E> delegate, int… indexes )<\/p>\n
{<\/p>\n
Arrays.sort( indexes );<\/p>\n
this.delegate = delegate;<\/p>\n
this.indexes = indexes;<\/p>\n
}<\/p>\n
@SuppressWarnings({ "rawtypes", "unchecked" })<\/p>\n
@Override<\/p>\n
public Component getListCellRendererComponent( JList list, E value,<\/p>\n
int index, boolean isSelected,<\/p>\n
boolean cellHasFocus )<\/p>\n
{<\/p>\n
panel.removeAll();<\/b><\/p>\n
panel.add( delegate.getListCellRendererComponent( list, value, index,<\/b><\/p>\n
isSelected, cellHasFocus ) );<\/b><\/p>\n
if ( Arrays.binarySearch( indexes, index ) >= 0 )<\/b><\/p>\n
panel.add( new JSeparator(), BorderLayout.PAGE_END );<\/b><\/p>\n
<\/b><\/p>\n
return panel;<\/b><\/p>\n
}<\/p>\n
}<\/p>\n
Die Implementierung basiert auf der Idee, jede Komponenten in einen Container (JPanel) zu setzen und in diesem Container dann je nach Bedarf ein JSeparator mit unten dran zu setzen. Statt dem JPanel mit einem JSeparator auszustatten kann ebenfalls auch ein Border unten gezeichnet werden. Die Anweisung Arrays.binarySearch(indexes, index) >= 0 ist als \u201econtains\u201c zu verstehen, also ein Test, ob der Index im Feld ist \u2013 leider gibt es so eine Methode nicht in der Java-API. Wenn der Index im Feld ist, soll der Separator unter der Komponente erscheinen \u2013 dass sich eine Trennlinie auch am Anfang befinden kann ber\u00fccksichtigt die L\u00f6sung nicht, und bleibt als \u00dcbungsaufgabe f\u00fcr die Leser.<\/p>\n
Diese L\u00f6sung ist einfach, und funktioniert gut, denn vorhandene Renderer werden weiterverwendet, was sehr wichtig ist, denn gr\u00f6\u00dferen Swing-Anwendungen nutzen viele eigene Renderer, etwa um Icons und Text zusammenzufassen. Ein Nachteil ist, dass der Separator zu einen Element geh\u00f6rt, und wenn das Element etwa in der Liste ausgew\u00e4hlt wird, steht der Separator mit in der Selektion und ist nicht abgetrennt (das ist aber bei Word genauso).<\/p>\n
W\u00e4hrend die vorgestellte Variante in der Praxis gut funktioniert, wollen wir uns noch mit einer alternativen Umsetzung besch\u00e4ftigen. Sie ist deutlicher komplexer und auch nicht so flexibel. Die L\u00f6sung basiert auf der Idee, dass die Modelldaten eine Markierung f\u00fcr den Separator enthalten \u2013 die folgende L\u00f6sung nutzt null daf\u00fcr. Da JList oder JComboBox eine null problemlos vertr\u00e4gt, ist die Basis schnell umgesetzt:<\/p>\n
JFrame frame = new JFrame();<\/p>\n
frame.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );<\/p>\n
String[] items = { "Cambria", null, "Arial", "Cambria", "Verdana", "Times" };<\/p>\n
JComboBox<String> comboBox = new JComboBox<String>( items );<\/p>\n
frame.add( comboBox );<\/p>\n
frame.pack();<\/p>\n
frame.setVisible( true );<\/p>\n
Das Programm zum Start gebracht zeigt dort, wie das Model eine null liefert einfach nichts an. Die Selektion dieses null-Elements ist auch m\u00f6glich und f\u00fchrt zu keiner Ausnahme.<\/p>\n
Damit Swing das null-Element nicht als Leereintrag anzeigt, verpassen wir unserer JCombBox einen Zellen-Renderer. Der soll immer dann, wenn das Element null ist, ein Exemplar von JSeparator zeichnen. Vom Design ist es das beste, wenn der Zell-Renderer selbst die null-Elemente darstellt, aber das Zeichnen der nicht-null-Elemente an einen anderen Zell-Renderer abgibt, satt diese etwas durch einen BasicComboBoxRenderer (ein JLabel was ListCellRenderer implementiert) selbst zu renderen \u2013 das w\u00fcrde die Flexibilit\u00e4t der L\u00f6sung massiv einschr\u00e4nken.<\/p>\n
package com.tutego.insel.ui.list;<\/p>\n
import java.awt.Component;<\/p>\n
import javax.swing.*;<\/p>\n
public class SeparatorAwareListCellRenderer2<E> implements ListCellRenderer<E><\/p>\n
{<\/p>\n
private final ListCellRenderer<? super E> delegate;<\/p>\n
public SeparatorAwareListCellRenderer2( ListCellRenderer<? super E> delegate )<\/p>\n
{<\/p>\n
this.delegate = delegate;<\/p>\n
}<\/p>\n
@SuppressWarnings({ "rawtypes", "unchecked" })<\/p>\n
@Override<\/p>\n
public Component getListCellRendererComponent( JList list, E value,<\/p>\n
int index, boolean isSelected,<\/p>\n
boolean cellHasFocus )<\/p>\n
{<\/p>\n
if ( value == null )<\/b><\/p>\n
return new JSeparator();<\/b><\/p>\n
<\/b><\/p>\n
return delegate.getListCellRendererComponent( list, value, index,<\/b><\/p>\n
isSelected, cellHasFocus );<\/b><\/p>\n
}<\/p>\n
}<\/p>\n
Die eigene Klasse SeparatorAwareListCellRenderer2 bekommt einen anderen ListCellRenderer \u00fcbergeben und liefert die Komponenten dieses Delegate-Renders immer dann, wenn das Element ungleich null ist. Ist es dagegen gleich null, liefert getListCellRendererComponent() ein Exemplar des JSeparators.<\/p>\n
Im Beispielprogramm muss der Renderer nun angemeldet werden und dazu ist zu erg\u00e4nzen:<\/p>\n
comboBox.setRenderer(<\/p>\n
new SeparatorAwareListCellRenderer2<String>(comboBox.getRenderer()) );<\/p>\n
Nach dem Start des Programms ist das Ergebnis schon viel Besser: dort wo vorher die JComboBox eine leere Zeile darstellte, ist nun ein Strich.<\/p>\n
Die L\u00f6sung ist jedoch nur ein Etappensieg denn die Navigation mit der Tastatur durch die Liste zeigt eine Schwachstelle: Das null-Element l\u00e4sst sich ausw\u00e4hlen und erscheint auch als Linie im Editor\/Textfeld. Beheben l\u00e4sst sich das Problem nicht mit dem Renderer, denn der ist nur f\u00fcr die Darstellung in der Liste beauftragt. Hier muss in die Interna der Swing-Komponente eingegriffen werden. Jede Swing-Komponente hat ein korrespondierende UI-Delegate, das f\u00fcr das Verhalten und Darstellung der Komponente verantwortlich ist. F\u00fcr die JComboBox sind das Unterklassen von ComboBoxUI und zwei Methoden sind besonders interessant: selectNextPossibleValue() und selectPreviousPossibleValue(). <\/p>\n
Da jede UI-Implementierung ihre eines Look & Feel mitbringt, m\u00fcssen wir hier eigentlichen einen Dekorator bauen und jede Methode bis auf die beiden genannten an das Original weiterleiten, doch das ist jetzt zu viel Arbeit und so nehmen wir die Basisklasse WindowsComboBoxUI als Basisklasse, denn unter Beispiel nutzt das Windows LaF. In der Unterklasse implementieren wir eigene Versionen der Methoden selectNextPossibleValue() und selectPreviousPossibleValue(), die so lange die Liste nach oben\/unten laufen m\u00fcssen, bis sie ein Element ungleich null finden.<\/p>\n
Listing 1.34: com\/tutego\/insel\/ui\/list\/SeparatorAwareComboBoxUI.java<\/p>\n
package com.tutego.insel.ui.list;<\/p>\n
import com.sun.java.swing.plaf.windows.WindowsComboBoxUI;<\/p>\n
public class SeparatorAwareComboBoxUI extends WindowsComboBoxUI <\/p>\n
{<\/p>\n
@Override<\/p>\n
protected void selectNextPossibleValue()<\/b><\/p>\n
{<\/p>\n
for ( int index = comboBox.getSelectedIndex() + 1;<\/p>\n
index < comboBox.getItemCount();<\/p>\n
index++ )<\/p>\n
if ( comboBox.getItemAt( index ) != null )<\/p>\n
{<\/p>\n
comboBox.setSelectedIndex( index );<\/p>\n
break;<\/p>\n
}<\/p>\n
}<\/p>\n
@Override<\/p>\n
protected void selectPreviousPossibleValue()<\/b><\/p>\n
{<\/p>\n
for ( int index = comboBox.getSelectedIndex() – 1;<\/p>\n
index >= 0;<\/p>\n
index– )<\/p>\n
if ( comboBox.getItemAt( index ) != null )<\/p>\n
{<\/p>\n
comboBox.setSelectedIndex( index );<\/p>\n
break;<\/p>\n
}<\/p>\n
}<\/p>\n
}<\/p>\n
Das UI-Objekt muss ebenfalls angemeldet werden:<\/p>\n
comboBox.setUI( new SeparatorAwareComboBoxUI() );<\/p>\n
Enth\u00e4lt die Liste null-Elemente \u00fcberspringt die Tastennavigation \u00fcber die Cursor-Taste diese. Doch auch mit diesem Teilst\u00fcck fehlt ein weitere Detail: Mit feinem Klick l\u00e4sst sich die Linie doch noch ausw\u00e4hlen. Das ist keine Frage des Renderes und auch keine Frage der Tastaturnavigation \u2013 es muss untersagt werden, dass bei der Aktivierung ein null-Element in zum Editor kommen kann. Hier ist Methode setSelectedItem() von JComboBox entscheidend. Denn jedes Element was selektiert wird \u2013 und dadurch auch in der Textfeld kommt \u2013 geht durch die Methode durch. Wenn wir die Methode \u00fcberschreiben, und bei null-Elemente einfach nichts tun, wird auch das null-Element nicht selektiert und im Textfeld bleibt das letzte Element.<\/p>\n
Damit auch spezielle Implementierungen von JComboBox von diesem Verhalten profitieren k\u00f6nnten, m\u00fcssen wir wieder einen Dekorator schreiben, doch das kostet zu viel M\u00fche, und so \u00fcberschreibt eine einfache Unterklasse die setSelectedItem()-Methode. (Im Prinzip w\u00e4re auch eine \u00fcberschiebene Methoden von setSelectedIndex() sinnvoll, denn das k\u00f6nnte eine programmierte Aktivierung der null vermeiden.)<\/p>\n
package com.tutego.insel.ui.list;<\/p>\n
import javax.swing.*;<\/p>\n
public class SeparatorAwareJComboBox<E> extends JComboBox<E><\/p>\n
{<\/p>\n
public SeparatorAwareJComboBox( E… items )<\/p>\n
{<\/p>\n
super( items );<\/p>\n
}<\/p>\n
@Override<\/p>\n
public void setSelectedItem( Object anObject )<\/b><\/p>\n
{<\/b><\/p>\n
if ( anObject != null )<\/b><\/p>\n
super.setSelectedItem( anObject );<\/b><\/p>\n
}<\/b><\/p>\n
}<\/p>\n
Im Hauptprogramm muss nur diese spezielle Klasse zu Einsatz kommen:<\/p>\n
JComboBox<String> comboBox = new SeparatorAwareJComboBox<String>( items );<\/p>\n","protected":false},"excerpt":{"rendered":"
Standardm\u00e4\u00dfig unterst\u00fctzt die JList und auch JComboBox keine Separatoren, doch die Unterteilung in Segmente ist in der Praxis sehr n\u00fctzlich. Microsoft Word und PowerPoint benutzt sie zum Beispiel, um die zuletzt vom Benutzer ausgew\u00e4hlten Zeichens\u00e4tze prominent oben in der Liste zu haben (Excel dagegen nicht). Wir wollen diese M\u00f6glichkeit nachbilden, und dabei noch einiges \u00fcber […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":"","_links_to":"","_links_to_target":""},"categories":[11,10],"tags":[],"class_list":["post-1001","post","type-post","status-publish","format-standard","hentry","category-insel","category-swing"],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/1001","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/comments?post=1001"}],"version-history":[{"count":0,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/posts\/1001\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/media?parent=1001"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/categories?post=1001"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tutego.de\/blog\/javainsel\/wp-json\/wp\/v2\/tags?post=1001"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}