了解cell工厂和回调

Question

我正在尝试为ListView实现自定义cell Factory。我的应用程序基于我从另一个线程获取的这个示例。

import javafx.application.Application;
import javafx.collections.FXCollections;
import javafx.collections.ObservableList;
import javafx.event.ActionEvent;
import javafx.event.EventHandler;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.scene.control.ListCell;
import javafx.scene.control.ListView;
import javafx.scene.layout.HBox;
import javafx.scene.layout.Pane;
import javafx.scene.layout.Priority;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;
import javafx.util.Callback;

public class SO extends Application {
    static class XCell extends ListCell<String> {
        HBox hbox = new HBox();
        Label label = new Label("(empty)");
        Pane pane = new Pane();
        Button button = new Button("(>)");
        String lastItem;

        public XCell() {
            super();
            hbox.getChildren().addAll(label, pane, button);
            HBox.setHgrow(pane, Priority.ALWAYS);
            button.setOnAction(new EventHandler<ActionEvent>() {
                @Override
                public void handle(ActionEvent event) {
                    System.out.println(lastItem + " : " + event);
                }
            });
        }

        @Override
        protected void updateItem(String item, boolean empty) {
            super.updateItem(item, empty);
            setText(null);  // No text in label of super class
            if (empty) {
                lastItem = null;
                setGraphic(null);
            } else {
                lastItem = item;
                label.setText(item!=null ? item : "<null>");
                setGraphic(hbox);
            }
        }
    }

    @Override
    public void start(Stage primaryStage) throws Exception {
        StackPane pane = new StackPane();
        Scene scene = new Scene(pane, 300, 150);
        primaryStage.setScene(scene);
        ObservableList<String> list = FXCollections.observableArrayList(
                "Item 1", "Item 2", "Item 3", "Item 4");
        ListView<String> lv = new ListView<>(list);
        lv.setCellFactory(new Callback<ListView<String>, ListCell<String>>() {
            @Override
            public ListCell<String> call(ListView<String> param) {
                return new XCell();
            }
        });
        pane.getChildren().add(lv);
        primaryStage.show();
    }

    public static void main(String[] args) {
        launch(args);
    }
}

因此，对于该列表的每一行，都将创建一个新的XCell对象，hBox将从中显示。然而，尽管有文档记录，我不理解以下事情是如何发生的：

>

这很模糊，但我可以猜hBox的出现是因为ListCell。setgraphics（从标记的类继承）。

在XCell中。updateItem（字符串项，布尔空），如何将参数传递给该方法？调用ListView中包含的每个字符串，它返回一个新的XCell（），但没有参数传递给该构造函数。

有人能给我解释一下吗？

Answer 1

这是模糊的，但我可以猜到hBox出现是因为ListCell.setgraphics（继承自标签类）。

是的，没错。从单元格的文档中：

因为到目前为止，单元格最常见的用例是向用户显示文本，因此此用例特别针对Cell中进行了优化。这是由从标签扩展的Cell完成的。这意味着Cell的子类只需要设置文本属性，而不是创建单独的Label并在Cell中设置它。但是，对于不仅仅需要纯文本的情况，可以将任何节点放置在Cell图形属性中。尽管有这个术语，图形可以是任何节点，并且将是完全交互式的。例如，ListCell可能配置为按钮作为其图形。按钮文本可以绑定到单元格项属性。这样，每当单元格中的项目发生变化时，按钮文本就会自动更新。

您的下一个问题：

在XCell中。updateItem（字符串项，布尔空），如何将参数传递给该方法？调用ListView中包含的每个字符串，它返回一个新的XCell（），但没有参数传递给该构造函数。

您正在列表视图上设置工厂。工厂本质上是一个为列表视图创建列表单元格的函数。所以调用（…）方法只需返回一个ListCell：在这种情况下，您将返回一个XCell子类的实例。

ListView的工作方式（至少在概念上）如下：

最初，它使用单元格工厂为每个可见单元格创建ListCells，并将这些单元格排列出来。然后它找出要在每个单元格中显示的值，并在每个单元格上调用updateItem（...）方法，传入项目。如果空间超过列表中项目数所需的空间，它将用额外的单元格填充它们，并调用updateItem（null， true）来指示这些单元格为空。

当要显示的项目发生变化时：通过列表内容的变化，或通过用户滚动（或通过其他机制，例如ListView更改大小等），ListView将重新计算要显示的项目，并调用updateItem（...）传入新项目。这样，当用户滚动时，可以重用单元格，并且最大限度地减少创建新单元格实例的需要。

因此，当您实现Cells时，重要的是要尊重这样一个事实，即updateItem（...）方法可能会被多次调用，而新的Cell实例的创建相对较少。因此，updateItem（...）方法应该快速执行；任何更重量级的事情都应该在构造函数中完成一次。请注意，在您展示的XCell实现中，所有Nodes（HBox、Label、Pane和Button）的创建和布局是在构建时完成的。updateItem（...）只需更新标签的文本即可完成这一最少的工作。