Module  javafx.graphics
软件包  javafx.scene.text

Class Font



  • public final class Font
    extends Object

    Font类表示字体,用于在屏幕上呈现文本。

    Font的大小被描述为以大约1/72英寸的真实世界测量的点来指定。

    鉴于字体缩放与渲染变换为由的变换属性决定Node使用Font及其祖先,规模实际上是相对于局部坐标节点,应提供的空间坐标类似的尺寸来看,如果在节点的环境中不存在缩放变换。 请注意,默认坐标系指定的实际距离仅将点大小作为经验法则,通常默认为大多数显示器的屏幕像素。

    有关详细信息,请参阅Node有关默认坐标系的更多信息

    从以下版本开始:
    JavaFX 2.0
    • 构造方法摘要

      构造方法  
      Constructor 描述
      Font​(double size)
      使用默认面“System”构造一个字体。
      Font​(String name, double size)
      使用指定的正面名称和大小构造字体
    • 方法摘要

      所有方法  静态方法  接口方法  具体的方法 
      Modifier and Type 方法 描述
      boolean equals​(Object obj)
      指示一些其他对象是否等于此。
      static Font font​(double size)
      根据默认的字体系列名称和给定的字体大小搜索适当的字体。
      static Font font​(String family)
      根据给定的字体系列名称和默认字体大小搜索适当的字体。
      static Font font​(String family, double size)
      根据字体系列名称和大小搜索适当的字体。
      static Font font​(String family, FontPosture posture, double size)
      根据字体系列名称和姿势样式,搜索适合的字体。
      static Font font​(String family, FontWeight weight, double size)
      根据字体系列名称和体重样式搜索适当的字体。
      static Font font​(String family, FontWeight weight, FontPosture posture, double size)
      根据字体系列名称,体重和姿势样式搜索适当的字体。
      static Font getDefault​()
      获取将来自“系统”系列的默认字体,通常为“常规”样式,并且具有与用户桌面环境一致的大小,至可以确定的程度。
      static List<String> getFamilies​()
      获取用户系统上安装的所有字体,包括任何应用程序字体或SDK字体。
      String getFamily​()
      返回此字体的系列。
      static List<String> getFontNames​()
      获取用户系统上安装的所有字体的名称,包括任何应用程序字体和SDK字体。
      static List<String> getFontNames​(String family)
      获取用户系统上安装的指定字体系列中所有字体的名称,包括任何应用程序字体和SDK字体。
      String getName​()
      完整的字体名称。
      double getSize​()
      该字体的点大小。
      String getStyle​()
      描述字体系列中的样式的字体指定字符串。
      int hashCode​()
      返回此 Font对象的哈希码。
      static Font loadFont​(InputStream in, double size)
      从指定的输入流加载字体资源。
      static Font loadFont​(String urlStr, double size)
      从指定的URL加载字体资源。
      static Font[] loadFonts​(InputStream in, double size)
      从指定的输入流中加载字体资源。
      static Font[] loadFonts​(String urlStr, double size)
      从指定的URL加载字体资源。
      String toString​()
      将此 Font对象转换为 String表示。
    • 构造方法详细信息

      • Font

        public Font​(double size)
        使用默认面“System”构造一个字体。 使用的底层字体由基于当前UI环境的典型UI字体的实现来确定。
        参数
        size - 要使用的字体大小
      • Font

        public Font​(String name,
                    double size)
        使用指定的正面名称和大小构造字体
        参数
        name - 字体的全名。
        size - 要使用的字体大小
    • 方法详细信息

      • getDefault

        public static Font getDefault​()
        获取将来自“系统”系列的默认字体,通常为“常规”样式,并且具有与用户桌面环境一致的大小,至可以确定的程度。
        结果
        默认字体。
      • getFamilies

        public static List<String> getFamilies​()
        获取用户系统上安装的所有字体,包括任何应用程序字体或SDK字体。 此调用具有性能注意事项,因为查找所有字体可能是第一次昂贵的操作。
        结果
        该列表包含所有可用的字体系列。
      • getFontNames

        public static List<String> getFontNames​()
        获取用户系统上安装的所有字体的名称,包括任何应用程序字体和SDK字体。 此调用具有性能注意事项,因为查找所有字体可能是第一次昂贵的操作。
        结果
        该列表包含所有可用的字体。
      • getFontNames

        public static List<String> getFontNames​(String family)
        获取用户系统上安装的指定字体系列中所有字体的名称,包括任何应用程序字体和SDK字体。 此调用具有性能注意事项,因为查找所有字体可能是第一次昂贵的操作。
        参数
        family - 字体系列
        结果
        包含给定家庭字体的列表。
      • font

        public static Font font​(String family,
                                FontWeight weight,
                                FontPosture posture,
                                double size)
        根据字体系列名称,体重和姿势样式搜索适当的字体。 这种方法不能保证返回一个特定的字体,但是最好找到一个符合指定要求的字体。

        家庭的空值或空值允许实现选择任何合适的字体。

        参数
        family - 字体的家庭
        weight - 字体的重量
        posture - 字体的姿势或姿势
        size - 字体的点大小。 这可以是小数值,但不能为负数。 如果大小为<0,将使用默认大小。
        结果
        最符合规定要求的字体。
      • font

        public static Font font​(String family,
                                FontWeight weight,
                                double size)
        根据字体系列名称和体重样式搜索适当的字体。 这种方法不能保证返回一个特定的字体,但是最好找到一个符合指定要求的字体。 家庭的空值或空值允许实现选择任何合适的字体。
        参数
        family - 字体的家庭
        weight - 字体的重量
        size - 字体的点大小。 这可以是小数值,但不能为负数。 如果大小为<0,将使用默认大小。
        结果
        最符合规定要求的字体。
      • font

        public static Font font​(String family,
                                FontPosture posture,
                                double size)
        根据字体系列名称和姿势样式,搜索适合的字体。 这种方法不能保证返回一个特定的字体,但是最好找到一个符合指定要求的字体。 家庭的空值或空值允许实现选择任何合适的字体。
        参数
        family - 字体的家庭
        posture - 字体的姿势或姿势
        size - 字体的点大小。 这可以是小数值,但不能为负数。 如果大小为<0,将使用默认大小。
        结果
        最符合规定要求的字体。
      • font

        public static Font font​(String family,
                                double size)
        根据字体系列名称和大小搜索适当的字体。 这种方法不能保证返回一个特定的字体,但是最好找到一个符合指定要求的字体。 家庭的空值或空值允许实现选择任何合适的字体。
        参数
        family - 字体的家庭
        size - 字体的点大小。 这可以是小数值,但不能为负数。 如果大小为<0,将使用默认大小。
        结果
        最符合规定要求的字体。
      • font

        public static Font font​(String family)
        根据给定的字体系列名称和默认字体大小搜索适当的字体。 这种方法不能保证返回一个特定的字体,但是最好找到一个符合指定要求的字体。 家庭的空值或空值允许实现选择任何合适的字体。
        参数
        family - 字体的家庭
        结果
        最符合规定要求的字体。
      • font

        public static Font font​(double size)
        根据默认的字体系列名称和给定的字体大小搜索适当的字体。 这种方法不能保证返回一个特定的字体,但是最好找到一个符合指定要求的字体。
        参数
        size - 字体的点大小。 这可以是小数值,但不能为负数。 如果大小为<0,将使用默认大小。
        结果
        最符合规定要求的字体。
      • getName

        public final String getName​()
        完整的字体名称。 该名称包括该系列中的家族名称和风格变体。 例如,对于简单的Arial字体,这将是“Arial Regular”,而对于粗体Arial字体,这将是“Arial Bold”。 加载字体时要使用的精确名称在每个字体文件中被定义为完整的字体名称。 例如,“Proxima Nova ExtraCondensed Bold Italic”将指具体的Proxima Nova字体。 空或空名称允许实现选择任何合适的字体。

        通过Font.loadFont() ,JavaFX运行时交付的字体和系统安装的字体,可以通过单一的统一方式来加载所有应用程序,只需通过指定要加载的字体的全名来创建字体,如果不能找到特定的字体,则将使用后备或默认字体,“名称”将被更新以反映正在使用的字体的实际名称。可以通过使用您尝试加载的名称检查字体的名称来发现加载失败条件。

        请注意,如果您希望通过字体系列和样式找到字体,则可以使用此类中定义的font(java.lang.String, javafx.scene.text.FontWeight, javafx.scene.text.FontPosture, double)工厂方法之一。

        Default value:
        空字符串
        结果
        完整的字体名称
      • getFamily

        public final String getFamily​()
        返回此字体的系列。
        结果
        这个字体的家族。
      • getStyle

        public final String getStyle​()
        描述字体系列中的样式的字体指定字符串。
        结果
        此字体的样式名称。
      • getSize

        public final double getSize​()
        该字体的点大小。 这可能是一个小数值,如11.5 如果指定的值为<0,则将使用默认大小。
        Default value:
        12
        结果
        该字体的点大小
      • loadFont

        public static Font loadFont​(String urlStr,
                                    double size)
        从指定的URL加载字体资源。 如果加载成功,使得该位置是可读的,并且它表示支持的字体格式,那么将返回一个Font对象。

        如果存在安全管理员,应用程序必须同时具有从指定的URL位置读取的权限和FXPermission “loadFont”的权限 如果应用程序没有从指定的URL位置读取的权限,则返回null。 如果应用程序没有“loadFont”权限,那么该方法将返回具有指定字体大小的默认系统字体。

        任何失败,例如格式不正确的网址无法从资源中找到或读取,或者如果它不表示字体,将导致返回null 应用程序有责任在使用前进行检查。

        在成功(非空)返回时,字体将被注册到FX图形系统,以便通过可用的构造函数和工厂方法创建,并且应用程序应该以这种方式使用它,而不是再次调用此方法,这将重复开销下载并安装字体。

        字体size参数是一个方便,因此在典型的使用情况下,应用程序可以直接使用返回的(非空)字体,而不需要通过构造函数创建一个字体。 无效的大小是<= 0的大小,并将导致默认大小。

        如果URL表示本地磁盘文件,则不执行任何复制,并且字体文件需要在应用程序的生命周期中持续存在。 以任何方式更新文件将导致未指定和可能的不良行为。

        参数
        urlStr - 从中加载字体,指定为字符串。
        size - 返回的字体。
        结果
        字体,如果无法创建字体,则为null。
      • loadFonts

        public static Font[] loadFonts​(String urlStr,
                                       double size)
        从指定的URL加载字体资源。 如果加载成功,使得位置可读,并且它表示支持的字体格式,则将返回Font的数组。

        此方法的用例是从TrueType集合(TTC)加载所有字体。

        如果存在安全管理员,应用程序必须同时具有从指定的URL位置读取的权限和FXPermission “loadFont”的权限 如果应用程序没有从指定的URL位置读取的权限,则返回null。 如果应用程序没有“loadFont”权限,那么此方法将返回一个元素的数组,该元素是具有指定字体大小的默认系统字体。

        任何失败,例如格式不正确的网址无法找到资源或从资源中读取,或者如果它不表示字体,将导致一个null返回。 应用程序有责任在使用前进行检查。

        在成功(非空)返回时,字体将被注册到FX图形系统,以便通过可用的构造函数和工厂方法创建,并且应用程序应该以这种方式使用它,而不是再次调用此方法,这将重复开销下载并安装字体。

        字体size参数是方便的,因此在典型的使用情况下,应用程序可以直接使用返回(非空)字体,而不需要通过构造函数创建一个字体。 无效的大小是<= 0的大小,并将导致默认大小。

        如果URL表示本地磁盘文件,则不执行任何复制,并且字体文件需要在应用程序的生命周期中持续存在。 以任何方式更新文件将导致未指定和可能的不良行为。

        参数
        urlStr - 从中加载字体,指定为字符串。
        size - 返回的字体。
        结果
        字体数组,如果无法创建字体,则为null。
        从以下版本开始:
        9
      • loadFont

        public static Font loadFont​(InputStream in,
                                    double size)
        从指定的输入流加载字体资源。 如果加载成功,使流可以完全读取,并且它表示支持的字体格式,则将返回一个Font对象。

        如果存在安全管理员,应用程序必须具有“ loadFontFXPermission 如果应用程序没有权限,则该方法将返回具有指定字体大小的默认系统字体。

        任何失败(如缩写输入)或不支持的字体格式都会导致返回null 应用程序有责任在使用前进行检查。

        在成功(非空)返回时,字体将被注册到FX图形系统,以便通过可用的构造函数和工厂方法创建,并且应用程序应该以这种方式使用它,而不是再次调用此方法,这将重复开销重新阅读和安装字体。

        字体size参数是方便的,因此在典型的使用情况下,应用程序可以直接使用返回(非空)字体,而不需要通过构造函数创建一个字体。 无效的大小是<= 0的大小,并将导致默认大小。

        此方法不关闭输入流。

        参数
        in - 加载字体的流。
        size - 返回的字体。
        结果
        字体,如果无法创建字体,则为null。
      • loadFonts

        public static Font[] loadFonts​(InputStream in,
                                       double size)
        从指定的输入流中加载字体资源。 如果加载成功,使流可以完全读取,并且它代表支持的字体格式,那么将返回一个Font的数组。

        此方法的用例是从TrueType集合(TTC)加载所有字体。

        如果存在安全管理员,应用程序必须具有“ loadFontFXPermission 如果应用程序没有权限,则该方法将返回具有指定字体大小的默认系统字体。

        任何失败(如缩写输入)或不支持的字体格式都将导致返回null 应用程序有责任在使用前进行检查。

        在成功(非空)返回时,字体将被注册到FX图形系统,以便通过可用的构造函数和工厂方法创建,并且应用程序应该以这种方式使用它,而不是再次调用此方法,这将重复开销重新阅读和安装字体。

        字体size参数是一个方便,因此在典型的使用情况下,应用程序可以直接使用返回(非空)字体,而不需要通过构造函数重新创建。 无效的大小是<= 0的大小,并将导致默认大小。

        此方法不关闭输入流。

        参数
        in - 加载字体的流。
        size - 返回的字体。
        结果
        字体数组,如果无法创建字体,则为null。
        从以下版本开始:
        9
      • toString

        public String toString​()
        将此Font对象转换为String表示形式。 字符串表示仅供参考,并将更改。 不要将此字符串表示用于任何程序目的。
        重写:
        toStringObject
        结果
        对象的字符串表示形式。
      • equals

        public boolean equals​(Object obj)
        指示一些其他对象是否等于此。
        重写:
        equalsObject
        参数
        obj - 与之比较的参考对象。
        结果
        true如果此对象等于obj参数; 否则为false
        另请参见:
        Object.hashCode()HashMap