< prev index next >

modules/javafx.graphics/src/main/java/javafx/scene/layout/TilePane.java

Print this page




 126  * </table>
 127  * <br>
 128  * <table border="1">
 129  * <caption>Vertical</caption>
 130  * <tr><td></td><th scope="col">width</th><th scope="col">height</th></tr>
 131  * <tr><th scope="row">minimum</th>
 132  * <td>left/right insets plus width required to display all tiles when wrapped at a specified height with an hgap between each column.</td>
 133  * <td>top/bottom insets plus the tile height.</td></tr>
 134  * <tr><th scope="row">preferred</th>
 135  * <td>left/right insets plus width required to display all tiles when wrapped at the specified height with an hgap between each column.</td>
 136  * <td>top/bottom insets plus prefRows multiplied by the tile height.</td></tr>
 137  * <tr><th scope="row">maximum</th>
 138  * <td>Double.MAX_VALUE</td><td>Double.MAX_VALUE</td></tr>
 139  * </table>
 140  * <p>
 141  * A tilepane's unbounded maximum width and height are an indication to the parent that
 142  * it may be resized beyond its preferred size to fill whatever space is assigned to it.
 143  * <p>
 144  * TilePane provides properties for setting the size range directly.  These
 145  * properties default to the sentinel value Region.USE_COMPUTED_SIZE, however the
 146  * application may set them to other values as needed, e.g. {@code tilepane.setMaxWidth(500)}.



 147  * Applications may restore the computed values by setting these properties back
 148  * to Region.USE_COMPUTED_SIZE.
 149  * <p>
 150  * TilePane does not clip its content by default, so it is possible that childrens'
 151  * bounds may extend outside the tiles (and possibly the tilepane bounds) if a
 152  * child's pref size prevents it from being fit within its tile. Also, if the tilepane
 153  * is resized smaller than its preferred size, it may not be able to fit all the
 154  * tiles within its bounds and the content will extend outside.
 155  *
 156  * <h3>Optional Layout Constraints</h3>
 157  *
 158  * <p>
 159  * An application may set constraints on individual children to customize TilePane's layout.
 160  * For each constraint, TilePane provides a static method for setting it on the child.
 161  * </p>
 162  *
 163  * <table border="1">
 164  * <caption>TilePane Constraint Table</caption>
 165  * <tr><th scope="col">Constraint</th><th scope="col">Type</th><th scope="col">Description</th></tr>
 166  * <tr><th scope="row">alignment</th><td>javafx.geometry.Pos</td><td>The alignment of the child within its tile.</td></tr>
 167  * <tr><th scope="row">margin</th><td>javafx.geometry.Insets</td><td>Margin space around the outside of the child.</td></tr>
 168  * </table>
 169  * <p>
 170  * Example:




 126  * </table>
 127  * <br>
 128  * <table border="1">
 129  * <caption>Vertical</caption>
 130  * <tr><td></td><th scope="col">width</th><th scope="col">height</th></tr>
 131  * <tr><th scope="row">minimum</th>
 132  * <td>left/right insets plus width required to display all tiles when wrapped at a specified height with an hgap between each column.</td>
 133  * <td>top/bottom insets plus the tile height.</td></tr>
 134  * <tr><th scope="row">preferred</th>
 135  * <td>left/right insets plus width required to display all tiles when wrapped at the specified height with an hgap between each column.</td>
 136  * <td>top/bottom insets plus prefRows multiplied by the tile height.</td></tr>
 137  * <tr><th scope="row">maximum</th>
 138  * <td>Double.MAX_VALUE</td><td>Double.MAX_VALUE</td></tr>
 139  * </table>
 140  * <p>
 141  * A tilepane's unbounded maximum width and height are an indication to the parent that
 142  * it may be resized beyond its preferred size to fill whatever space is assigned to it.
 143  * <p>
 144  * TilePane provides properties for setting the size range directly.  These
 145  * properties default to the sentinel value Region.USE_COMPUTED_SIZE, however the
 146  * application may set them to other values as needed:
 147  * <pre><code>
 148  *     <b>tilePane.setMaxWidth(500);</b>
 149  * </code></pre>
 150  * Applications may restore the computed values by setting these properties back
 151  * to Region.USE_COMPUTED_SIZE.
 152  * <p>
 153  * TilePane does not clip its content by default, so it is possible that children's'
 154  * bounds may extend outside the tiles (and possibly the tilepane bounds) if a
 155  * child's pref size prevents it from being fit within its tile. Also, if the tilepane
 156  * is resized smaller than its preferred size, it may not be able to fit all the
 157  * tiles within its bounds and the content will extend outside.
 158  *
 159  * <h3>Optional Layout Constraints</h3>
 160  *
 161  * <p>
 162  * An application may set constraints on individual children to customize TilePane's layout.
 163  * For each constraint, TilePane provides a static method for setting it on the child.
 164  * </p>
 165  *
 166  * <table border="1">
 167  * <caption>TilePane Constraint Table</caption>
 168  * <tr><th scope="col">Constraint</th><th scope="col">Type</th><th scope="col">Description</th></tr>
 169  * <tr><th scope="row">alignment</th><td>javafx.geometry.Pos</td><td>The alignment of the child within its tile.</td></tr>
 170  * <tr><th scope="row">margin</th><td>javafx.geometry.Insets</td><td>Margin space around the outside of the child.</td></tr>
 171  * </table>
 172  * <p>
 173  * Example:


< prev index next >