com.sun.javafx.scene.control.skin.NestedTableColumnHeader Maven / Gradle / Ivy
/*
* Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code 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 General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package com.sun.javafx.scene.control.skin;
import com.sun.javafx.PlatformUtil;
import javafx.collections.WeakListChangeListener;
import java.util.ArrayList;
import java.util.List;
import javafx.collections.FXCollections;
import javafx.collections.ListChangeListener;
import javafx.collections.ObservableList;
import javafx.event.EventHandler;
import javafx.geometry.NodeOrientation;
import javafx.scene.Cursor;
import javafx.scene.Node;
import javafx.scene.control.TableColumnBase;
import javafx.scene.control.TableView;
import javafx.scene.input.MouseEvent;
import javafx.scene.paint.Color;
import javafx.scene.shape.Rectangle;
/**
* This class is used to construct the header of a TableView. We take the approach
* that every TableView header is nested - even if it isn't. This allows for us
* to use the same code for building a single row of TableColumns as we would
* with a heavily nested sequences of TableColumns. Because of this, the
* TableHeaderRow class consists of just one instance of a NestedTableColumnHeader.
*
*/
public class NestedTableColumnHeader extends TableColumnHeader {
/***************************************************************************
* *
* Constructor *
* *
**************************************************************************/
public NestedTableColumnHeader(final TableViewSkinBase skin, final TableColumnBase tc) {
super(skin, tc);
getStyleClass().setAll("nested-column-header");
setFocusTraversable(false);
// init UI
label = new TableColumnHeader(skin, getTableColumn());
label.setTableHeaderRow(getTableHeaderRow());
label.setParentHeader(getParentHeader());
label.setNestedColumnHeader(this);
if (getTableColumn() != null) {
changeListenerHandler.registerChangeListener(getTableColumn().textProperty(), "TABLE_COLUMN_TEXT");
}
changeListenerHandler.registerChangeListener(skin.columnResizePolicyProperty(), "TABLE_VIEW_COLUMN_RESIZE_POLICY");
}
/***************************************************************************
* *
* Listeners *
* *
**************************************************************************/
@Override protected void handlePropertyChanged(String p) {
super.handlePropertyChanged(p);
if ("TABLE_VIEW_COLUMN_RESIZE_POLICY".equals(p)) {
updateContent();
} else if ("TABLE_COLUMN_TEXT".equals(p)) {
label.setVisible(getTableColumn().getText() != null && ! getTableColumn().getText().isEmpty());
}
}
private final ListChangeListener columnsListener = new ListChangeListener() {
@Override public void onChanged(Change c) {
setHeadersNeedUpdate();
}
};
private final WeakListChangeListener weakColumnsListener =
new WeakListChangeListener(columnsListener);
private static final int DRAG_RECT_WIDTH = 4;
@Override public void setTableHeaderRow(TableHeaderRow header) {
super.setTableHeaderRow(header);
label.setTableHeaderRow(header);
// tell all children columns what TableHeader they belong to
for (TableColumnHeader c : getColumnHeaders()) {
c.setTableHeaderRow(header);
}
}
@Override public void setParentHeader(NestedTableColumnHeader parentHeader) {
super.setParentHeader(parentHeader);
label.setParentHeader(parentHeader);
}
/**
* Represents the actual columns directly contained in this nested column.
* It does NOT include ANY of the children of these columns, if any exist.
*/
private ObservableList columns;
ObservableList getColumns() { return columns; }
void setColumns(ObservableList newColumns) {
if (this.columns != null) {
this.columns.removeListener(weakColumnsListener);
}
this.columns = newColumns;
if (this.columns != null) {
this.columns.addListener(weakColumnsListener);
}
}
void updateTableColumnHeaders() {
// watching for changes to the view columns in either table or tableColumn.
if (getTableColumn() == null && getTableViewSkin() != null) {
setColumns(getTableViewSkin().getColumns());
} else if (getTableColumn() != null) {
setColumns(getTableColumn().getColumns());
}
// update the column headers...
// iterate through all current headers, telling them to clean up
for (int i = 0; i < getColumnHeaders().size(); i++) {
TableColumnHeader header = getColumnHeaders().get(i);
header.dispose();
}
// then iterate through all columns, unless we've got no child columns
// any longer, in which case we should switch to a TableColumnHeader
// instead
if (getColumns().isEmpty()) {
// switch out to be a TableColumn instead, if we have a parent header
NestedTableColumnHeader parentHeader = getParentHeader();
if (parentHeader != null) {
List parentColumnHeaders = parentHeader.getColumnHeaders();
int index = parentColumnHeaders.indexOf(this);
if (index >= 0 && index < parentColumnHeaders.size()) {
parentColumnHeaders.set(index, createColumnHeader(getTableColumn()));
}
} else {
// otherwise just remove all the columns
getColumnHeaders().clear();
}
} else {
List newHeaders = new ArrayList();
for (int i = 0; i < getColumns().size(); i++) {
TableColumnBase column = getColumns().get(i);
if (column == null) continue;
newHeaders.add(createColumnHeader(column));
}
getColumnHeaders().setAll(newHeaders);
}
// update the content
updateContent();
}
@Override void dispose() {
super.dispose();
if (label != null) {
label.dispose();
}
if (getColumns() != null) {
getColumns().removeListener(weakColumnsListener);
}
for (int i = 0; i < getColumnHeaders().size(); i++) {
TableColumnHeader header = getColumnHeaders().get(i);
header.dispose();
}
for (int i = 0; i < dragRects.size(); i++) {
Rectangle rect = dragRects.get(i);
rect.visibleProperty().unbind();
}
dragRects.clear();
getChildren().clear();
changeListenerHandler.dispose();
}
private TableColumnHeader label;
private ObservableList columnHeaders;
public ObservableList getColumnHeaders() {
if (columnHeaders == null) columnHeaders = FXCollections.observableArrayList();
return columnHeaders;
}
private void updateContent() {
// create a temporary list so we only do addAll into the main content
// observableArrayList once.
final List content = new ArrayList();
// the label is the region that sits above the children columns
content.add(label);
// all children columns
content.addAll(getColumnHeaders());
// Small transparent overlays that sit at the start and end of each
// column to intercept user drag gestures to enable column resizing.
if (isColumnResizingEnabled()) {
rebuildDragRects();
content.addAll(dragRects);
}
getChildren().setAll(content);
}
private static final String TABLE_COLUMN_KEY = "TableColumn";
private static final String TABLE_COLUMN_HEADER_KEY = "TableColumnHeader";
private static final EventHandler rectMousePressed = new EventHandler() {
@Override public void handle(MouseEvent me) {
Rectangle rect = (Rectangle) me.getSource();
TableColumnBase column = (TableColumnBase) rect.getProperties().get(TABLE_COLUMN_KEY);
NestedTableColumnHeader header = (NestedTableColumnHeader) rect.getProperties().get(TABLE_COLUMN_HEADER_KEY);
if (! header.isColumnResizingEnabled()) return;
if (me.getClickCount() == 2 && me.isPrimaryButtonDown()) {
// the user wants to resize the column such that its
// width is equal to the widest element in the column
header.getTableViewSkin().resizeColumnToFitContent(column, -1);
} else {
// rather than refer to the rect variable, we just grab
// it from the source to prevent a small memory leak.
Rectangle innerRect = (Rectangle) me.getSource();
double startX = header.getTableHeaderRow().sceneToLocal(innerRect.localToScene(innerRect.getBoundsInLocal())).getMinX() + 2;
header.dragAnchorX = me.getSceneX();
header.columnResizingStarted(startX);
}
me.consume();
}
};
private static final EventHandler rectMouseDragged = new EventHandler() {
@Override public void handle(MouseEvent me) {
Rectangle rect = (Rectangle) me.getSource();
TableColumnBase column = (TableColumnBase) rect.getProperties().get(TABLE_COLUMN_KEY);
NestedTableColumnHeader header = (NestedTableColumnHeader) rect.getProperties().get(TABLE_COLUMN_HEADER_KEY);
if (! header.isColumnResizingEnabled()) return;
header.columnResizing(column, me);
me.consume();
}
};
private static final EventHandler rectMouseReleased = new EventHandler() {
@Override public void handle(MouseEvent me) {
Rectangle rect = (Rectangle) me.getSource();
TableColumnBase column = (TableColumnBase) rect.getProperties().get(TABLE_COLUMN_KEY);
NestedTableColumnHeader header = (NestedTableColumnHeader) rect.getProperties().get(TABLE_COLUMN_HEADER_KEY);
if (! header.isColumnResizingEnabled()) return;
header.columnResizingComplete(column, me);
me.consume();
}
};
private static final EventHandler rectCursorChangeListener = new EventHandler() {
@Override public void handle(MouseEvent me) {
Rectangle rect = (Rectangle) me.getSource();
TableColumnBase column = (TableColumnBase) rect.getProperties().get(TABLE_COLUMN_KEY);
NestedTableColumnHeader header = (NestedTableColumnHeader) rect.getProperties().get(TABLE_COLUMN_HEADER_KEY);
rect.setCursor(header.isColumnResizingEnabled() && rect.isHover() &&
column.isResizable() ? Cursor.H_RESIZE : Cursor.DEFAULT);
}
};
private void rebuildDragRects() {
if (! isColumnResizingEnabled()) return;
getChildren().removeAll(dragRects);
for (int i = 0, max = dragRects.size(); i < max; i++) {
Rectangle rect = dragRects.get(i);
rect.visibleProperty().unbind();
}
dragRects.clear();
if (getColumns() == null) {
return;
}
boolean isConstrainedResize = TableView.CONSTRAINED_RESIZE_POLICY.equals(
getTableViewSkin().columnResizePolicyProperty());
for (int col = 0; col < getColumns().size(); col++) {
if (isConstrainedResize && col == getColumns().size() - 1) {
break;
}
final TableColumnBase c = getColumns().get(col);
final Rectangle rect = new Rectangle();
rect.getProperties().put(TABLE_COLUMN_KEY, c);
rect.getProperties().put(TABLE_COLUMN_HEADER_KEY, this);
rect.setWidth(DRAG_RECT_WIDTH);
rect.setHeight(getHeight() - label.getHeight());
rect.setFill(Color.TRANSPARENT);
rect.visibleProperty().bind(c.visibleProperty());
rect.setSmooth(false);
rect.setOnMousePressed(rectMousePressed);
rect.setOnMouseDragged(rectMouseDragged);
rect.setOnMouseReleased(rectMouseReleased);
rect.setOnMouseEntered(rectCursorChangeListener);
rect.setOnMouseExited(rectCursorChangeListener);
dragRects.add(rect);
}
}
/* *******************/
/* COLUMN RESIZING */
/* *******************/
private double lastX = 0.0F;
private double dragAnchorX = 0.0;
// drag rectangle overlays
private List dragRects = new ArrayList();
private boolean isColumnResizingEnabled() {
// this used to check if ! PlatformUtil.isEmbedded(), but has been changed
// to always return true (for now), as we want to support column resizing
// everywhere
return true;
}
private void columnResizingStarted(double startX) {
getTableHeaderRow().getColumnReorderLine().setLayoutX(startX);
}
private void columnResizing(TableColumnBase col, MouseEvent me) {
double draggedX = me.getSceneX() - dragAnchorX;
if (getEffectiveNodeOrientation() == NodeOrientation.RIGHT_TO_LEFT) {
draggedX = -draggedX;
}
double delta = draggedX - lastX;
boolean allowed = getTableViewSkin().resizeColumn(col, delta);
if (allowed) {
lastX = draggedX;
}
}
private void columnResizingComplete(TableColumnBase col, MouseEvent me) {
// getTableHeaderRow().getColumnReorderLine().setVisible(true);
getTableHeaderRow().getColumnReorderLine().setTranslateX(0.0F);
getTableHeaderRow().getColumnReorderLine().setLayoutX(0.0F);
lastX = 0.0F;
}
/* **************************/
/* END OF COLUMN RESIZING */
/* **************************/
boolean updateColumns = true;
void setHeadersNeedUpdate() {
updateColumns = true;
// go through children columns - they should update too
for (int i = 0; i < getColumnHeaders().size(); i++) {
TableColumnHeader header = getColumnHeaders().get(i);
if (header instanceof NestedTableColumnHeader) {
((NestedTableColumnHeader)header).setHeadersNeedUpdate();
}
}
requestLayout();
}
private void checkState() {
if (updateColumns) {
updateTableColumnHeaders();
updateColumns = false;
getParent().requestLayout();
}
}
@Override protected void layoutChildren() {
double w = getWidth() - snappedLeftInset() - snappedRightInset();
double h = getHeight() - snappedTopInset() - snappedBottomInset();
int labelHeight = (int) label.prefHeight(-1);
if (label.isVisible()) {
// label gets to span whole width and sits at top
label.resize(w, labelHeight);
label.relocate(snappedLeftInset(), snappedTopInset());
}
// children columns need to share the total available width
double x = snappedLeftInset();
int i = 0;
for (TableColumnHeader n : getColumnHeaders()) {
if (! n.isVisible()) continue;
double prefWidth = snapSize(n.prefWidth(-1));
// double prefHeight = n.prefHeight(-1);
// position the column header in the default location...
n.resize(prefWidth, snapSize(h - labelHeight));
n.relocate(x, labelHeight + snappedTopInset());
// // ...but, if there are no children of this column, we should ensure
// // that it is resized vertically such that it goes to the very
// // bottom of the table header row.
// if (getTableHeaderRow() != null && n.getCol().getColumns().isEmpty()) {
// Bounds bounds = getTableHeaderRow().sceneToLocal(n.localToScene(n.getBoundsInLocal()));
// prefHeight = getTableHeaderRow().getHeight() - bounds.getMinY();
// n.resize(prefWidth, prefHeight);
// }
// shuffle along the x-axis appropriately
x += prefWidth;
// position drag overlay to intercept column resize requests
if (dragRects != null && i < dragRects.size()) {
Rectangle dragRect = dragRects.get(i++);
dragRect.setHeight(getHeight() - label.getHeight());
dragRect.relocate(x - DRAG_RECT_WIDTH / 2, snappedTopInset() + labelHeight);
}
}
}
// sum up all children columns
@Override protected double computePrefWidth(double height) {
checkState();
double width = 0.0F;
if (getColumns() != null) {
for (TableColumnHeader c : getColumnHeaders()) {
if (c.isVisible()) {
width += snapSize(c.computePrefWidth(height));
}
}
}
return width;
}
@Override protected double computePrefHeight(double width) {
checkState();
double height = 0.0F;
if (getColumnHeaders() != null) {
for (TableColumnHeader n : getColumnHeaders()) {
height = Math.max(height, n.prefHeight(-1));
}
}
return height + label.prefHeight(-1) + snappedTopInset() + snappedBottomInset();
}
private TableColumnHeader createColumnHeader(TableColumnBase col) {
TableColumnHeader newCol = createTableColumnHeader(col);
newCol.setTableHeaderRow(getTableHeaderRow());
newCol.setParentHeader(this);
return newCol;
}
protected TableColumnHeader createTableColumnHeader(TableColumnBase col) {
return col.getColumns().isEmpty() ?
new TableColumnHeader(getTableViewSkin(), col) :
new NestedTableColumnHeader(getTableViewSkin(), col);
}
}