JavaFx TableView疑难详解

TableView是个十分有用的控件,适应性和灵活性非常强,可以对它进行任意的修改,比如界面样式、功能。本文将从一步步提问的方式讲解TableView

  1. 创建已知列的TableView 已知列的表格的创建,需要把TableView的TableColumn关联到模型的属性,TableView是个模板类,其实是TableView,这个T就是模型,例如下代码:
// MyModel.java
public class MyModel{
  private String name;
  private String url;
  // getters, setters
  ...
}
// init your tableView
TableColumn<MyModel, String> t1 = new TableColumn();
// 关联MyModel中的name属性
t1.setCellValueFactory(new PropertyValueFactory<>("name")); 
t1.setCellFactory(p->{
  // 创建此列的Cell的时候的回调,允许让你自己去创建
});

特别要说明的是setCellValueFactorysetCellFactory不是冲突的,我用的时候一直以为是冲突,就是只能用其中一个,另外一个就失效了,其实不是,setCellFactory它的意图是在创建这列的时候要做的事情,你可以改变TableCell的任何内容,包括UI和Value,而setCellValueFactory呢,它的重点是关联属性,从你传递给它的Model中通过对应属性的getter来获取值。在setCellFactory中的TableCell有个回调,叫updateItem,它可以获取到你设置到此Cell的值,这个值是跟setCellValueFactory所关联的属性有关。

  1. 创建动态列的TableView 参考:https://community.oracle.com/thread/2474328 因为列是不定的,模型是没有属性对应的,创建列的时候你根本不知道列是什么,看如下实现代码:
column.setCellValueFactory(param -> {
            ObservableList<VarCell> values = param.getValue();
            if (columnIndex >= values.size()) {
                return new SimpleObjectProperty<>(null);
            } else {
                return new SimpleObjectProperty<>(param.getValue().get(columnIndex));
            }
        });

创建动态列的tableview,它的模型是一个ObservableList<T>,你的setCellValueFactory不能使用PropertyValueFactory,而是如上代码所示,通过列的索引来获取此列的值

  1. [列拖动] 如何捕获列拖动事件? 列拖动是tablview一个默认的自带的效果,但是并没有专门的事件给你去监听它,而是监听列的变化,方法:给tableview的columns添加Listener,判断变动列的状态是否是replaced的状态,例如:
tableView.getColumns().addListener(new ListChangeListener<TableColumn<ObservableList<VarCell>, ?>>() {
            @Override
            public void onChanged(Change<? extends TableColumn<ObservableList<VarCell>, ?>> change) {
                change.next();
                if (change.wasReplaced()) {
                    // 表示当前拖动过了
                }
            }
        });

2.  [列拖动] 如何防止第一列被拖动? 在上一问的基础上,实现第一列不允许被拖动的功能。 参考:https://stackoverflow.com/questions/30645606/javafx-restrict-column-rearrangement-on-drag-and-drop

tableView.getColumns().addListener(new ListChangeListener<TableColumn<ObservableList<String>, ?>>() {
            private boolean suspended;

            @Override
            public void onChanged(Change<? extends TableColumn<ObservableList<String>, ?>> change) {
                change.next();

                if (change.wasReplaced() && !suspended) {
                    List<TableColumn<ObservableList<String>, ?>> oldList = new ArrayList<>(change.getRemoved());
                    List<TableColumn<ObservableList<String>, ?>> newList = new ArrayList<>(tableView.getColumns());

                    // first column changed => revert to original list
                    if (oldList.get(0) != newList.get(0)) {
                        this.suspended = true;
                        tableView.getColumns().setAll(oldList);
                        this.suspended = false;
                    } 
                }
            }
        });

上面的代码中有三个关键的地方,是tableview原本提供的api,一个是change.wasReplaced表示当前的变动是否被替换了,第二个是change.getRemoved,表示获取要移除掉的列,进一步的意思就是原来的列,也就是此前的tablecolumns,第三个是tableview.getColumns这个是获取现在列,有了这些信息,就可以判断,oldList.get(0)!=newList(0),表示如果新老列的第一列不相同,表示是第一列是变动的,但是我们不允许变动,因此,调用tableview.getColumns().setAll(oldList)用来恢复原来的列。这样就禁止拖动第一列了。

  1. [列拖动] 如何禁用列拖动效果? 参考:https://stackoverflow.com/questions/22202782/how-to-prevent-tableview-from-doing-tablecolumn-re-order-in-javafx-8 给列设置一个属性:column.impl_setReorderable(false); impl_setReorderable前面带**impl_**前缀,表示它是一个将来可能会被删除的方法,但是为了解决目前无法解决的问题,暂时把impl的私有方法改为了public方法,参考我的博客中的如何自定义Taborder的文章,是一样的道理。
  2. [行拖动] 如何拖动行,进行换行? 参考:https://stackoverflow.com/questions/28603224/sort-tableview-with-drag-and-drop-rows 已经测试过的代码:
tableView.setRowFactory(tv -> {
            TableRow<ObservableList<String>> row = new TableRow<>();

            row.setOnDragDetected(event -> {
                log.info("row drag detected");
                if (!row.isEmpty()) {
                    Integer index = row.getIndex();
                    Dragboard db = row.startDragAndDrop(TransferMode.MOVE);
                    db.setDragView(row.snapshot(null, null));
                    ClipboardContent cc = new ClipboardContent();
                    cc.put(SERIALIZED_MIME_TYPE, index);
                    db.setContent(cc);
                    event.consume();
                }
            });

            row.setOnDragOver(event -> {
                log.info("row drag over");
                Dragboard db = event.getDragboard();
                if (db.hasContent(SERIALIZED_MIME_TYPE)) {
                    if (row.getIndex() != ((Integer) db.getContent(SERIALIZED_MIME_TYPE)).intValue()) {
                        event.acceptTransferModes(TransferMode.COPY_OR_MOVE);
                        event.consume();
                    }
                }
            });

            row.setOnDragDropped(event -> {
                log.info("row drag dropped");
                Dragboard db = event.getDragboard();
                if (db.hasContent(SERIALIZED_MIME_TYPE)) {
                    int draggedIndex = (Integer) db.getContent(SERIALIZED_MIME_TYPE);
                    ObservableList<String> draggedPerson = tableView.getItems().remove(draggedIndex);

                    int dropIndex;

                    if (row.isEmpty()) {
                        dropIndex = tableView.getItems().size();
                    } else {
                        dropIndex = row.getIndex();
                    }

                    tableView.getItems().add(dropIndex, draggedPerson);

                    event.setDropCompleted(true);
                    tableView.getSelectionModel().select(dropIndex);
                    event.consume();
                }
            });

            return row;
        });
  1. 修改TableView样式 使用css,参考如下我的测试代码
.table-view {
    -fx-border-width: 1px;
    -fx-border-color: #CACACA;
    -fx-background-color: transparent;
}

.table-view:focused {
    -fx-background-color: transparent;
}

.table-view .table-cell {
    -fx-font-size: 12px;
}

.table-view .filler {
    -fx-background-color: #BDE8FF;
}

.table-view .text {
    -fx-text-fill: red;
}

.table-view .column-header {
    -fx-background-color: #BDE8FF;
    -fx-pref-height: 37px;
    -fx-border-width: 1px;
    -fx-border-color: #D9D9D9;
    -fx-border-insets: -2px -2px 0px -2px;
}

.table-view .column-header-background .label {
    -fx-text-fill: #363739;
    -fx-font-weight: normal;
    -fx-font-size: 12px;
}

.table-row-cell {
    /*行高*/
    -fx-cell-size: 35px;
}

.table-row-cell .cell {
    -fx-alignment: center;
    -fx-text-fill: #333333;
}

.table-view .table-cell:selected {
    -fx-text-fill: white;
}

.table-view .table-column .column-header {
    -fx-background-color: #363739;
}

.cell {
    /*-fx-border-width: 0px 1px 0 0;*/
    /*-fx-border-color: #CACACA;*/
}

.table-view .scroll-bar {
    -fx-background-color: transparent;
}

.viewport {
    -fx-background-color: white;
}
  1. 如何自定义列头,比如自己设置一个可编辑的列头呢? 答案是给你的TableColumn设置setGraphic,可编辑的列头的话,你让你的graphic中有编辑框,双击显示编辑框,按enter键确认编辑,如下是一个我的实现:  ​
package com.itestin.ui.datamgt.table;

import com.itestin.ui.recordNreplay.logic.CommonLogic;
import javafx.beans.property.BooleanProperty;
import javafx.beans.property.SimpleBooleanProperty;
import javafx.beans.property.SimpleStringProperty;
import javafx.beans.property.StringProperty;
import javafx.geometry.Pos;
import javafx.scene.control.Label;
import javafx.scene.control.TableColumn;
import javafx.scene.control.TextField;
import javafx.scene.control.Tooltip;
import javafx.scene.input.KeyCode;
import javafx.scene.layout.StackPane;

/**
 * Created by cmlanche on 2017/6/1.
 */
public class EditColumn extends StackPane {

    private EditColumnCallback callback;

    private Label label;
    private TextField textField;

    private StringProperty title;
    private BooleanProperty editing;
    private BooleanProperty editable;
    private BooleanProperty textFieldFocus;
    private TableColumn tableColumn;

    private String oldTitle;

    public EditColumn(TableColumn tableColumn) {
        super();
        this.tableColumn = tableColumn;
        this.init();
    }

    private void init() {
        this.setMaxWidth(120);
        this.setAlignment(Pos.CENTER);
        this.setStyle("-fx-background-color: #D9D9D9;");
        label = new Label();
        label.setStyle("-fx-font-size: 12px; -fx-text-fill: #333333;");
        textField = new TextField();
        textField.getStyleClass().add("tablefx-header-editor");
        label.textProperty().bindBidirectional(titleProperty());
        textField.textProperty().bindBidirectional(titleProperty());
        label.setTooltip(new Tooltip());
        label.getTooltip().textProperty().bindBidirectional(label.textProperty());
        this.getChildren().addAll(label, textField);
        editingProperty().addListener((observable, oldValue, newValue) -> {
            if (isEditable()) {
                if (newValue) {
                    label.setVisible(false);
                    textField.setVisible(true);
                    textField.setFocusTraversable(true);
                    textField.requestFocus();
                } else {
                    label.setVisible(true);
                    textField.setVisible(false);
                }
            }
        });
        textField.textProperty().addListener((observable, oldValue, newValue) -> {
            textField.setStyle("-fx-border-color: #25B3FA;");
        });
        this.setStyle("-fx-background-color: transparent;");
        textField.setOnKeyPressed(event -> {
            if (isEditing()) {
                if (event.getCode() == KeyCode.ENTER) {
                    event.consume(); // 放置对tabview的其他列产生影响,不让消息透传
                    oldTitle = textField.getText();
                    setEditing(false);
                    // 提交编辑
                    if (callback != null) {
                        callback.editCommit(tableColumn, textField.getText());
                    }
                } else if (event.getCode() == KeyCode.ESCAPE) {
                    setTitle(oldTitle);
                    setEditing(false);
                    // 取消编辑
                    if (callback != null) {
                        callback.cancelEdit();
                    }
                } else if (event.getCode() == KeyCode.TAB) {
                    setEditing(false);
                }
            }
        });
        textFieldFocusProperty().addListener((observable, oldValue, newValue) -> {
            if (newValue) {
                textField.setFocusTraversable(true);
                textField.requestFocus();
            }
        });
        setEditing(false);
    }

    public String getTitle() {
        return titleProperty().get();
    }

    public StringProperty titleProperty() {
        if (title == null) {
            title = new SimpleStringProperty();
        }
        return title;
    }

    public void setTitle(String title) {
        this.oldTitle = title;
        this.titleProperty().set(title);
    }

    public boolean isEditing() {
        return editingProperty().get();
    }

    public BooleanProperty editingProperty() {
        if (editing == null) {
            editing = new SimpleBooleanProperty(true);
        }
        return editing;
    }

    public void setEditing(boolean editing) {
        this.editingProperty().set(editing);
    }

    public void setEditCallback(EditColumnCallback callback) {
        this.callback = callback;
    }

    public boolean isEditable() {
        return editableProperty().get();
    }

    public BooleanProperty editableProperty() {
        if (editable == null) {
            editable = new SimpleBooleanProperty(true);
        }
        return editable;
    }

    public void setEditable(boolean editable) {
        this.editableProperty().set(editable);
    }

    public boolean isTextFieldFocus() {
        return textFieldFocusProperty().get();
    }

    public BooleanProperty textFieldFocusProperty() {
        if (textFieldFocus == null) {
            textFieldFocus = new SimpleBooleanProperty();
        }
        return textFieldFocus;
    }

    public void setTextFieldFocus(boolean textFieldFocus) {
        this.textFieldFocusProperty().set(textFieldFocus);
    }
}

最后欢迎加入我的javafx探讨群:518914410

本文版权原创 by cmlanche.com