Malen in Swing Teil 1: der grundlegende Mechanismus - Versionsgeschichte

Stefanhuglfing am 23. März 2022 um 19:49 Uhr

2022-03-23T19:49:28Z

← Nächstältere Version		Version vom 23. März 2022, 19:49 Uhr
Zeile 25:		Zeile 25:
	Im allgemeinen sollten Programme es vermeiden, darstellenden Code an irgendeinen Punkt zu setzen, wo er von außerhalb des Bereichs der paintComponent Methode aufgerufen werden könnte. Warum? Weil solcher Code manchmal aufgerufen werden kann, wenn es nicht angebracht ist zu malen -- zum Beispiel bevor die Komponente sichtbar ist oder Zugang zu einem gültigen Graphics Objekt hat. Es wird nicht empfohlen, daß Programme paintComponent() direkt aufrufen.		Im allgemeinen sollten Programme es vermeiden, darstellenden Code an irgendeinen Punkt zu setzen, wo er von außerhalb des Bereichs der paintComponent Methode aufgerufen werden könnte. Warum? Weil solcher Code manchmal aufgerufen werden kann, wenn es nicht angebracht ist zu malen -- zum Beispiel bevor die Komponente sichtbar ist oder Zugang zu einem gültigen Graphics Objekt hat. Es wird nicht empfohlen, daß Programme paintComponent() direkt aufrufen.

	In einem systemausgelösten Malvorgang, bittet das System eine Komponente, ihren Inhalt darzustellen, normalerweise aus einem der folgenden Gründe:		In einem systemausgelösten Malvorgang bittet das System eine Komponente, ihren Inhalt darzustellen, normalerweise aus einem der folgenden Gründe:

	* Die Komponente wird zum erstenmal sichtbar auf dem Bildschirm abgebildet.		* Die Komponente wird zum erstenmal sichtbar auf dem Bildschirm abgebildet.

L-ectron-X am 22. Dezember 2018 um 10:26 Uhr

2018-12-22T10:26:30Z

← Nächstältere Version		Version vom 22. Dezember 2018, 10:26 Uhr
Zeile 232:		Zeile 232:
	{{Fragen stellen}}		{{Fragen stellen}}
	[[Kategorie:Tutorials (Java)]]		[[Kategorie:Tutorials (Java)]]
			[[Kategorie:Java 2D]]
	[[Kategorie:Swing]]		[[Kategorie:Swing]]

L-ectron-X am 22. Dezember 2018 um 10:24 Uhr

2018-12-22T10:24:58Z

← Nächstältere Version		Version vom 22. Dezember 2018, 10:24 Uhr
Zeile 231:		Zeile 231:

	{{Fragen stellen}}		{{Fragen stellen}}
	~~[[Kategorie:Java]]~~
	[[Kategorie:Tutorials (Java)]]		[[Kategorie:Tutorials (Java)]]
	[[Kategorie:Swing]]		[[Kategorie:Swing]]

L-ectron-X: /* Die repaint Methode mit Argumenten */

2018-11-16T13:08:05Z

Die repaint Methode mit Argumenten

← Nächstältere Version		Version vom 16. November 2018, 13:08 Uhr
Zeile 223:		Zeile 223:
	Diese Argumente dienen dazu, das "clip"-Rechteck zu definieren, das im Graphics Objekt der paintComponent Methode den Bereich darstellt, der aktualisieren muss (Graphics#getClipBounds). Die paintComponent Methode muss nur das neuzeichnen, was sich mit dem "clip"-Rechteck überschneidet.		Diese Argumente dienen dazu, das "clip"-Rechteck zu definieren, das im Graphics Objekt der paintComponent Methode den Bereich darstellt, der aktualisieren muss (Graphics#getClipBounds). Die paintComponent Methode muss nur das neuzeichnen, was sich mit dem "clip"-Rechteck überschneidet.

	Es ist ein allgemeiner Fehler, immer die keine-Argumente Version zu benutzen, die immer die gesamte Komponente neu zeichnet, was häufig zu nicht notwendigen Malverarbeitungen führt. Ein Beispiel für die Verwendung von repaint() mit Argumenten wird im zweiten Teil dieses Tutorials eingeführt:		Es ist ein allgemeiner Fehler, immer die keine-Argumente Version zu benutzen, die immer die gesamte Komponente neu zeichnet, was häufig zu nicht notwendigen Malverarbeitungen führt.

			'''Ein Beispiel für die Verwendung von repaint() mit Argumenten wird im zweiten Teil dieses Tutorials eingeführt:'''

	=[[Malen in Swing Teil 2: ein einfaches Malprogramm]]=		=[[Malen in Swing Teil 2: ein einfaches Malprogramm]]=

L-ectron-X am 16. November 2018 um 13:06 Uhr

2018-11-16T13:06:50Z

← Nächstältere Version		Version vom 16. November 2018, 13:06 Uhr
Zeile 225:		Zeile 225:
	Es ist ein allgemeiner Fehler, immer die keine-Argumente Version zu benutzen, die immer die gesamte Komponente neu zeichnet, was häufig zu nicht notwendigen Malverarbeitungen führt. Ein Beispiel für die Verwendung von repaint() mit Argumenten wird im zweiten Teil dieses Tutorials eingeführt:		Es ist ein allgemeiner Fehler, immer die keine-Argumente Version zu benutzen, die immer die gesamte Komponente neu zeichnet, was häufig zu nicht notwendigen Malverarbeitungen führt. Ein Beispiel für die Verwendung von repaint() mit Argumenten wird im zweiten Teil dieses Tutorials eingeführt:

	[[Malen in Swing Teil 2: ein einfaches Malprogramm]]		=[[Malen in Swing Teil 2: ein einfaches Malprogramm]]=


			{{Fragen stellen}}
	[[Kategorie:Java]]		[[Kategorie:Java]]
	[[Kategorie:Tutorials (Java)]]		[[Kategorie:Tutorials (Java)]]
	[[Kategorie:Swing]]		[[Kategorie:Swing]]

L-ectron-X am 8. März 2018 um 19:05 Uhr

2018-03-08T19:05:44Z

← Nächstältere Version		Version vom 8. März 2018, 19:05 Uhr
Zeile 11:		Zeile 11:
	überschriebenen Methode setzen sollte, und das Toolkit ruft diese Methode auf, wenn es Zeit ist zu malen. Die zu überschreibende Methode ist in '''javax.swing.JComponent''':		überschriebenen Methode setzen sollte, und das Toolkit ruft diese Methode auf, wenn es Zeit ist zu malen. Die zu überschreibende Methode ist in '''javax.swing.JComponent''':

	<~~code~~=java>protected void paintComponent(Graphics g)</~~code=java~~>		<syntaxhighlight lang="java">protected void paintComponent(Graphics g)</syntaxhighlight>

	Da in Swing ein Fenster, wie z.B. "JFrame" oder "JApplet", keine '''javax.swing.JComponent''' ist, werden wir nie direkt auf ein Fenster malen, sondern immer auf eine Swing Komponente (z.B. JPanel oder JComponent), die dem Fenster hinzugefügt wurde. Wenn das System die Methode "paintComponent" aufruft, ist der Parameter '''Graphics g''' mit dem passenden Zustand für das Malen auf dieser bestimmten Komponente vorkonfiguriert:		Da in Swing ein Fenster, wie z.B. "JFrame" oder "JApplet", keine '''javax.swing.JComponent''' ist, werden wir nie direkt auf ein Fenster malen, sondern immer auf eine Swing Komponente (z.B. JPanel oder JComponent), die dem Fenster hinzugefügt wurde. Wenn das System die Methode "paintComponent" aufruft, ist der Parameter '''Graphics g''' mit dem passenden Zustand für das Malen auf dieser bestimmten Komponente vorkonfiguriert:
Zeile 21:		Zeile 21:

	Programme müssen '''dieses Graphics Objekt''' verwenden (oder ein mit Graphics#create() von ihm abgeleitetes, siehe Bemerkung weiter unten) um die Oberfläche darzustellen. Sie sind frei, den Zustand des Graphics Objektes so zu ändern, wie es benötigt wird. Dabei ist es nützlich zu wissen, daß das Graphics Objekt in paintComponent eigentlich ein '''Graphics2D''' ist, eine Erweiterung von Graphics mit Verbesserungen bezüglich Steuerung der Geometrie, Umwandlungen von Koordinaten, Farbenverwaltung und Textdarstellung. Graphics2D ist die grundlegende Klasse zur Wiedergabe von 2D Formen, Text und Bildern auf der Java Plattform. Um sie in paintComponent benutzen zu können, müssen wir lediglich das Graphics Objekt nach Graphics2D "casten":		Programme müssen '''dieses Graphics Objekt''' verwenden (oder ein mit Graphics#create() von ihm abgeleitetes, siehe Bemerkung weiter unten) um die Oberfläche darzustellen. Sie sind frei, den Zustand des Graphics Objektes so zu ändern, wie es benötigt wird. Dabei ist es nützlich zu wissen, daß das Graphics Objekt in paintComponent eigentlich ein '''Graphics2D''' ist, eine Erweiterung von Graphics mit Verbesserungen bezüglich Steuerung der Geometrie, Umwandlungen von Koordinaten, Farbenverwaltung und Textdarstellung. Graphics2D ist die grundlegende Klasse zur Wiedergabe von 2D Formen, Text und Bildern auf der Java Plattform. Um sie in paintComponent benutzen zu können, müssen wir lediglich das Graphics Objekt nach Graphics2D "casten":
	<~~code~~=java>Graphics2D g2d = (Graphics2D)g;</~~code=java~~>		<syntaxhighlight lang="java">Graphics2D g2d = (Graphics2D)g;</syntaxhighlight>

	Im allgemeinen sollten Programme es vermeiden, darstellenden Code an irgendeinen Punkt zu setzen, wo er von außerhalb des Bereichs der paintComponent Methode aufgerufen werden könnte. Warum? Weil solcher Code manchmal aufgerufen werden kann, wenn es nicht angebracht ist zu malen -- zum Beispiel bevor die Komponente sichtbar ist oder Zugang zu einem gültigen Graphics Objekt hat. Es wird nicht empfohlen, daß Programme paintComponent() direkt aufrufen.		Im allgemeinen sollten Programme es vermeiden, darstellenden Code an irgendeinen Punkt zu setzen, wo er von außerhalb des Bereichs der paintComponent Methode aufgerufen werden könnte. Warum? Weil solcher Code manchmal aufgerufen werden kann, wenn es nicht angebracht ist zu malen -- zum Beispiel bevor die Komponente sichtbar ist oder Zugang zu einem gültigen Graphics Objekt hat. Es wird nicht empfohlen, daß Programme paintComponent() direkt aufrufen.
Zeile 38:		Zeile 38:
	[[Datei:BullsEye.jpg]]		[[Datei:BullsEye.jpg]]

	<~~code~~=java>		<syntaxhighlight lang="java">
	import java.awt.*;		import java.awt.*;
	import javax.swing.*;		import javax.swing.*;
Zeile 116:		Zeile 116:
	}		}
	}		}
	</~~code=java~~>		</syntaxhighlight>

	'''BEMERKUNGEN:'''		'''BEMERKUNGEN:'''
Zeile 132:		Zeile 132:
	Um anwendungsausgelöstes Malen zu ermöglichen, liefert das Toolkit die folgende java.awt.Component Methode, damit Programme einen asynchronen Malvorgang anfragen können:		Um anwendungsausgelöstes Malen zu ermöglichen, liefert das Toolkit die folgende java.awt.Component Methode, damit Programme einen asynchronen Malvorgang anfragen können:

	<~~code~~=java> public void repaint() </~~code=java~~>		<syntaxhighlight lang="java"> public void repaint() </syntaxhighlight>

	Der Aufruf der repaint Methode veranlasst indirekt den Aufruf der paintComponent Methode der angesprochenen Komponente, und zwar zu dem für das System am geeignetsten Zeitpunkt. Daraus folgt, daß die repaint Methode natürlich niemals von der paintComponent Methode selbst aufgerufen werden sollte!		Der Aufruf der repaint Methode veranlasst indirekt den Aufruf der paintComponent Methode der angesprochenen Komponente, und zwar zu dem für das System am geeignetsten Zeitpunkt. Daraus folgt, daß die repaint Methode natürlich niemals von der paintComponent Methode selbst aufgerufen werden sollte!
Zeile 138:		Zeile 138:
	Der folgende Code zeigt ein einfaches Beispiel von einem MouseListener, der repaint() benutzt, um Updates auf einem theoretischen Button auszulösen, wenn die Maus gedrückt und losgelassen wird:		Der folgende Code zeigt ein einfaches Beispiel von einem MouseListener, der repaint() benutzt, um Updates auf einem theoretischen Button auszulösen, wenn die Maus gedrückt und losgelassen wird:

	<~~code~~=java> MouseListener l = new MouseAdapter() {		<syntaxhighlight lang="java"> MouseListener l = new MouseAdapter() {
	public void mousePressed(final MouseEvent e) {		public void mousePressed(final MouseEvent e) {
	MyButton b = (MyButton)e.getSource();		MyButton b = (MyButton)e.getSource();
Zeile 150:		Zeile 150:
	b.repaint();		b.repaint();
	}		}
	};</~~code=java~~>		};</syntaxhighlight>
	Die Methode MyButton#setSelected setzt die Instanzvariable "selected" welche von paintComponent benutzt wird, um die Ausgabe zu steuern.		Die Methode MyButton#setSelected setzt die Instanzvariable "selected" welche von paintComponent benutzt wird, um die Ausgabe zu steuern.

Zeile 156:		Zeile 156:

	[[Datei:CageLion.jpg]]		[[Datei:CageLion.jpg]]
	<~~code~~=java>class Cage extends JComponent {		<syntaxhighlight lang="java">class Cage extends JComponent {

	private Animal animal;		private Animal animal;
Zeile 187:		Zeile 187:
	//...		//...
	cage.setAnimal(new Animal(Animal.TIGER));// mit Hilfe der Methode setAnimal(..)		cage.setAnimal(new Animal(Animal.TIGER));// mit Hilfe der Methode setAnimal(..)
	</~~code=java~~>		</syntaxhighlight>
	Der Aufruf von repaint auf der "Cage" Komponente bewirkt dann den asynchronen Aufruf der paintComponent Methode, welche das aktualisierte "Animal"-Objekt korrekt darstellt:		Der Aufruf von repaint auf der "Cage" Komponente bewirkt dann den asynchronen Aufruf der paintComponent Methode, welche das aktualisierte "Animal"-Objekt korrekt darstellt:
	<~~code~~=java>cage.repaint();</~~code=java~~>		<syntaxhighlight lang="java">cage.repaint();</syntaxhighlight>
	[[Datei:CageTiger.jpg]]		[[Datei:CageTiger.jpg]]

Zeile 200:		Zeile 200:

	Um bei dem obigen Beispiel den Löwen (lion) im Käfig (cage) zum Laufen zu bringen, könnten wir z.B. folgendes programmieren:		Um bei dem obigen Beispiel den Löwen (lion) im Käfig (cage) zum Laufen zu bringen, könnten wir z.B. folgendes programmieren:
	<~~code~~=java>		<syntaxhighlight lang="java">
	Timer timer = new javax.swing.Timer(500, new ActionListener() {		Timer timer = new javax.swing.Timer(500, new ActionListener() {

Zeile 210:		Zeile 210:
	});		});
	timer.start();		timer.start();
	</~~code=java~~>		</syntaxhighlight>

	Durch diesen Timer bewegt sich der Löwe in Schritten von jeweils 2 Pixel jede halbe Sekunde (=500 Millisekunden) nach rechts.		Durch diesen Timer bewegt sich der Löwe in Schritten von jeweils 2 Pixel jede halbe Sekunde (=500 Millisekunden) nach rechts.
Zeile 219:		Zeile 219:
	Komponenten, die komplizierte Darstellungen ausgeben, sollten repaint() mit den Argumenten aufrufen, welche nur den Bereich definieren, der eine Aktualisierung erfordert:		Komponenten, die komplizierte Darstellungen ausgeben, sollten repaint() mit den Argumenten aufrufen, welche nur den Bereich definieren, der eine Aktualisierung erfordert:

	<~~code~~=java> public void repaint(int x, int y, int width, int height) </~~code=java~~>		<syntaxhighlight lang="java"> public void repaint(int x, int y, int width, int height) </syntaxhighlight>

	Diese Argumente dienen dazu, das "clip"-Rechteck zu definieren, das im Graphics Objekt der paintComponent Methode den Bereich darstellt, der aktualisieren muss (Graphics#getClipBounds). Die paintComponent Methode muss nur das neuzeichnen, was sich mit dem "clip"-Rechteck überschneidet.		Diese Argumente dienen dazu, das "clip"-Rechteck zu definieren, das im Graphics Objekt der paintComponent Methode den Bereich darstellt, der aktualisieren muss (Graphics#getClipBounds). Die paintComponent Methode muss nur das neuzeichnen, was sich mit dem "clip"-Rechteck überschneidet.

AndreUhres: /* Die paintComponent Methode */

2012-01-24T11:12:45Z

Die paintComponent Methode

← Nächstältere Version		Version vom 24. Januar 2012, 11:12 Uhr
Zeile 124:		Zeile 124:
	* Zu Demonstrationszwecken ist es sinnvoll, die Mallogik vollständig innerhalb der JComponent Klasse zu halten. Aber wenn unsere Anwendung mehrere Instanzen einer Grafik erfassen muss, können wir ihren Code in eine separate Klasse auslagern, so dass jede Grafik als ein einzelnes Objekt behandelt werden kann. Diese Technik ist in der 2D Spiele-Programmierung üblich und wird manchmal als '''Sprite-Animation''' bezeichnet. Siehe auch: [http://docs.oracle.com/javase/tutorial/uiswing/painting/index.html Performing Custom Painting], wo im Teil "Refining the Design" die Klasse RedSquare den Malcode in eine Methode auslagert, die ein Graphics-Objekt akzeptiert, und aus der paintComponent-Methode des Panels aufgerufen wird.		* Zu Demonstrationszwecken ist es sinnvoll, die Mallogik vollständig innerhalb der JComponent Klasse zu halten. Aber wenn unsere Anwendung mehrere Instanzen einer Grafik erfassen muss, können wir ihren Code in eine separate Klasse auslagern, so dass jede Grafik als ein einzelnes Objekt behandelt werden kann. Diese Technik ist in der 2D Spiele-Programmierung üblich und wird manchmal als '''Sprite-Animation''' bezeichnet. Siehe auch: [http://docs.oracle.com/javase/tutorial/uiswing/painting/index.html Performing Custom Painting], wo im Teil "Refining the Design" die Klasse RedSquare den Malcode in eine Methode auslagert, die ein Graphics-Objekt akzeptiert, und aus der paintComponent-Methode des Panels aufgerufen wird.
	* Es ist auch oft vorteilhaft, das Malen von ausgelagerten Grafiken unabhängig von ihrer konkreten Umsetzung zu gestalten. Dazu erstellen wir eine Schnittstelle '''Paintable''' (oder wie auch immer wir sie nennen wollen), die die paint-Methode der Grafik definiert, zum Beispiel '''public void paint( Graphics g )'''. Wenn alle Grafikklassen diese Schnittstelle implementieren, können wir in der paintComponent-Methode diese "Paintable"-Objekte malen, ohne dass wir uns um ihren konkreten Typ kümmern müssen. Wir können sie sogar in einer Liste zusammenfassen, die wir dann zum Malen in einer Schleife durchlaufen können. Siehe auch: [http://www.java-forum.org/buecher-tutorials-links/14545-tutorials-mitgliedern.html#post88500 Einsteigertutorial von Beni und Roar], wo das "interface Figure" die Mal-Schnittstelle darstellt.		* Es ist auch oft vorteilhaft, das Malen von ausgelagerten Grafiken unabhängig von ihrer konkreten Umsetzung zu gestalten. Dazu erstellen wir eine Schnittstelle '''Paintable''' (oder wie auch immer wir sie nennen wollen), die die paint-Methode der Grafik definiert, zum Beispiel '''public void paint( Graphics g )'''. Wenn alle Grafikklassen diese Schnittstelle implementieren, können wir in der paintComponent-Methode diese "Paintable"-Objekte malen, ohne dass wir uns um ihren konkreten Typ kümmern müssen. Wir können sie sogar in einer Liste zusammenfassen, die wir dann zum Malen in einer Schleife durchlaufen können. Siehe auch: [http://www.java-forum.org/buecher-tutorials-links/14545-tutorials-mitgliedern.html#post88500 Einsteigertutorial von Beni und Roar], wo das "interface Figure" die Mal-Schnittstelle darstellt.
			* Jede Swing Komponente hat eine getGraphics-Methode. Diese Methode gibt einen Grafik Kontext zurück, mit dem wir außerhalb der paintComponent-Methode auf die Komponente malen können. Die offizielle Richtlinie ist, dass wir das nicht tun sollten, auch wenn es in einigen Fällen bequemer erscheinen mag. Es steht im Widerspruch zum Swing callback-Mechanismus, der das mit getGraphics Gemalte wieder zerstören kann, z.B. wenn die Komponente in der Größe verändert wird.

	==Die repaint Methode==		==Die repaint Methode==

AndreUhres: /* Die paintComponent Methode */

2012-01-24T10:22:26Z

Die paintComponent Methode

AndreUhres: /* Die paintComponent Methode */

2012-01-24T09:14:35Z

Die paintComponent Methode

← Nächstältere Version		Version vom 24. Januar 2012, 09:14 Uhr
Zeile 122:		Zeile 122:
	* Wenn wir die Super-Implementation nicht aufrufen, also kein '''super.paintComponent(g)''', müssen wir die "opaque" Eigenschaft der Komponente berücksichtigen, das heißt, wenn diese Komponente deckend ist (d.h. isOpaque() gibt "true" zurück), müssen wir den Hintergrund vollständig in einer deckenden, nicht halb durchsichtigen, Farbe ausfüllen. Wenn wir das unterlassen, werden wir wahrscheinlich visuelle Verunreinigungen sehen. Es ist also einfacher, immer "super.paintComponent(g)" aufzurufen, dann kümmert sich Swing um den Hintergrund, so dass wir keine visuellen Verunreinigungen sehen werden.		* Wenn wir die Super-Implementation nicht aufrufen, also kein '''super.paintComponent(g)''', müssen wir die "opaque" Eigenschaft der Komponente berücksichtigen, das heißt, wenn diese Komponente deckend ist (d.h. isOpaque() gibt "true" zurück), müssen wir den Hintergrund vollständig in einer deckenden, nicht halb durchsichtigen, Farbe ausfüllen. Wenn wir das unterlassen, werden wir wahrscheinlich visuelle Verunreinigungen sehen. Es ist also einfacher, immer "super.paintComponent(g)" aufzurufen, dann kümmert sich Swing um den Hintergrund, so dass wir keine visuellen Verunreinigungen sehen werden.
	* Es ist generell keine gute Idee, '''setPreferredSize(..)''' innerhalb von "paintComponent" aufzurufen. Statt dessen ist es oft besser, '''getPreferredSize()''' zu überschreiben um dort die gewünschte Größe zurückzugeben.		* Es ist generell keine gute Idee, '''setPreferredSize(..)''' innerhalb von "paintComponent" aufzurufen. Statt dessen ist es oft besser, '''getPreferredSize()''' zu überschreiben um dort die gewünschte Größe zurückzugeben.
	* Zu Demonstrationszwecken ist es sinnvoll, die Mallogik vollständig innerhalb der JComponent Klasse zu halten. Aber wenn unsere Anwendung mehrere Instanzen einer Grafik erfassen muss, können wir ihren Code in eine separate Klasse auslagern, so dass jede Grafik als ein einzelnes Objekt behandelt werden kann. Diese Technik ist in der 2D Spiele-Programmierung üblich und wird manchmal als '''Sprite-Animation''' bezeichnet.		* Zu Demonstrationszwecken ist es sinnvoll, die Mallogik vollständig innerhalb der JComponent Klasse zu halten. Aber wenn unsere Anwendung mehrere Instanzen einer Grafik erfassen muss, können wir ihren Code in eine separate Klasse auslagern, so dass jede Grafik als ein einzelnes Objekt behandelt werden kann. Diese Technik ist in der 2D Spiele-Programmierung üblich und wird manchmal als '''Sprite-Animation''' bezeichnet. Siehe auch: [http://docs.oracle.com/javase/tutorial/uiswing/painting/index.html Performing Custom Painting], wo im Teil "Refining the Design" die Klasse RedSquare den Malcode in eine Methode auslagert, die ein Graphics-Objekt akzeptiert, und aus der paintComponent-Methode des Panels aufgerufen wird.
	* Es ist auch oft vorteilhaft, das Malen von ausgelagerten Grafiken unabhängig von ihrer konkreten Umsetzung zu gestalten. Dazu erstellen wir eine Schnittstelle '''Paintable''' (oder wie auch immer wir sie nennen wollen), die die paint-Methode der Grafik definiert: '''public void paint( Graphics g )'''. Wenn alle Grafikklassen diese Schnittstelle implementieren, können wir in der paintComponent-Methode diese "Paintable"-Objekte malen, ohne dass wir uns um ihren konkreten Typ kümmern müssen. Wir können sie sogar in einer Liste zusammenfassen, die wir dann zum Malen in einer Schleife durchlaufen können.		* Es ist auch oft vorteilhaft, das Malen von ausgelagerten Grafiken unabhängig von ihrer konkreten Umsetzung zu gestalten. Dazu erstellen wir eine Schnittstelle '''Paintable''' (oder wie auch immer wir sie nennen wollen), die die paint-Methode der Grafik definiert, zum Beispiel '''public void paint( Graphics g )'''. Wenn alle Grafikklassen diese Schnittstelle implementieren, können wir in der paintComponent-Methode diese "Paintable"-Objekte malen, ohne dass wir uns um ihren konkreten Typ kümmern müssen. Wir können sie sogar in einer Liste zusammenfassen, die wir dann zum Malen in einer Schleife durchlaufen können. Siehe auch: [http://www.java-forum.org/buecher-tutorials-links/14545-tutorials-mitgliedern.html#post88500 Einsteigertutorial von Beni und Roar], wo das "interface Figure" die Mal-Schnittstelle darstellt.

	==Die repaint Methode==		==Die repaint Methode==

AndreUhres: /* Die paintComponent Methode */

2012-01-23T09:10:14Z

Die paintComponent Methode

← Nächstältere Version		Version vom 23. Januar 2012, 09:10 Uhr
Zeile 123:		Zeile 123:
	* Es ist generell keine gute Idee, '''setPreferredSize(..)''' innerhalb von "paintComponent" aufzurufen. Statt dessen ist es oft besser, '''getPreferredSize()''' zu überschreiben um dort die gewünschte Größe zurückzugeben.		* Es ist generell keine gute Idee, '''setPreferredSize(..)''' innerhalb von "paintComponent" aufzurufen. Statt dessen ist es oft besser, '''getPreferredSize()''' zu überschreiben um dort die gewünschte Größe zurückzugeben.
	* Zu Demonstrationszwecken ist es sinnvoll, die Mallogik vollständig innerhalb der JComponent Klasse zu halten. Aber wenn unsere Anwendung mehrere Instanzen einer Grafik erfassen muss, können wir ihren Code in eine separate Klasse auslagern, so dass jede Grafik als ein einzelnes Objekt behandelt werden kann. Diese Technik ist in der 2D Spiele-Programmierung üblich und wird manchmal als '''Sprite-Animation''' bezeichnet.		* Zu Demonstrationszwecken ist es sinnvoll, die Mallogik vollständig innerhalb der JComponent Klasse zu halten. Aber wenn unsere Anwendung mehrere Instanzen einer Grafik erfassen muss, können wir ihren Code in eine separate Klasse auslagern, so dass jede Grafik als ein einzelnes Objekt behandelt werden kann. Diese Technik ist in der 2D Spiele-Programmierung üblich und wird manchmal als '''Sprite-Animation''' bezeichnet.
	* Es ist auch oft vorteilhaft, das Malen von ausgelagerten Grafiken unabhängig von ihrer konkreten Umsetzung zu gestalten. Dazu erstellen wir eine Schnittstelle '''Paintable''' (oder wie auch immer wir sie nennen wollen), die die paint-Methode der Grafik definiert. Wenn alle Grafikklassen diese Schnittstelle implementieren, können wir in der paintComponent-Methode diese "Paintable"-Objekte malen, ohne dass wir uns um ihren konkreten Typ kümmern müssen. Wir können sie sogar in einer Liste zusammenfassen, die wir dann zum Malen in einer Schleife durchlaufen können.		* Es ist auch oft vorteilhaft, das Malen von ausgelagerten Grafiken unabhängig von ihrer konkreten Umsetzung zu gestalten. Dazu erstellen wir eine Schnittstelle '''Paintable''' (oder wie auch immer wir sie nennen wollen), die die paint-Methode der Grafik definiert: '''public void paint( Graphics g )'''. Wenn alle Grafikklassen diese Schnittstelle implementieren, können wir in der paintComponent-Methode diese "Paintable"-Objekte malen, ohne dass wir uns um ihren konkreten Typ kümmern müssen. Wir können sie sogar in einer Liste zusammenfassen, die wir dann zum Malen in einer Schleife durchlaufen können.

	==Die repaint Methode==		==Die repaint Methode==

← Nächstältere Version		Version vom 24. Januar 2012, 10:22 Uhr
Zeile 9:		Zeile 9:
	Zum Malen in Swing wird ein "callback" Mechanismus benutzt ("Wiederholungsbesuch").		Zum Malen in Swing wird ein "callback" Mechanismus benutzt ("Wiederholungsbesuch").
	Das bedeutet, daß ein Programm den Darstellungscode der Komponente innerhalb einer bestimmten		Das bedeutet, daß ein Programm den Darstellungscode der Komponente innerhalb einer bestimmten
	überschriebenen Methode setzen sollte, und das Toolkit ruft diese Methode auf, wenn es Zeit ist zu malen. Die zu überschreibende Methode ist in javax.swing.JComponent:		überschriebenen Methode setzen sollte, und das Toolkit ruft diese Methode auf, wenn es Zeit ist zu malen. Die zu überschreibende Methode ist in '''javax.swing.JComponent''':

	<code=java>protected void paintComponent(Graphics g)</code=java>		<code=java>protected void paintComponent(Graphics g)</code=java>

	Da in Swing ein Fenster, wie z.B. "JFrame" oder "JApplet", keine JComponent ist, werden wir nie direkt auf ein Fenster malen, sondern immer auf eine Swing Komponente (z.B. JPanel oder JComponent), die dem Fenster hinzugefügt wurde. Wenn das System die Methode "paintComponent" aufruft, ist der Parameter '''Graphics g''' mit dem passenden Zustand für das Malen auf dieser bestimmten Komponente vorkonfiguriert:		Da in Swing ein Fenster, wie z.B. "JFrame" oder "JApplet", keine '''javax.swing.JComponent''' ist, werden wir nie direkt auf ein Fenster malen, sondern immer auf eine Swing Komponente (z.B. JPanel oder JComponent), die dem Fenster hinzugefügt wurde. Wenn das System die Methode "paintComponent" aufruft, ist der Parameter '''Graphics g''' mit dem passenden Zustand für das Malen auf dieser bestimmten Komponente vorkonfiguriert:

	* Die Farbe des Graphics Objektes wird auf die foreground-Eigenschaft der Komponente eingestellt.		* Die Farbe des Graphics Objektes wird auf die foreground-Eigenschaft der Komponente eingestellt.
Zeile 20:		Zeile 20:
	* Das "clip"-Rechteck des Graphics Objektes wird auf den Bereich der Komponente eingestellt, der neu gezeichnet werden muss.		* Das "clip"-Rechteck des Graphics Objektes wird auf den Bereich der Komponente eingestellt, der neu gezeichnet werden muss.

	Programme müssen '''dieses Graphics Objekt''' verwenden (oder ein mit Graphics#create() von ihm abgeleitetes, siehe Bemerkung weiter unten) um die Oberfläche darzustellen. Sie sind frei, den Zustand des Graphics Objektes so zu ändern, wie es benötigt wird. Dabei ist es nützlich zu wissen, daß das Graphics Objekt in paintComponent eigentlich ein Graphics2D ist, eine Erweiterung von Graphics mit Verbesserungen bezüglich Steuerung der Geometrie, Umwandlungen von Koordinaten, Farbenverwaltung und Textdarstellung. Graphics2D ist die grundlegende Klasse zur Wiedergabe von 2D Formen, Text und Bildern auf der Java Plattform. Um sie in paintComponent benutzen zu können, müssen wir lediglich das Graphics Objekt nach Graphics2D "casten":		Programme müssen '''dieses Graphics Objekt''' verwenden (oder ein mit Graphics#create() von ihm abgeleitetes, siehe Bemerkung weiter unten) um die Oberfläche darzustellen. Sie sind frei, den Zustand des Graphics Objektes so zu ändern, wie es benötigt wird. Dabei ist es nützlich zu wissen, daß das Graphics Objekt in paintComponent eigentlich ein '''Graphics2D''' ist, eine Erweiterung von Graphics mit Verbesserungen bezüglich Steuerung der Geometrie, Umwandlungen von Koordinaten, Farbenverwaltung und Textdarstellung. Graphics2D ist die grundlegende Klasse zur Wiedergabe von 2D Formen, Text und Bildern auf der Java Plattform. Um sie in paintComponent benutzen zu können, müssen wir lediglich das Graphics Objekt nach Graphics2D "casten":
	<code=java>Graphics2D g2d = (Graphics2D)g;</code=java>		<code=java>Graphics2D g2d = (Graphics2D)g;</code=java>

Zeile 31:		Zeile 31:
	* Die Komponente wurde beschädigt und muß repariert werden (zum Beispiel wurde etwas verschoben, das vorher die Komponente verdeckte, und ein vorher verdeckter Teil der Komponente wird sichtbar).		* Die Komponente wurde beschädigt und muß repariert werden (zum Beispiel wurde etwas verschoben, das vorher die Komponente verdeckte, und ein vorher verdeckter Teil der Komponente wird sichtbar).

	In allen drei Fällen ruft das System automatisch die paintComponent Methode der Komponente auf. Es leuchtet ein, ~~daß~~ paintComponent möglichst schnell reagieren sollte, daher werden wir "teure" Sachen dort vermeiden wollen, wie z.B Bilder laden, Datenbank lesen, neue Objekte erzeugen, ...		In allen drei Fällen ruft das System automatisch die paintComponent Methode der Komponente auf. Es leuchtet ein, dass paintComponent '''möglichst schnell reagieren''' sollte, daher werden wir "teure" Sachen dort vermeiden wollen, wie z.B Bilder laden, Datenbank lesen, neue Objekte erzeugen, ...

	Das SwingPaintDemo Programmbeispiel zeigt den einfachen Gebrauch der paintComponent() callback		Das SwingPaintDemo Programmbeispiel zeigt den einfachen Gebrauch der paintComponent() callback