Module  javafx.fxml
软件包  javafx.fxml

Class FXMLLoader



  • public class FXMLLoader
    extends Object
    从XML文档加载对象层次结构。 有关详细信息,请参阅Introduction to FXML文档。
    从以下版本开始:
    JavaFX 2.0
    • 字段详细信息

      • DEFAULT_CHARSET_NAME

        public static final String DEFAULT_CHARSET_NAME
        字符集未被明确指定时使用的字符集。
        另请参见:
        Constant Field Values
      • LANGUAGE_PROCESSING_INSTRUCTION

        public static final String LANGUAGE_PROCESSING_INSTRUCTION
        语言处理指令的标签名称。
        另请参见:
        Constant Field Values
      • IMPORT_PROCESSING_INSTRUCTION

        public static final String IMPORT_PROCESSING_INSTRUCTION
        导入处理指令的标签名称。
        另请参见:
        Constant Field Values
      • FX_NAMESPACE_PREFIX

        public static final String FX_NAMESPACE_PREFIX
        'fx'命名空间的前缀。
        另请参见:
        Constant Field Values
      • FX_CONTROLLER_ATTRIBUTE

        public static final String FX_CONTROLLER_ATTRIBUTE
        根的fx:controller属性的名称。
        另请参见:
        Constant Field Values
      • FX_CONSTANT_ATTRIBUTE

        public static final String FX_CONSTANT_ATTRIBUTE
        标签名为'fx:constant'。
        从以下版本开始:
        JavaFX 2.2
        另请参见:
        Constant Field Values
      • FX_FACTORY_ATTRIBUTE

        public static final String FX_FACTORY_ATTRIBUTE
        “fx:factory”属性的名称。
        另请参见:
        Constant Field Values
      • INCLUDE_SOURCE_ATTRIBUTE

        public static final String INCLUDE_SOURCE_ATTRIBUTE
        <fx:include>'source'属性。
        另请参见:
        Constant Field Values
      • INCLUDE_RESOURCES_ATTRIBUTE

        public static final String INCLUDE_RESOURCES_ATTRIBUTE
        <fx:include>'资源'属性。
        另请参见:
        Constant Field Values
      • INCLUDE_CHARSET_ATTRIBUTE

        public static final String INCLUDE_CHARSET_ATTRIBUTE
        <fx:include>'charset'属性。
        另请参见:
        Constant Field Values
      • SCRIPT_SOURCE_ATTRIBUTE

        public static final String SCRIPT_SOURCE_ATTRIBUTE
        <fx:script>'source'属性。
        另请参见:
        Constant Field Values
      • SCRIPT_CHARSET_ATTRIBUTE

        public static final String SCRIPT_CHARSET_ATTRIBUTE
        <fx:script>'charset'属性。
        另请参见:
        Constant Field Values
      • REFERENCE_SOURCE_ATTRIBUTE

        public static final String REFERENCE_SOURCE_ATTRIBUTE
        <fx:reference>'source'属性。
        另请参见:
        Constant Field Values
      • ROOT_TAG

        public static final String ROOT_TAG
        标签名称为<fx:root>。
        从以下版本开始:
        JavaFX 2.2
        另请参见:
        Constant Field Values
      • ROOT_TYPE_ATTRIBUTE

        public static final String ROOT_TYPE_ATTRIBUTE
        <fx:root>'type'属性。
        从以下版本开始:
        JavaFX 2.2
        另请参见:
        Constant Field Values
      • COPY_SOURCE_ATTRIBUTE

        public static final String COPY_SOURCE_ATTRIBUTE
        <fx:copy>'source'属性。
        另请参见:
        Constant Field Values
      • EVENT_HANDLER_PREFIX

        public static final String EVENT_HANDLER_PREFIX
        事件处理程序属性的前缀。
        另请参见:
        Constant Field Values
      • EVENT_KEY

        public static final String EVENT_KEY
        事件处理程序脚本中Event对象的名称。
        另请参见:
        Constant Field Values
      • CHANGE_EVENT_HANDLER_SUFFIX

        public static final String CHANGE_EVENT_HANDLER_SUFFIX
        财产更改/无效处理程序的后缀。
        另请参见:
        Constant Field Values
      • RELATIVE_PATH_PREFIX

        public static final String RELATIVE_PATH_PREFIX
        前缀相对位置解析。
        另请参见:
        Constant Field Values
      • RESOURCE_KEY_PREFIX

        public static final String RESOURCE_KEY_PREFIX
        前缀用于资源解析。
        另请参见:
        Constant Field Values
      • EXPRESSION_PREFIX

        public static final String EXPRESSION_PREFIX
        (变量)表达式分辨率的前缀。
        另请参见:
        Constant Field Values
      • BINDING_EXPRESSION_PREFIX

        public static final String BINDING_EXPRESSION_PREFIX
        用于表达式解析的前缀。
        另请参见:
        Constant Field Values
      • BINDING_EXPRESSION_SUFFIX

        public static final String BINDING_EXPRESSION_SUFFIX
        绑定表达式分辨率的后缀
        另请参见:
        Constant Field Values
      • BI_DIRECTIONAL_BINDING_PREFIX

        public static final String BI_DIRECTIONAL_BINDING_PREFIX
        前缀用于双向绑定表达式解析。
        从以下版本开始:
        JavaFX 2.1
        另请参见:
        Constant Field Values
      • BI_DIRECTIONAL_BINDING_SUFFIX

        public static final String BI_DIRECTIONAL_BINDING_SUFFIX
        双向绑定表达式解析的后缀。
        从以下版本开始:
        JavaFX 2.1
        另请参见:
        Constant Field Values
      • ARRAY_COMPONENT_DELIMITER

        public static final String ARRAY_COMPONENT_DELIMITER
        数组的分隔符作为值。
        从以下版本开始:
        JavaFX 2.1
        另请参见:
        Constant Field Values
      • CONTROLLER_METHOD_PREFIX

        public static final String CONTROLLER_METHOD_PREFIX
        控制器方法分辨率前缀。
        另请参见:
        Constant Field Values
      • CONTROLLER_KEYWORD

        public static final String CONTROLLER_KEYWORD
        控制器在命名空间映射中的关键。
        从以下版本开始:
        JavaFX 2.1
        另请参见:
        getNamespace()Constant Field Values
      • CONTROLLER_SUFFIX

        public static final String CONTROLLER_SUFFIX
        包含fxml文件的控制器的后缀。 全键存储在命名空间映射中。
        从以下版本开始:
        JavaFX 2.2
        另请参见:
        getNamespace()Constant Field Values
      • INITIALIZE_METHOD_NAME

        public static final String INITIALIZE_METHOD_NAME
        初始化方法的名称。
        从以下版本开始:
        JavaFX 2.2
        另请参见:
        Constant Field Values
      • JAVAFX_VERSION

        public static final String JAVAFX_VERSION
        包含当前的javafx版本。
        从以下版本开始:
        JavaFX 8.0
      • FX_NAMESPACE_VERSION

        public static final String FX_NAMESPACE_VERSION
        包含当前的fx namepsace版本。
        从以下版本开始:
        JavaFX 8.0
        另请参见:
        Constant Field Values
    • 构造方法详细信息

      • FXMLLoader

        public FXMLLoader​()
        创建一个新的FXMLLoader实例。
      • FXMLLoader

        public FXMLLoader​(URL location)
        创建一个新的FXMLLoader实例。
        参数
        location - 用于解析相对路径属性值的位置
        从以下版本开始:
        JavaFX 2.1
      • FXMLLoader

        public FXMLLoader​(URL location,
                          ResourceBundle resources)
        创建一个新的FXMLLoader实例。
        参数
        location - 用于解析相对路径属性值的位置
        resources - 用于解析资源密钥属性值的资源
        从以下版本开始:
        JavaFX 2.1
      • FXMLLoader

        public FXMLLoader​(URL location,
                          ResourceBundle resources,
                          BuilderFactory builderFactory)
        创建一个新的FXMLLoader实例。
        参数
        location - 用于解析相对路径属性值的位置
        resources - 用于解析资源密钥属性值的资源
        builderFactory - 这个装载机使用的生成工厂
        从以下版本开始:
        JavaFX 2.1
      • FXMLLoader

        public FXMLLoader​(URL location,
                          ResourceBundle resources,
                          BuilderFactory builderFactory,
                          Callback<Class<?>,Object> controllerFactory)
        创建一个新的FXMLLoader实例。
        参数
        location - 用于解析相对路径属性值的位置
        resources - 用于解析资源密钥属性值的资源
        builderFactory - 这个装载机使用的生成工厂
        controllerFactory - 这个装载机使用的控制器工厂
        从以下版本开始:
        JavaFX 2.1
      • FXMLLoader

        public FXMLLoader​(Charset charset)
        创建一个新的FXMLLoader实例。
        参数
        charset - 这个装载器使用的字符集
      • FXMLLoader

        public FXMLLoader​(URL location,
                          ResourceBundle resources,
                          BuilderFactory builderFactory,
                          Callback<Class<?>,Object> controllerFactory,
                          Charset charset)
        创建一个新的FXMLLoader实例。
        参数
        location - 用于解析相对路径属性值的位置
        resources - 用于解析资源密钥属性值的资源
        builderFactory - 这个装载机使用的生成工厂
        controllerFactory - 这个装载机使用的控制器工厂
        charset - 这个装载器使用的字符集
        从以下版本开始:
        JavaFX 2.1
      • FXMLLoader

        public FXMLLoader​(URL location,
                          ResourceBundle resources,
                          BuilderFactory builderFactory,
                          Callback<Class<?>,Object> controllerFactory,
                          Charset charset,
                          LinkedList<FXMLLoader> loaders)
        创建一个新的FXMLLoader实例。
        参数
        location - 用于解析相对路径属性值的位置
        resources - 用于解析资源密钥属性值的资源
        builderFactory - 这个装载机使用的生成工厂
        controllerFactory - 这个装载机使用的控制器工厂
        charset - 这个装载器使用的字符集
        loaders - 装载机列表
        从以下版本开始:
        JavaFX 2.1
    • 方法详细信息

      • getLocation

        public URL getLocation​()
        返回用于解析相对路径属性值的位置。
        结果
        用于解析相对路径属性值的位置
      • setLocation

        public void setLocation​(URL location)
        设置用于解析相对路径属性值的位置。
        参数
        location - 的位置
      • getResources

        public ResourceBundle getResources​()
        返回用于解析资源密钥属性值的资源。
        结果
        用于解析资源密钥属性值的资源
      • setResources

        public void setResources​(ResourceBundle resources)
        设置用于解析资源密钥属性值的资源。
        参数
        resources - 资源
      • getNamespace

        public ObservableMap<String,Object> getNamespace​()
        返回此装载器使用的命名空间。
        结果
        命名空间
      • getRoot

        public <T> T getRoot​()
        返回对象层次结构的根。
        参数类型
        T - 根对象的类型
        结果
        对象层次结构的根
      • setRoot

        public void setRoot​(Object root)
        设置对象层次结构的根。 传递给此方法的值用作<fx:root>标记的值。 在使用<fx:root>之前,必须先调用此方法。
        参数
        root - 对象层次结构的根
        从以下版本开始:
        JavaFX 2.2
      • equals

        public boolean equals​(Object obj)
        描述从类别复制: Object
        指示一些其他对象是否等于此。

        equals方法在非空对象引用上实现等价关系:

        • 自反性 :对于任何非空的参考值xx.equals(x)应该返回true
        • 它是对称的 :对于任何非空引用值xyx.equals(y)应该返回true当且仅当y.equals(x)回报true
        • 传递性 :对于任何非空引用值xy ,并z ,如果x.equals(y)回报truey.equals(z)回报true ,然后x.equals(z)应该返回true
        • 它是一致的 :对于任何非空引用值xy ,在多次调用x.equals(y)始终返回true或始终返回false ,没有设置中使用的信息equals比较上的对象被修改。
        • 对于任何非空的参考值xx.equals(null)应该返回false

        equals类方法Object实现对象上差别可能性最大的相等关系; 也就是说,对于任何非空参考值xy ,当且仅当xy引用相同的对象( x == y具有值true )时,该方法返回true

        请注意,无论何时覆盖此方法,通常需要覆盖hashCode方法,以便维护hashCode方法的一般合同,该方法规定相等的对象必须具有相等的哈希码。

        重写:
        equalsObject
        参数
        obj - 用于比较的参考对象。
        结果
        true如果该对象与obj参数相同; false否则。
        另请参见:
        Object.hashCode()HashMap
      • getController

        public <T> T getController​()
        返回与根对象关联的控制器。
        参数类型
        T - 控制器的类型
        结果
        控制器与根对象相关联
      • setController

        public void setController​(Object controller)
        设置与根对象关联的控制器。 传递给此方法的值用作fx:controller属性的值。 当在文档中未指定fx:controller属性时,在使用控制器事件处理程序时,必须先调用此方法。
        参数
        controller - 控制器与根对象关联
        从以下版本开始:
        JavaFX 2.2
      • getBuilderFactory

        public BuilderFactory getBuilderFactory​()
        返回此装载器使用的构建器工厂。
        结果
        建筑工厂
      • setBuilderFactory

        public void setBuilderFactory​(BuilderFactory builderFactory)
        设置此装载器使用的构建器工厂。
        参数
        builderFactory - 建筑工厂
      • getControllerFactory

        public Callback<Class<?>,Object> getControllerFactory​()
        返回此装载器使用的控制器工厂。
        结果
        控制器厂
        从以下版本开始:
        JavaFX 2.1
      • setControllerFactory

        public void setControllerFactory​(Callback<Class<?>,Object> controllerFactory)
        设置此装载机使用的控制器工厂。
        参数
        controllerFactory - 控制器厂
        从以下版本开始:
        JavaFX 2.1
      • getCharset

        public Charset getCharset​()
        返回此装载器使用的字符集。
        结果
        字符集
      • setCharset

        public void setCharset​(Charset charset)
        设置此装载器使用的字符集。
        参数
        charset - 字符集
        从以下版本开始:
        JavaFX 2.1
      • getClassLoader

        public ClassLoader getClassLoader​()
        返回此加载器使用的类加载器。
        结果
        类加载器
        从以下版本开始:
        JavaFX 2.1
      • setClassLoader

        public void setClassLoader​(ClassLoader classLoader)
        设置此装载器使用的类加载器,并清除任何现有的导入。
        参数
        classLoader - 类加载器
        从以下版本开始:
        JavaFX 2.1
      • getLoadListener

        public LoadListener getLoadListener​()
        返回此加载器的负载侦听器。
        结果
        负载侦听器
        从以下版本开始:
        9
      • setLoadListener

        public final void setLoadListener​(LoadListener loadListener)
        设置此加载器的负载侦听器。
        参数
        loadListener - 负载监听器
        从以下版本开始:
        9
      • load

        public <T> T load​()
                   throws IOException
        从FXML文档加载对象层次结构。 文件载入的位置必须先通过电话setLocation(URL)设定
        参数类型
        T - 根对象的类型
        结果
        加载的对象层次结构
        异常
        IOException - 加载过程中是否发生错误
        从以下版本开始:
        JavaFX 2.1
      • load

        public <T> T load​(InputStream inputStream)
                   throws IOException
        从FXML文档加载对象层次结构。
        参数类型
        T - 根对象的类型
        参数
        inputStream - 包含要加载的FXML数据的输入流
        结果
        加载的对象层次结构
        异常
        IOException - 加载过程中是否发生错误
      • getDefaultClassLoader

        public static ClassLoader getDefaultClassLoader​()
        返回默认的类加载器。
        结果
        默认的类加载器
        从以下版本开始:
        JavaFX 2.1
      • setDefaultClassLoader

        public static void setDefaultClassLoader​(ClassLoader defaultClassLoader)
        设置默认的类加载器。
        参数
        defaultClassLoader - 加载类时要使用的默认类加载器。
        从以下版本开始:
        JavaFX 2.1
      • load

        public static <T> T load​(URL location)
                          throws IOException
        从FXML文档加载对象层次结构。
        参数类型
        T - 根对象的类型
        参数
        location - 用于解析相对路径属性值的位置
        结果
        加载的对象层次结构
        异常
        IOException - 加载过程中是否发生错误
      • load

        public static <T> T load​(URL location,
                                 ResourceBundle resources)
                          throws IOException
        从FXML文档加载对象层次结构。
        参数类型
        T - 根对象的类型
        参数
        location - 用于解析相对路径属性值的位置
        resources - 用于解析资源密钥属性值的资源
        结果
        加载的对象层次结构
        异常
        IOException - 加载过程中是否发生错误
      • load

        public static <T> T load​(URL location,
                                 ResourceBundle resources,
                                 BuilderFactory builderFactory)
                          throws IOException
        从FXML文档加载对象层次结构。
        参数类型
        T - 根对象的类型
        参数
        location - 用于解析相对路径属性值的位置
        resources - 用于解析资源密钥属性值的资源
        builderFactory - 用于加载文档的构建器工厂
        结果
        加载的对象层次结构
        异常
        IOException - 加载过程中是否发生错误
      • load

        public static <T> T load​(URL location,
                                 ResourceBundle resources,
                                 BuilderFactory builderFactory,
                                 Callback<Class<?>,Object> controllerFactory)
                          throws IOException
        从FXML文档加载对象层次结构。
        参数类型
        T - 根对象的类型
        参数
        location - 用于解析相对路径属性值的位置
        resources - 用于解析资源密钥属性值的资源
        builderFactory - 加载文档时使用的构建工厂
        controllerFactory - 加载文档时使用的控制器工厂
        结果
        加载的对象层次结构
        异常
        IOException - 加载过程中是否发生错误
        从以下版本开始:
        JavaFX 2.1
      • load

        public static <T> T load​(URL location,
                                 ResourceBundle resources,
                                 BuilderFactory builderFactory,
                                 Callback<Class<?>,Object> controllerFactory,
                                 Charset charset)
                          throws IOException
        从FXML文档加载对象层次结构。
        参数类型
        T - 根对象的类型
        参数
        location - 用于解析相对路径属性值的位置
        resources - 用于解析资源密钥属性值的资源
        builderFactory - 加载文档时使用的构建器工厂
        controllerFactory - 加载文档时使用的控制器工厂
        charset - 加载文档时使用的字符集
        结果
        加载的对象层次结构
        异常
        IOException - 加载过程中是否发生错误
        从以下版本开始:
        JavaFX 2.1