001// License: GPL. For details, see LICENSE file.
002package org.openstreetmap.josm.tools;
003
004import java.awt.Component;
005import java.awt.Dimension;
006import java.awt.GridBagConstraints;
007import java.awt.Insets;
008
009import javax.swing.Box;
010
011/**
012 * A wrapper for GridBagConstraints which has sane default static creators and
013 * member functions to chain calling.
014 *
015 * @author imi
016 */
017public final class GBC extends GridBagConstraints {
018
019    /**
020     * Use public static creator functions to create an GBC.
021     */
022    private GBC() {}
023
024    /**
025     * Create a standard constraint (which is not the last).
026     * @return A standard constraint with no filling.
027     */
028    public static GBC std() {
029        GBC c = new GBC();
030        c.anchor = WEST;
031        return c;
032    }
033
034    /**
035     * Create the constraint for the last elements on a line.
036     * @return A constraint which indicates the last item on a line.
037     */
038    public static GBC eol() {
039        GBC c = std();
040        c.gridwidth = REMAINDER;
041        return c;
042    }
043
044    /**
045     * Create the constraint for the last elements on a line and on a paragraph.
046     * This is merely a shortcut for eol().insets(0,0,0,10)
047     * @return A constraint which indicates the last item on a line.
048     */
049    public static GBC eop() {
050        return eol().insets(0, 0, 0, 10);
051    }
052
053    /**
054     * Try to fill both, horizontal and vertical
055     * @return This constraint for chaining.
056     */
057    public GBC fill() {
058        return fill(BOTH);
059    }
060
061    /**
062     * Set fill to the given value
063     * @param value The filling value, either NONE, HORIZONTAL, VERTICAL or BOTH
064     * @return This constraint for chaining.
065     */
066    public GBC fill(int value) {
067        fill = value;
068        if (value == HORIZONTAL || value == BOTH)
069            weightx = 1.0;
070        if (value == VERTICAL || value == BOTH)
071            weighty = 1.0;
072        return this;
073    }
074
075    /**
076     * Set the anchor of this GBC to a.
077     * @param a The new anchor, e.g. GBC.CENTER or GBC.EAST.
078     * @return This constraint for chaining.
079     */
080    public GBC anchor(int a) {
081        anchor = a;
082        return this;
083    }
084
085    /**
086     * Adds insets to this GBC.
087     * @param left      The left space of the insets
088     * @param top       The top space of the insets
089     * @param right     The right space of the insets
090     * @param bottom    The bottom space of the insets
091     * @return This constraint for chaining.
092     */
093    public GBC insets(int left, int top, int right, int bottom) {
094        insets = new Insets(top, left, bottom, right);
095        return this;
096    }
097
098    /**
099     * Specifies how to distribute extra horizontal space.
100     * @param weightx   Weight in horizontal direction
101     * @param weighty   Weight in vertical direction
102     * @return This constraint for chaining.
103     */
104    public GBC weight(double weightx, double weighty) {
105        this.weightx = weightx;
106        this.weighty = weighty;
107        return this;
108    }
109
110    /**
111     * This is a helper to easily create a glue with a minimum default value.
112     * @param x If higher than 0, this will be a horizontal glue with x as minimum
113     *      horizontal strut.
114     * @param y If higher than 0, this will be a vertical glue with y as minimum
115     *      vertical strut.
116     * @return the glue component
117     */
118    public static Component glue(int x, int y) {
119        short maxx = x > 0 ? Short.MAX_VALUE : 0;
120        short maxy = y > 0 ? Short.MAX_VALUE : 0;
121        return new Box.Filler(new Dimension(x, y), new Dimension(x, y), new Dimension(maxx, maxy));
122    }
123
124    /**
125     * Sets the constraint's {@code gridx}, {@code gridy}.
126     * @return This constraint for chaining.
127     * @see #gridx
128     * @see #gridy
129     */
130    public GBC grid(int gridx, int gridy) {
131        this.gridx = gridx;
132        this.gridy = gridy;
133        return this;
134    }
135
136    /**
137     * Sets the constraint's {@code gridwidth}, {@code gridheight}.
138     * @return This constraint for chaining.
139     * @see #gridwidth
140     * @see #gridheight
141     */
142    public GBC span(int gridwidth, int gridheight) {
143        this.gridwidth = gridwidth;
144        this.gridheight = gridheight;
145        return this;
146    }
147
148    /**
149     * Sets the constraint's {@code gridwidth}.
150     * @return This constraint for chaining.
151     * @see #gridwidth
152     */
153    public GBC span(int gridwidth) {
154        this.gridwidth = gridwidth;
155        return this;
156    }
157
158    /**
159     * Create a standard constraint with the {@code gridx}, {@code gridy} set.
160     *
161     * Is equivalent to {@code std().grid(gridx, gridy)}
162     * @return A standard constraint.
163     * @see #std()
164     * @see #grid(int, int)
165     * @see #gridx
166     * @see #gridy
167     */
168    public static GBC std(int gridx, int gridy) {
169        return std().grid(gridx, gridy);
170    }
171
172}