/**
* Copyright (C) 2018 Adrien Hopkins
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see gridx=0
. The leading edge of a component's display area is its left edge for a horizontal,
* left-to-right container and its right edge for a horizontal, right-to-left container. The value
* RELATIVE
specifies that the component be placed immediately following the component that was added
* to the container just before this component was added.
*
* The default value is RELATIVE
. gridx
should be a non-negative value.
*
* @serial
* @see #clone()
* @see java.awt.GridBagConstraints#gridy
* @see java.awt.ComponentOrientation
*/
private final int gridx;
/**
* Specifies the cell at the top of the component's display area, where the topmost cell has gridy=0
.
* The value RELATIVE
specifies that the component be placed just below the component that was added to
* the container just before this component was added.
*
* The default value is RELATIVE
. gridy
should be a non-negative value.
*
* @serial
* @see #clone()
* @see java.awt.GridBagConstraints#gridx
*/
private final int gridy;
/**
* Specifies the number of cells in a row for the component's display area.
*
* Use REMAINDER
to specify that the component's display area will be from gridx
to the
* last cell in the row. Use RELATIVE
to specify that the component's display area will be from
* gridx
to the next to the last one in its row.
*
* gridwidth
should be non-negative and the default value is 1.
*
* @serial
* @see #clone()
* @see java.awt.GridBagConstraints#gridheight
*/
private final int gridwidth;
/**
* Specifies the number of cells in a column for the component's display area.
*
* Use REMAINDER
to specify that the component's display area will be from gridy
to the
* last cell in the column. Use RELATIVE
to specify that the component's display area will be from
* gridy
to the next to the last one in its column.
*
* gridheight
should be a non-negative value and the default value is 1.
*
* @serial
* @see #clone()
* @see java.awt.GridBagConstraints#gridwidth
*/
private final int gridheight;
/**
* Specifies how to distribute extra horizontal space.
*
* The grid bag layout manager calculates the weight of a column to be the maximum weightx
of all the
* components in a column. If the resulting layout is smaller horizontally than the area it needs to fill, the extra
* space is distributed to each column in proportion to its weight. A column that has a weight of zero receives no
* extra space.
*
* If all the weights are zero, all the extra space appears between the grids of the cell and the left and right * edges. *
* The default value of this field is 0
. weightx
should be a non-negative value.
*
* @serial
* @see #clone()
* @see java.awt.GridBagConstraints#weighty
*/
private double weightx;
/**
* Specifies how to distribute extra vertical space.
*
* The grid bag layout manager calculates the weight of a row to be the maximum weighty
of all the
* components in a row. If the resulting layout is smaller vertically than the area it needs to fill, the extra
* space is distributed to each row in proportion to its weight. A row that has a weight of zero receives no extra
* space.
*
* If all the weights are zero, all the extra space appears between the grids of the cell and the top and bottom * edges. *
* The default value of this field is 0
. weighty
should be a non-negative value.
*
* @serial
* @see #clone()
* @see java.awt.GridBagConstraints#weightx
*/
private double weighty;
/**
* This field is used when the component is smaller than its display area. It determines where, within the display
* area, to place the component.
*
* There are three kinds of possible values: orientation relative, baseline relative and absolute. Orientation
* relative values are interpreted relative to the container's component orientation property, baseline relative
* values are interpreted relative to the baseline and absolute values are not. The absolute values are:
* CENTER
, NORTH
, NORTHEAST
, EAST
, SOUTHEAST
,
* SOUTH
, SOUTHWEST
, WEST
, and NORTHWEST
. The orientation
* relative values are: PAGE_START
, PAGE_END
, LINE_START
,
* LINE_END
, FIRST_LINE_START
, FIRST_LINE_END
, LAST_LINE_START
* and LAST_LINE_END
. The baseline relative values are: BASELINE
,
* BASELINE_LEADING
, BASELINE_TRAILING
, ABOVE_BASELINE
,
* ABOVE_BASELINE_LEADING
, ABOVE_BASELINE_TRAILING
, BELOW_BASELINE
,
* BELOW_BASELINE_LEADING
, and BELOW_BASELINE_TRAILING
. The default value is
* CENTER
.
*
* @serial
* @see #clone()
* @see java.awt.ComponentOrientation
*/
private int anchor;
/**
* This field is used when the component's display area is larger than the component's requested size. It determines
* whether to resize the component, and if so, how.
*
* The following values are valid for fill
:
*
*
NONE
: Do not resize the component.
* HORIZONTAL
: Make the component wide enough to fill its display area horizontally, but do not
* change its height.
* VERTICAL
: Make the component tall enough to fill its display area vertically, but do not change
* its width.
* BOTH
: Make the component fill its display area entirely.
*
* The default value is NONE
.
*
* @serial
* @see #clone()
*/
private int fill;
/**
* This field specifies the external padding of the component, the minimum amount of space between the component and
* the edges of its display area.
*
* The default value is new Insets(0, 0, 0, 0)
.
*
* @serial
* @see #clone()
*/
private Insets insets;
/**
* This field specifies the internal padding of the component, how much space to add to the minimum width of the
* component. The width of the component is at least its minimum width plus ipadx
pixels.
*
* The default value is 0
.
*
* @serial
* @see #clone()
* @see java.awt.GridBagConstraints#ipady
*/
private int ipadx;
/**
* This field specifies the internal padding, that is, how much space to add to the minimum height of the component.
* The height of the component is at least its minimum height plus ipady
pixels.
*
* The default value is 0. * * @serial * @see #clone() * @see java.awt.GridBagConstraints#ipadx */ private int ipady; /** * @param gridx * x position * @param gridy * y position * @since 2018-11-30 */ public GridBagBuilder(final int gridx, final int gridy) { this(gridx, gridy, 1, 1); } /** * @param gridx * x position * @param gridy * y position * @param gridwidth * number of cells occupied horizontally * @param gridheight * number of cells occupied vertically * @since 2018-11-30 */ public GridBagBuilder(final int gridx, final int gridy, final int gridwidth, final int gridheight) { this(gridx, gridy, gridwidth, gridheight, 0.0, 0.0, GridBagConstraints.CENTER, GridBagConstraints.NONE, new Insets(0, 0, 0, 0), 0, 0); } /** * @param gridx * x position * @param gridy * y position * @param gridwidth * number of cells occupied horizontally * @param gridheight * number of cells occupied vertically * @param weightx * @param weighty * @param anchor * @param fill * @param insets * @param ipadx * @param ipady * @since 2018-11-30 */ private GridBagBuilder(final int gridx, final int gridy, final int gridwidth, final int gridheight, final double weightx, final double weighty, final int anchor, final int fill, final Insets insets, final int ipadx, final int ipady) { super(); this.gridx = gridx; this.gridy = gridy; this.gridwidth = gridwidth; this.gridheight = gridheight; this.weightx = weightx; this.weighty = weighty; this.anchor = anchor; this.fill = fill; this.insets = (Insets) insets.clone(); this.ipadx = ipadx; this.ipady = ipady; } /** * @return {@code GridBagConstraints} created by this builder * @since 2018-11-30 */ public GridBagConstraints build() { return new GridBagConstraints(this.gridx, this.gridy, this.gridwidth, this.gridheight, this.weightx, this.weighty, this.anchor, this.fill, this.insets, this.ipadx, this.ipady); } /** * @return anchor * @since 2018-11-30 */ public int getAnchor() { return this.anchor; } /** * @return fill * @since 2018-11-30 */ public int getFill() { return this.fill; } /** * @return gridheight * @since 2018-11-30 */ public int getGridheight() { return this.gridheight; } /** * @return gridwidth * @since 2018-11-30 */ public int getGridwidth() { return this.gridwidth; } /** * @return gridx * @since 2018-11-30 */ public int getGridx() { return this.gridx; } /** * @return gridy * @since 2018-11-30 */ public int getGridy() { return this.gridy; } /** * @return insets * @since 2018-11-30 */ public Insets getInsets() { return this.insets; } /** * @return ipadx * @since 2018-11-30 */ public int getIpadx() { return this.ipadx; } /** * @return ipady * @since 2018-11-30 */ public int getIpady() { return this.ipady; } /** * @return weightx * @since 2018-11-30 */ public double getWeightx() { return this.weightx; } /** * @return weighty * @since 2018-11-30 */ public double getWeighty() { return this.weighty; } /** * @param anchor * anchor to set * @since 2018-11-30 */ public GridBagBuilder setAnchor(final int anchor) { this.anchor = anchor; return this; } /** * @param fill * fill to set * @since 2018-11-30 */ public GridBagBuilder setFill(final int fill) { this.fill = fill; return this; } /** * @param insets * insets to set * @since 2018-11-30 */ public GridBagBuilder setInsets(final Insets insets) { this.insets = insets; return this; } /** * @param ipadx * ipadx to set * @since 2018-11-30 */ public GridBagBuilder setIpadx(final int ipadx) { this.ipadx = ipadx; return this; } /** * @param ipady * ipady to set * @since 2018-11-30 */ public GridBagBuilder setIpady(final int ipady) { this.ipady = ipady; return this; } /** * @param weightx * weightx to set * @since 2018-11-30 */ public GridBagBuilder setWeightx(final double weightx) { this.weightx = weightx; return this; } /** * @param weighty * weighty to set * @since 2018-11-30 */ public GridBagBuilder setWeighty(final double weighty) { this.weighty = weighty; return this; } }