SceneBuilder不会加载通过FXML引用另一个自定义控件的自定义控件

基础概念

SceneBuilder 是 JavaFX 中的一个可视化布局工具，用于设计和编辑 FXML 文件。FXML 是一种基于 XML 的标记语言，用于定义 JavaFX 应用的用户界面。

自定义控件 是指开发者自己创建的控件，可以包含复杂的 UI 元素和逻辑。

问题原因

当 SceneBuilder 无法加载通过 FXML 引用另一个自定义控件的自定义控件时，通常有以下几种原因：

类路径问题：SceneBuilder 可能无法找到自定义控件的类文件。
FXML 文件引用错误：在 FXML 文件中对自定义控件的引用可能不正确。
缺少依赖库：SceneBuilder 可能缺少加载自定义控件所需的依赖库。
版本兼容性问题：SceneBuilder 和自定义控件的版本可能不兼容。

解决方法

1. 确保类路径正确

确保自定义控件的类文件在 SceneBuilder 的类路径中。可以通过以下步骤检查和设置：

将自定义控件的 JAR 文件添加到 SceneBuilder 的库路径中。
在 SceneBuilder 中，选择 File -> Preferences -> Libraries，然后添加包含自定义控件的 JAR 文件。

2. 检查 FXML 文件引用

确保 FXML 文件中对自定义控件的引用是正确的。例如：

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

<?import com.example.MyCustomControl?>

<VBox xmlns:fx="http://javafx.com/fxml/1">
    <MyCustomControl />
</VBox>

3. 添加缺失的依赖库

如果自定义控件依赖于其他库，确保这些库也在 SceneBuilder 的类路径中。可以通过以下步骤添加：

将所有依赖的 JAR 文件添加到 SceneBuilder 的库路径中。
在 SceneBuilder 中，选择 File -> Preferences -> Libraries，然后添加所有依赖的 JAR 文件。

4. 检查版本兼容性

确保 SceneBuilder 和自定义控件的版本是兼容的。如果不兼容，可能需要更新 SceneBuilder 或自定义控件的版本。

示例代码

假设我们有一个自定义控件 MyCustomControl，其 FXML 文件如下：

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

<?import javafx.scene.control.Label?>
<?import javafx.scene.layout.VBox?>

<VBox xmlns:fx="http://javafx.com/fxml/1" fx:controller="com.example.MyCustomControlController">
    <Label text="This is a custom control" />
</VBox>

对应的控制器类 MyCustomControlController.java：

package com.example;

import javafx.fxml.FXML;
import javafx.scene.control.Label;

public class MyCustomControlController {
    @FXML
    private Label label;

    @FXML
    public void initialize() {
        label.setText("Custom control initialized");
    }
}

在主 FXML 文件中引用这个自定义控件：

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

<?import com.example.MyCustomControl?>

<VBox xmlns:fx="http://javafx.com/fxml/1">
    <MyCustomControl />
</VBox>

确保 com.example.MyCustomControl 类和其依赖的库都在 SceneBuilder 的类路径中。