Module  javafx.graphics
软件包  javafx.print

Class Printer


  • public final class Printer
extends Object
    打印机实例表示打印作业的目的地。

    打印机可能被枚举并选择用于打印作业。

    打印机默认设置的配置然后用于填充作业的初始设置。

    由于在执行程序期间打印机的可用性可能由于管理动作而改变，所以长时间运行的程序已经缓存已经脱机的打印机，可以使用该实例创建一个作业，但是打印将失败。

    从以下版本开始：
    JavaFX 8.0

    • 方法详细信息

      • getAllPrinters

        public static ObservableSet<Printer> getAllPrinters​()
        检索已安装的打印机。 该组打印机可能是动态的。 因此，不能保证结果在调用到调用时是相同的，而是应该仅在应用程序环境中的默认更改的情况下进行更改。

        注意：由于打印机可能已安装，而是离线，则应用程序可能希望在使用打印机之前查询打印机的状态。

        结果
        如果没有打印机，可能为null。
        异常
        SecurityException - 如果应用程序没有浏览打印机的权限。

      • defaultPrinterProperty

        public static ReadOnlyObjectProperty<Printer> defaultPrinterProperty​()
        表示当前默认打印机的只读对象属性。 如果没有安装的打印机，包装的值将为空。
        另请参见：
        getDefaultPrinter()

      • getDefaultPrinter

        public static Printer getDefaultPrinter​()
        检索默认打印机。 如果没有安装打印机，可能返回null。

        可用打印机的配置可能是动态的。 因此，不能保证结果在调用到调用时是相同的，而是应该仅在应用程序环境中的默认更改的情况下进行更改。

        结果
        默认打印机或null。
        异常
        SecurityException - 如果应用程序没有浏览打印机的权限。

      • getName

        public String getName​()
        返回基础系统使用的名称，以便向用户和/或应用程序标识打印机。
        结果
        打印机名称。

      • getPrinterAttributes

        public PrinterAttributes getPrinterAttributes​()
        检索封装打印机属性和功能的委托对象。
        结果
        打印机属性。

      • getDefaultPageLayout

        public PageLayout getDefaultPageLayout​()
        返回此打印机的默认页面布局。
        结果
        默认页面布局。

      • createPageLayout

        public PageLayout createPageLayout​(Paper paper,
                                   PageOrientation orient,
                                   Printer.MarginType mType)
        使用指定的参数获取此打印机的新PageLayout实例。 论文应该是受支持的论文之一，而且方向应该是一个支持的方向。 如果打印机不能按照指定的方式支持布局，则会将返回的布局调整为受支持的配置
        参数
        paper - 使用的纸
        orient - 使用的方向
        mType - 要使用的保证金类型
        结果
        PageLayout基于指定的参数。
        异常
        NullPointerException - 如果任何参数为空。

      • createPageLayout

        public PageLayout createPageLayout​(Paper paper,
                                   PageOrientation orient,
                                   double lMargin,
                                   double rMargin,
                                   double tMargin,
                                   double bMargin)
        使用指定的参数获取此打印机的新PageLayout。 论文应该是受支持的论文之一，而且方向应该是一个支持的方向。

        边距值以1/72英寸为单位。 边距将根据打印机支持的边距进行验证，并在必要时进行调整。 这种方法对于希望与默认边距不同（例如更宽）的边距的客户端通常是有用的，例如左上角和右边的顶部和底部为“1”。

        需要知道什么边际值合法的客户应首先使用HARDWARE_MINIMUM利润来获取PageLayout。

        如果打印机不能按照指定的方式支持布局，则会将返回的布局调整为受支持的配置

        参数
        paper - 使用的纸张
        orient - 使用的方向
        lMargin - 左边距用于pts。
        rMargin - 在pts中使用的正确保证金。
        tMargin - 在pts中使用的 tMargin 。
        bMargin - 在pts中使用的底部边距。
        结果
        PageLayout基于指定的参数。
        异常
        NullPointerException - 如果纸或东方为空。
        IllegalArgumentException - 如果任何边距值小于零。

      • toString

        public String toString​()
        描述从类别复制： Object
        返回对象的字符串表示形式。 一般来说， toString方法返回一个字符串，“文本地表示”这个对象。 结果应该是一个简明扼要的表达，容易让人阅读。 建议所有子类覆盖此方法。

        该toString类方法Object返回一个由类的名称，其中所述对象是其实例，该符号字符`的字符串@ ”，并且对象的哈希码的无符号的十六进制表示。 换句话说，这个方法返回一个等于下列值的字符串： 

         getClass().getName() + '@' + Integer.toHexString(hashCode())
        重写：
        toString在 Object
        结果
        a string representation of the object.