GridBagLayout - Versionsgeschichte

L-ectron-X: /* GridBagConstraints - Bedingungen für die Anordnung im Layout */

2020-05-14T14:12:33Z

GridBagConstraints - Bedingungen für die Anordnung im Layout

← Nächstältere Version		Version vom 14. Mai 2020, 14:12 Uhr
Zeile 187:		Zeile 187:

	==GridBagConstraints - Bedingungen für die Anordnung im Layout==		==GridBagConstraints - Bedingungen für die Anordnung im Layout==
	Im obigen Beispiel wurde ein [[Objekt]] der [[Klasse]] GridBagConstraints benutzt. Was GridBagConstraints sind und wozu die dienen, wird im Folgenden erklärt.<br>		Im obigen Beispiel wurde ein [[Objekt]] der [[Klasse]] GridBagConstraints benutzt. Was {{JAPI\|GridBagConstraints}} sind und wozu die dienen, wird im Folgenden erklärt.<br>
	GridBagConstraints sind Variablen die die Dimensionen und die Ausrichtung von GUI-Elementen in einem GridBagLayout bestimmen.		GridBagConstraints sind Variablen die die Dimensionen und die Ausrichtung von GUI-Elementen in einem GridBagLayout bestimmen.

L-ectron-X: /* Ein etwas komplexeres Beispiel */

2018-11-16T14:07:43Z

Ein etwas komplexeres Beispiel

← Nächstältere Version		Version vom 16. November 2018, 14:07 Uhr
Zeile 375:		Zeile 375:
	Folgender Java Code soll als weiterführendes Beispiel dienen:		Folgender Java Code soll als weiterführendes Beispiel dienen:

	[[~~GridBagLayout_Example~~]]		[[GridBagLayout Example]]


	{{Fragen stellen}}		{{Fragen stellen}}


	=Weiterführendes Material=		=Weiterführendes Material=

L-ectron-X am 16. November 2018 um 14:05 Uhr

2018-11-16T14:05:31Z

← Nächstältere Version		Version vom 16. November 2018, 14:05 Uhr
Zeile 381:		Zeile 381:


	==Weiterführendes Material==		=Weiterführendes Material=
	*Oracle: [https://docs.oracle.com/javase/tutorial/uiswing/layout/gridbag.html GridBagLayout]		*Oracle: [https://docs.oracle.com/javase/tutorial/uiswing/layout/gridbag.html GridBagLayout]
	*[[LayoutManager der Standard-Java-API]]		*[[LayoutManager der Standard-Java-API]]

L-ectron-X am 16. November 2018 um 14:04 Uhr

2018-11-16T14:04:38Z

← Nächstältere Version		Version vom 16. November 2018, 14:04 Uhr
Zeile 376:		Zeile 376:

	[[GridBagLayout_Example]]		[[GridBagLayout_Example]]


			{{Fragen stellen}}

L-ectron-X: /* Ein erstes einfaches Beispiel */

2018-11-16T13:48:10Z

Ein erstes einfaches Beispiel

← Nächstältere Version		Version vom 16. November 2018, 13:48 Uhr
Zeile 112:		Zeile 112:
	*/		*/
	private void example() {		private void example() {
			/*Wie wir hier sehen können, haben wir die erste der verfügbaren
			Bequemlichkeitsmethoden eingesetzt.*/
	addGB(new JButton("Norden"), gridx = 2, gridy = 1);		addGB(new JButton("Norden"), gridx = 2, gridy = 1);
	addGB(new JButton("Westen"), gridx = 1, gridy = 2);		addGB(new JButton("Westen"), gridx = 1, gridy = 2);

L-ectron-X am 7. Juli 2018 um 15:39 Uhr

2018-07-07T15:39:16Z

← Nächstältere Version		Version vom 7. Juli 2018, 15:39 Uhr
Zeile 81:		Zeile 81:
	}		}
	</syntaxhighlight>		</syntaxhighlight>

			[[Bild:GridBagLayoutExample1.jpg]]

	Für größere mit GridBagLayout aufzubauende GUIs bietet es sich an, "Bequemlichkeitsmethoden" zum Konfigurieren der {{JAPI\|GridBagConstraints}} und zum Einfügen der Komponenten zu schreiben, um den Überblick behalten zu können und alles ''in einem Rutsch'' zu erledigen.		Für größere mit GridBagLayout aufzubauende GUIs bietet es sich an, "Bequemlichkeitsmethoden" zum Konfigurieren der {{JAPI\|GridBagConstraints}} und zum Einfügen der Komponenten zu schreiben, um den Überblick behalten zu können und alles ''in einem Rutsch'' zu erledigen.

L-ectron-X: /* Das GridBagLayout */

2018-07-07T15:35:36Z

Das GridBagLayout

← Nächstältere Version		Version vom 7. Juli 2018, 15:35 Uhr
Zeile 82:		Zeile 82:
	</syntaxhighlight>		</syntaxhighlight>

	Für größere mit GridBagLayout aufzubauende GUIs bietet es sich an, "Bequemlichkeitsmethoden" zum Konfigurieren der GridBagConstraints und zum Einfügen der Komponenten zu schreiben, um den Überblick behalten zu können und alles ''in einem Rutsch'' zu erledigen.		Für größere mit GridBagLayout aufzubauende GUIs bietet es sich an, "Bequemlichkeitsmethoden" zum Konfigurieren der {{JAPI\|GridBagConstraints}} und zum Einfügen der Komponenten zu schreiben, um den Überblick behalten zu können und alles ''in einem Rutsch'' zu erledigen.

	Für den oben gezeigten Code daher nun noch einmal ein Beispiel mit Methoden, die uns das Leben für folgende Beispiele erleichtern können. Wer damit nicht klar kommt, kann selbstverständlich auch mit obiger Variante weiter programmieren.		Für den oben gezeigten Code daher nun noch einmal ein Beispiel mit Methoden, die uns das Leben für noch folgende Beispiele erleichtern können. Wer damit nicht klar kommt, kann selbstverständlich auch mit obiger Variante weiter programmieren.

	<syntaxhighlight lang="java">		<syntaxhighlight lang="java">
Zeile 183:		Zeile 183:

	==GridBagConstraints - Bedingungen für die Anordnung im Layout==		==GridBagConstraints - Bedingungen für die Anordnung im Layout==
	Im obigen Beispiel wurde ein Objekt der Klasse GridBagConstraints benutzt. Was GridBagConstraints sind und wozu die dienen, wird im Folgenden erklärt.<br>		Im obigen Beispiel wurde ein [[Objekt]] der [[Klasse]] GridBagConstraints benutzt. Was GridBagConstraints sind und wozu die dienen, wird im Folgenden erklärt.<br>
	GridBagConstraints sind Variablen die die Dimensionen und die Ausrichtung von GUI-Elementen in einem GridBagLayout bestimmen.		GridBagConstraints sind Variablen die die Dimensionen und die Ausrichtung von GUI-Elementen in einem GridBagLayout bestimmen.

	Es wird empfohlen, für jede neue Komponente auch eine neues GridBagConstraints Objekt anzulegen und die Constraints nicht mit der Methode GridBagLayout.setConstraints zu übergeben, sondern mit dem vorgesehenen Parameter der Methode Container.add:		Es wird empfohlen, für jede neue Komponente auch eine neues GridBagConstraints Objekt anzulegen und die Constraints nicht mit der [[Methode]] GridBagLayout.setConstraints zu übergeben, sondern mit dem vorgesehenen Parameter der Methode Container.add:
	<syntaxhighlight lang="java">		<syntaxhighlight lang="java">
	GridBagConstraints constraints = new GridBagConstraints();		GridBagConstraints constraints = new GridBagConstraints();
Zeile 193:		Zeile 193:
	</syntaxhighlight>		</syntaxhighlight>

			GridBagLayout unterscheidet sich sehr vom [[GridLayout]], trotz des ähnlichen Namens. Anders als bei GridLayout können die Komponenten verschieden groß sein und eine Komponente kann sich über mehrere Zeilen und Spalten erstrecken. Zeilen können auch unterschiedlich hoch und Spalten unterschiedlich breit sein, gemäß der gewünschten Größe der dort untergebrachten Komponenten (preferredSize, bzw. minimumSize falls die preferredSize zu groß ist; maximumSize spielt keine Rolle). Eine Komponente kann auch kleiner sein als ihr Anzeigebereich. Unter Anzeigebereich verstehen wir hier die Fläche der zugeordneten Zelle[n] einer Komponente.

	GridBagLayout ist sehr verschieden vom GridLayout, trotz des ähnlichen Namens. Anders als bei GridLayout können die Komponenten verschieden groß sein und eine Komponente kann sich über mehrere Zeilen und Spalten erstrecken. Zeilen können auch unterschiedlich hoch und Spalten unterschiedlich breit sein, gemäß der gewünschten Größe der dort untergebrachten Komponenten (preferredSize, bzw. minimumSize falls die preferredSize zu groß ist; maximumSize spielt keine Rolle). Eine Komponente kann auch kleiner sein als ihr Anzeigebereich. Unter Anzeigebereich verstehen wir hier die Fläche der zugeordneten Zelle[n] einer Komponente.		'''Besondere Vorsicht ist geboten, wenn die preferredSize einer Komponente keinen festen Wert hat und sich durch Benutzereingaben verändern kann, wie zum Beispiel bei einem {{JAPI\|JTextField}}.'''
			Es mag dann besser sein, der preferredSize einen festen Wert zu geben, wodurch verhindert wird, dass sich das Layout ungewollt verschiebt.
	Besondere Vorsicht ist geboten, wenn die preferredSize einer Komponente keinen festen Wert hat und sich durch Benutzereingaben verändern kann, wie zum Beispiel bei einem JTextField. Es mag dann besser sein, der preferredSize einen festen Wert zu geben, wodurch verhindert wird, dass sich das Layout ungewollt verschiebt.

	Um das Layout zu planen, zeichnen wir am besten erstmal ein passendes Raster, auf das wir die Komponenten einzeichnen. Dann können wir ihre jeweiligen Constraints leichter festlegen.		Um das Layout zu planen, zeichnen wir am besten erstmal ein passendes Raster, auf das wir die Komponenten einzeichnen. Dann können wir ihre jeweiligen Constraints leichter festlegen.
	Dabei macht es keinen Sinn, mehr Zeilen, oder Spalten einzufügen, als Komponenten aufgenommen werden sollen, um bspw. damit Platz zuwischen den Komponenten zu generieren. Leere Zellen werden nämlich ignoriert. Wie man Platz zwischen den Komponenten schafft, klären wir später weiter unten.		Dabei macht es keinen Sinn, mehr Zeilen, oder Spalten einzufügen, als Komponenten aufgenommen werden sollen, um bspw. damit Platz zuwischen den Komponenten zu generieren. '''Leere Zellen werden nämlich ignoriert'''. Wie man Platz zwischen den Komponenten schafft, klären wir später weiter unten.

	===gridx, gridy===		===gridx, gridy===
Zeile 212:		Zeile 212:
	</syntaxhighlight>		</syntaxhighlight>

	Obwohl die Koordinaten eigentlich bei 0 beginnen, haben wir der Klarheit halber in diesem Beispiel die Zeile 0 und die Spalte 0 nicht belegt. In diesem Fall schreiben wir also einfach gridx=1 für die erste Spalte und gridy=1 für die erste Zeile.		Obwohl die Koordinaten eigentlich bei 0 beginnen, haben wir der Klarheit halber in diesem Beispiel die Zeile 0 und die Spalte 0 nicht belegt. In diesem Fall schreiben wir also einfach ''gridx=1'' für die erste Spalte und ''gridy=1'' für die erste Zeile.

	Bild 1 [[Bild:GridBagLayoutExample1.jpg]]		Bild 1 [[Bild:GridBagLayoutExample1.jpg]]
Zeile 248:		Zeile 248:
	* VERTICAL: die Komponente groß genug machen, um ihren Anzeigebereich vertikal zu füllen		* VERTICAL: die Komponente groß genug machen, um ihren Anzeigebereich vertikal zu füllen
	* BOTH: die Komponente soll den ganzen Anzeigebereich füllen		* BOTH: die Komponente soll den ganzen Anzeigebereich füllen

	Der Standardwert ist NONE, also keine Skalierung.		Der Standardwert ist NONE, also keine Skalierung.

Zeile 256:		Zeile 257:
	(siehe Bild 4)		(siehe Bild 4)

	Mit der folgenden import Anweisung kann man übrigens die statischen Konstanten importieren, um nicht immer die Klasse davor schreiben zu müssen (d.h. man kann dann z.B. HORIZONTAL schreiben statt GridBagConstraints.HORIZONTAL):		Mit der folgenden import Anweisung kann man übrigens die statischen Konstanten importieren, um nicht immer die [[Klasse]] davor schreiben zu müssen (d.h. man kann dann z.B. HORIZONTAL schreiben statt GridBagConstraints.HORIZONTAL):
	<syntaxhighlight lang="java">		<syntaxhighlight lang="java">
	import static java.awt.GridBagConstraints.*;		import static java.awt.GridBagConstraints.*;
Zeile 262:		Zeile 263:

	===weightx, weighty===		===weightx, weighty===
	Damit die Komponenten nicht im Zentrum des Panels gebündelt bleiben, sondern sich über die zur Verfügung stehende Fläche verteilen können, müssen wir dem Layout sagen, wie der zusätzliche Platz verteilt werden soll. Das geschieht mit weightx zum Verteilen des horizontalen Raums und weighty zum Verteilen des vertikalen Raums. Der zusätzliche Raum wird auf jede Spalte / Zeile im Verhältnis zum Gewicht verteilt.		Damit die Komponenten nicht im Zentrum des Panels gebündelt bleiben, sondern sich über die zur Verfügung stehende Fläche verteilen können, müssen wir dem Layout sagen, wie der zusätzliche Platz verteilt werden soll. Das geschieht mit ''weightx'' zum Verteilen des horizontalen Raums und ''weighty'' zum Verteilen des vertikalen Raums. Der zusätzliche Raum wird auf jede Spalte / Zeile im Verhältnis zum Gewicht verteilt.

	Der Standardwert für beide Felder ist 0, was bedeutet, dass die Spalte / Zeile nie zusätzlichen Raum erhält.		Der Standardwert für beide Felder ist 0, was bedeutet, dass die Spalte / Zeile nie zusätzlichen Raum erhält.

	Es genügt, wenn wir das Gewicht für eine einzige Komponente einer Spalte / Zeile angeben. Der Layout-Manager setzt das Gewicht der Spalte / Zeile gleich dem maximalen Gewicht aller Komponenten in dieser Spalte / Zeile.		'''Es genügt, wenn wir das Gewicht für eine einzige Komponente einer Spalte / Zeile angeben.''' Der Layout-Manager setzt das Gewicht der Spalte / Zeile gleich dem maximalen Gewicht aller Komponenten in dieser Spalte / Zeile.

	Falls mehrzellige Komponenten benutzt werden, geht der extra Raum tendenziell in Richtung der Spalte ganz rechts und untere Zeile.		Falls mehrzellige Komponenten benutzt werden, geht der extra Raum tendenziell in Richtung der Spalte ganz rechts und untere Zeile.
Zeile 356:		Zeile 357:

	===ipadx, ipady===		===ipadx, ipady===
	Diese Felder geben die Innenpolsterung der Komponente an, das heißt den Raum, welcher der Komponente hinzugefügt wird, wodurch diese größer wird. Dabei wird die Breite der Komponente mit ipadx gepolstert und ihre Höhe mit ipady.		Diese Felder geben die '''Innenpolsterung der Komponente''' an, das heißt den Raum, welcher der Komponente hinzugefügt wird, wodurch diese größer wird. Dabei wird die Breite der Komponente mit ''ipadx'' gepolstert und ihre Höhe mit ''ipady'''''Fetter Text'''.

	Der Standardwert für beide Felder ist 0, was bedeutet, dass die Komponente keine Innenpolsterung hat.		Der Standardwert für beide Felder ist 0, was bedeutet, dass die Komponente keine Innenpolsterung hat.

L-ectron-X am 7. Juli 2018 um 15:22 Uhr

2018-07-07T15:22:43Z

← Nächstältere Version		Version vom 7. Juli 2018, 15:22 Uhr
Zeile 1:		Zeile 1:
	=Das GridBagLayout=		=Das GridBagLayout=
	Das GridBagLayout ist der mächtigste und für Einsteiger komplizierteste LayoutManager aus dem Java AWT Package. Er dient dem Layouten von Benutzeroberflächen von Java-Anwendungen in Form eines Rasters (Grid).~~<br>~~Mit diesem LayoutManager bleiben kaum Wünsche für die Anordnung von Komponenten in einer Benutzeroberfläche offen.		Das {{JAPI\|GridBagLayout}} ist der mächtigste und für Einsteiger komplizierteste [[LayoutManager]] aus dem Java AWT Package. Er dient dem Layouten von Benutzeroberflächen von Java-Anwendungen in Form eines Rasters (Grid).

			Mit diesem LayoutManager bleiben kaum Wünsche für die Anordnung von Komponenten in einer Benutzeroberfläche offen.

			Nach dem Durcharbeiten dieses Artikels sollten auch Einsteiger die Vorzüge und Stolperstellen dieses LayoutManagers verstehen.

	==Ein erstes einfaches Beispiel==		==Ein erstes einfaches Beispiel==
	Folgender Java-Code soll einen kurzen Einstieg zeigen. Im Wesentlichen sind es jeweils 5 Schritte, die beim Aufbau einer [[GUI]], oder eines Teils davon, für jede einzelne einzubauende Komponente durchlaufen werden müssen.		Folgender Java-Code soll einen kurzen Einstieg zeigen. '''Im Wesentlichen sind es jeweils 5 Schritte''', die beim Aufbau einer [[GUI]], oder eines Teils davon, für jede einzelne einzubauende Komponente durchlaufen werden müssen.

	<syntaxhighlight lang="java">		<syntaxhighlight lang="java">
	import java.awt.*;		import java.awt.*;
	~~import static java.awt.GridBagConstraints.*;~~
	import javax.swing.*;		import javax.swing.*;

Zeile 26:		Zeile 29:
	JButton eastButton = new JButton("Osten");		JButton eastButton = new JButton("Osten");

	//4. benötigte GridBagConstraints-Attribute ~~initialisieren/einstellen~~		//4. benötigte GridBagConstraints-Attribute konfigurieren
	gbc.gridx = 1; //Spalte 1 (Zählung beginnt bei 0)		gbc.gridx = 1; //Spalte 1 (Zählung beginnt bei 0)
	gbc.gridy = 0; //Zeile 0		gbc.gridy = 0; //Zeile 0

L-ectron-X: /* Ein erstes einfaches Beispiel */

2018-07-07T15:16:08Z

Ein erstes einfaches Beispiel

@@ Zeile 3: / Zeile 3: @@
 ==Ein erstes einfaches Beispiel==
-Folgender Javacode soll einen kurzen Einstieg zeigen und für weitere Abschnitte als Ausgangscode dienen
+Folgender Java-Code soll einen kurzen Einstieg zeigen. Im Wesentlichen sind es jeweils 5 Schritte, die beim Aufbau einer [[GUI]], oder eines Teils davon, für jede einzelne einzubauende Komponente durchlaufen werden müssen.
 <syntaxhighlight lang="java">
 import java.awt.*;
@@ Zeile 98: / Zeile 177: @@
 [[Bild:GridBagLayoutExample1.jpg]]
-Wie man sieht wird standardmäßig alles in der Mitte ausgerichtet.
+Wie man sieht, wird ohne weitere Einstellungen tätigen zu müssen, standardmäßig alles in der Mitte des Panels ausgerichtet.
 ==GridBagConstraints - Bedingungen für die Anordnung im Layout==

L-ectron-X am 2. April 2018 um 15:56 Uhr

2018-04-02T15:56:48Z

← Nächstältere Version		Version vom 2. April 2018, 15:56 Uhr
Zeile 299:		Zeile 299:
	--[[Benutzer:L-ectron-X\|L-ectron-X]] 11:43, 03. Jun 2010 (UTC)<br>		--[[Benutzer:L-ectron-X\|L-ectron-X]] 11:43, 03. Jun 2010 (UTC)<br>
	--[[Benutzer:AndreUhres\|AndreUhres]] 16:43, 06. Dec 2010 (UTC)		--[[Benutzer:AndreUhres\|AndreUhres]] 16:43, 06. Dec 2010 (UTC)
	~~[[Kategorie:Java]]~~
	[[Kategorie:LayoutManager]]		[[Kategorie:LayoutManager]]
	[[Kategorie:Java API]]		[[Kategorie:Java API]]
	[[Kategorie:Tutorials (Java)]]		[[Kategorie:Tutorials (Java)]]