JavaFX自定义控件加载异常及setText方法调用问题求助

1. 解决'Root hasn't been set. Use method setRoot() before load.'异常 #

异常原因 #

你通过<fx:include>直接加载custom_control.fxml，但该FXML采用fx:root模式，必须与CustomControl类的构造逻辑绑定（构造函数中会设置FXMLLoader的root和controller）。直接加载FXML文件时，FXMLLoader未被设置root，因此抛出异常。

解决方案 #

不要用<fx:include>加载自定义控件的FXML，而是在TestView.fxml中直接引用CustomControl类，像使用普通JavaFX控件一样：

修改后的TestView.fxml：

<?xml version="1.0" encoding="UTF-8"?>

<?import javafx.scene.control.Button?>
<?import javafx.scene.layout.AnchorPane?>
<?import your.package.path.CustomControl?> <!-- 替换成CustomControl实际所在的包 -->

<AnchorPane fx:controller="controller.TestController" maxHeight="-Infinity" maxWidth="-Infinity" minHeight="-Infinity" minWidth="-Infinity" prefHeight="400.0" prefWidth="600.0" xmlns="http://javafx.com/javafx/19" xmlns:fx="http://javafx.com/fxml/1">
    <children>
        <CustomControl fx:id="custom_control"/> <!-- 直接使用自定义控件类 -->
        <Button onAction="#OnButtonPress" fx:id="button" layoutX="148.0" layoutY="117.0" mnemonicParsing="false" text="Button" />
    </children>
</AnchorPane>

2. 正确调用CustomControl的setText方法 #

问题原因 #

TestController中把custom_control声明为VBox类型，而setText是CustomControl特有的方法，父类VBox没有这个方法，因此无法调用。

解决方案 #

将TestController中的custom_control类型改为CustomControl，并导入对应的类：

修改后的TestController.java：

package controller;

import javafx.fxml.FXML;
import javafx.scene.control.Button;
import your.package.path.CustomControl; // 替换成CustomControl实际所在的包

public class TestController {

    @FXML
    private Button button;

    @FXML
    private CustomControl custom_control; // 修改类型为CustomControl

    public TestController() {
    }

    @FXML
    private void OnButtonPress() {
        // 现在可以直接调用setText方法
        custom_control.setText("This is the new text");
    }
}

验证其他代码正确性 #

你的CustomControl.java和CustomControl.fxml的实现是正确的：

• CustomControl继承自VBox，与FXML中fx:root的类型一致
• 构造函数中正确设置了FXMLLoader的root和controller，加载FXML时不会出现问题

内容的提问来源于stack exchange，提问作者Tobs