Table panes are used to arrange components in a variable 2-dimensional grid, much like
an HTML table. Table panes have a "columns" collection that defines the column
structure of the table and a "rows" collection that defines both the row structure of
the table and the contents of each row.
Note that a special syntax can be used to specify the width of a TablePane.Column or the height of a TablePane.Row:
"-1" - default size, the column will be as wide as the widest component in that column,
or a row would be as tall as the tallest component in that row.
"a number > -1" - absolute size,
that number will be the width in pixels for a column, or the height in pixels for a row.
"n*" - relative size,
calculate the remaining space available in the column or in the row
(using all relative columns/row cells),
then add up the total of the relative values, divide the space by that number and reallocate
the space for each column or row by multiplying the final value by each relative number.
For example if the total space is 300 pixels and the column widths are "1*", "2*" and "3*":
total relative value = 1 + 2 + 3 = 6
base value = 300 / 6 = 50
column widths = 1 * 50 = 50, 2 * 50 = 100, 3 * 50 = 150 (total 50 + 100 + 150 = 300)
Table panes support a number of styles that allow a caller to customize the arrangement
of child components:
"padding" - the amount of space the table pane reserves around the perimeter of the
container.
"horizontalSpacing" - the amount of space the table pane inserts between columns.
"verticalSpacing" - the amount of space the table pane inserts between rows.
"showHorizontalGridLines" - whether horizontal grid lines will be painted in the
space between rows. Note that this will be ignored if "verticalSpacing" is zero, as
there would be no space in which to paint the grid lines.
"showVerticalGridLines" - whether vertical grid lines will be painted in the space
between columns. Note that this will be ignored if "horizontalSpacing" is zero, as
there would be no space in which to paint the grid lines.
"horizontalGridColor" - the color of the horizontal grid lines.
"verticalGridColor" - the color of the vertical grid lines.
"highlightBackgroundColor" - the background color of rows and columns whose
"highlighted" flag is set to true.
Below is a sample application that demonstrates a basic table pane structure and
responds to mouse clicks with information about where the user clicked:
The BXML source for the application is shown below:
]]>
The Java source is as follows. Most of the code is simply event handling logic that
responds to mouse clicks:
namespace, URL location, Resources resources) {
tablePane = (TablePane)namespace.get("tablePane");
tablePane.getComponentMouseButtonListeners().add(new ComponentMouseButtonListener.Adapter() {
@Override
public boolean mouseClick(Component component, Mouse.Button button, int x, int y, int count) {
int rowIndex = tablePane.getRowAt(y);
int columnIndex = tablePane.getColumnAt(x);
if (rowIndex >= 0
&& columnIndex >= 0) {
TablePane.Row row = tablePane.getRows().get(rowIndex);
TablePane.Column column = tablePane.getColumns().get(columnIndex);
int rowHeight = row.getHeight();
int columnWidth = column.getWidth();
String message = "Registered Click At " + rowIndex + "," + columnIndex;
Label heightLabel = new Label(String.format("The row's height is %d (%s)",
rowHeight,
rowHeight == -1 ? "default" : (row.isRelative() ? "relative" : "absolute")));
Label widthLabel = new Label(String.format("The column's width is %d (%s)",
columnWidth,
columnWidth == -1 ? "default" : (column.isRelative() ? "relative" : "absolute")));
BoxPane body = new BoxPane(Orientation.VERTICAL);
body.add(heightLabel);
body.add(widthLabel);
Prompt.prompt(MessageType.INFO, message, body, SimpleTablePanes.this);
}
return false;
}
});
}
}
]]>
The following is a more involved application that allows the user to interact with the
table pane and get a feel for how the different settings affect layout. The
application manages the table pane's styles via the controls on the left and responds
to right-clicks over the table pane itself. The user can also drag the splitter to see
the effect it has on the relative columns in the grid pane.