equal
deleted
inserted
replaced
428 * Sets whether the component's visibility is considered for |
428 * Sets whether the component's visibility is considered for |
429 * sizing and positioning. A value of {@code Boolean.TRUE} |
429 * sizing and positioning. A value of {@code Boolean.TRUE} |
430 * indicates that if {@code component} is not visible it should |
430 * indicates that if {@code component} is not visible it should |
431 * not be treated as part of the layout. A value of {@code false} |
431 * not be treated as part of the layout. A value of {@code false} |
432 * indicates that {@code component} is positioned and sized |
432 * indicates that {@code component} is positioned and sized |
433 * regardless of it's visibility. A value of {@code null} |
433 * regardless of its visibility. A value of {@code null} |
434 * indicates the value specified by the single argument method {@code |
434 * indicates the value specified by the single argument method {@code |
435 * setHonorsVisibility} should be used. |
435 * setHonorsVisibility} should be used. |
436 * <p> |
436 * <p> |
437 * If {@code component} is not a child of the {@code Container} this |
437 * If {@code component} is not a child of the {@code Container} this |
438 * {@code GroupLayout} is managing, it will be added to the |
438 * {@code GroupLayout} is managing, it will be added to the |
665 } |
665 } |
666 return new ParallelGroup(alignment, resizable); |
666 return new ParallelGroup(alignment, resizable); |
667 } |
667 } |
668 |
668 |
669 /** |
669 /** |
670 * Creates and returns a {@code ParallelGroup} that aligns it's |
670 * Creates and returns a {@code ParallelGroup} that aligns its |
671 * elements along the baseline. |
671 * elements along the baseline. |
672 * |
672 * |
673 * @param resizable whether the group is resizable |
673 * @param resizable whether the group is resizable |
674 * @param anchorBaselineToTop whether the baseline is anchored to |
674 * @param anchorBaselineToTop whether the baseline is anchored to |
675 * the top or bottom of the group |
675 * the top or bottom of the group |
2371 } |
2371 } |
2372 } |
2372 } |
2373 |
2373 |
2374 |
2374 |
2375 /** |
2375 /** |
2376 * A {@code Group} that aligns and sizes it's children. |
2376 * A {@code Group} that aligns and sizes its children. |
2377 * {@code ParallelGroup} aligns it's children in |
2377 * {@code ParallelGroup} aligns its children in |
2378 * four possible ways: along the baseline, centered, anchored to the |
2378 * four possible ways: along the baseline, centered, anchored to the |
2379 * leading edge, or anchored to the trailing edge. |
2379 * leading edge, or anchored to the trailing edge. |
2380 * <h3>Baseline</h3> |
2380 * <h3>Baseline</h3> |
2381 * A {@code ParallelGroup} that aligns it's children along the |
2381 * A {@code ParallelGroup} that aligns its children along the |
2382 * baseline must first decide where the baseline is |
2382 * baseline must first decide where the baseline is |
2383 * anchored. The baseline can either be anchored to the top, or |
2383 * anchored. The baseline can either be anchored to the top, or |
2384 * anchored to the bottom of the group. That is, the distance between the |
2384 * anchored to the bottom of the group. That is, the distance between the |
2385 * baseline and the beginning of the group can be a constant |
2385 * baseline and the beginning of the group can be a constant |
2386 * distance, or the distance between the end of the group and the |
2386 * distance, or the distance between the end of the group and the |
2413 * {@code maxAscent} is the maximum ascent (baseline) of all elements that |
2413 * {@code maxAscent} is the maximum ascent (baseline) of all elements that |
2414 * have a baseline and are aligned along the baseline. |
2414 * have a baseline and are aligned along the baseline. |
2415 * {@code maxDescent} is the maximum descent (preferred height - baseline) |
2415 * {@code maxDescent} is the maximum descent (preferred height - baseline) |
2416 * of all elements that have a baseline and are aligned along the baseline. |
2416 * of all elements that have a baseline and are aligned along the baseline. |
2417 * <p> |
2417 * <p> |
2418 * A {@code ParallelGroup} that aligns it's elements along the baseline |
2418 * A {@code ParallelGroup} that aligns its elements along the baseline |
2419 * is only useful along the vertical axis. If you create a |
2419 * is only useful along the vertical axis. If you create a |
2420 * baseline group and use it along the horizontal axis an |
2420 * baseline group and use it along the horizontal axis an |
2421 * {@code IllegalStateException} is thrown when you ask |
2421 * {@code IllegalStateException} is thrown when you ask |
2422 * {@code GroupLayout} for the minimum, preferred or maximum size or |
2422 * {@code GroupLayout} for the minimum, preferred or maximum size or |
2423 * attempt to layout the components. |
2423 * attempt to layout the components. |