- java.lang.Object
-
- javax.swing.GroupLayout.Group
-
- Direct Known Subclasses:
- GroupLayout.ParallelGroup, GroupLayout.SequentialGroup
- Enclosing class:
- GroupLayout
public abstract class GroupLayout.Group extends Object
Group
provides the basis for the two types of operations supported byGroupLayout
: laying out components one after another (SequentialGroup
) or aligned (ParallelGroup
).Group
and its subclasses have no public constructor; to create one use one ofcreateSequentialGroup
orcreateParallelGroup
. Additionally, taking aGroup
created from oneGroupLayout
and using it with another will produce undefined results.Various methods in
Group
and its subclasses allow you to explicitly specify the range. The arguments to these methods can take two forms, either a value greater than or equal to 0, or one ofDEFAULT_SIZE
orPREFERRED_SIZE
. A value greater than or equal to0
indicates a specific size.DEFAULT_SIZE
indicates the corresponding size from the component should be used. For example, ifDEFAULT_SIZE
is passed as the minimum size argument, the minimum size is obtained from invokinggetMinimumSize
on the component. Likewise,PREFERRED_SIZE
indicates the value fromgetPreferredSize
should be used. The following example addsmyComponent
togroup
with specific values for the range. That is, the minimum is explicitly specified as 100, preferred as 200, and maximum as 300.group.addComponent(myComponent, 100, 200, 300);
The following example addsmyComponent
togroup
using a combination of the forms. The minimum size is forced to be the same as the preferred size, the preferred size is determined by usingmyComponent.getPreferredSize
and the maximum is determined by invokinggetMaximumSize
on the component.group.addComponent(myComponent, GroupLayout.PREFERRED_SIZE, GroupLayout.PREFERRED_SIZE, GroupLayout.DEFAULT_SIZE);
Unless otherwise specified all the methods of
Group
and its subclasses that allow you to specify a range throw anIllegalArgumentException
if passed an invalid range. An invalid range is one in which any of the values are < 0 and not one ofPREFERRED_SIZE
orDEFAULT_SIZE
, or the following is not met (for specific values):min
<=pref
<=max
.Similarly any methods that take a
Component
throw aIllegalArgumentException
if passednull
and any methods that take aGroup
throw anNullPointerException
if passednull
.- Since:
- 1.6
- See Also:
GroupLayout.createSequentialGroup()
,GroupLayout.createParallelGroup()
-
-
Method Summary
Methods Modifier and Type Method and Description GroupLayout.Group
addComponent(Component component)
Adds aComponent
to thisGroup
.GroupLayout.Group
addComponent(Component component, int min, int pref, int max)
Adds aComponent
to thisGroup
with the specified size.GroupLayout.Group
addGap(int size)
Adds a rigid gap to thisGroup
.GroupLayout.Group
addGap(int min, int pref, int max)
Adds a gap to thisGroup
with the specified size.GroupLayout.Group
addGroup(GroupLayout.Group group)
Adds aGroup
to thisGroup
.
-
-
-
Method Detail
-
addGroup
public GroupLayout.Group addGroup(GroupLayout.Group group)
Adds aGroup
to thisGroup
.- Parameters:
group
- theGroup
to add- Returns:
- this
Group
-
addComponent
public GroupLayout.Group addComponent(Component component)
Adds aComponent
to thisGroup
.- Parameters:
component
- theComponent
to add- Returns:
- this
Group
-
addComponent
public GroupLayout.Group addComponent(Component component, int min, int pref, int max)
Adds aComponent
to thisGroup
with the specified size.- Parameters:
component
- theComponent
to addmin
- the minimum size or one ofDEFAULT_SIZE
orPREFERRED_SIZE
pref
- the preferred size or one ofDEFAULT_SIZE
orPREFERRED_SIZE
max
- the maximum size or one ofDEFAULT_SIZE
orPREFERRED_SIZE
- Returns:
- this
Group
-
addGap
public GroupLayout.Group addGap(int size)
Adds a rigid gap to thisGroup
.- Parameters:
size
- the size of the gap- Returns:
- this
Group
- Throws:
IllegalArgumentException
- ifsize
is less than0
-
addGap
public GroupLayout.Group addGap(int min, int pref, int max)
Adds a gap to thisGroup
with the specified size.- Parameters:
min
- the minimum size of the gappref
- the preferred size of the gapmax
- the maximum size of the gap- Returns:
- this
Group
- Throws:
IllegalArgumentException
- if any of the values are less than0
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
25/11/2024 13:28:38 Cette version de la page est en cache (à la date du 25/11/2024 13:28:38) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 11/06/2005, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/swing/GroupLayout.Group.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.