模块  java.desktop
软件包  javax.print

Class ServiceUI

  • public class ServiceUI
extends Object
    此类是UI便捷方法的集合，它提供了一个图形用户对话框，用于浏览通过Java Print Service API查找的打印服务。

    对话框遵循标准模式，充当用户的继续/取消选项，并允许用户选择要使用的打印服务并指定选项，如纸张大小和份数。

    这些对话框旨在通过这些打印服务的公共API与可插拔打印服务一起使用。

    如果打印服务提供任何供应商扩展，则可以通过供应商提供的选项卡面板Component使用户可以访问这些扩展。 鼓励这样的供应商扩展使用Swing！ 并支持其辅助功能API。 供应商扩展应将设置作为AttributeSet一部分返回。 想要保留用户设置的应用程序应使用这些设置来指定打印作业。 请注意，此类未被Java Print Service的任何其他部分引用，并且可能不包含在不依赖于AWT包的存在的配置文件中。

    • 构造方法详细信息

      • ServiceUI

        public ServiceUI()

    • 方法详细信息

      • printDialog

        public static PrintService printDialog​(GraphicsConfiguration gc,
                                       int x,
                                       int y,
                                       PrintService[] services,
                                       PrintService defaultService,
                                       DocFlavor flavor,
                                       PrintRequestAttributeSet attributes)
                                throws HeadlessException
        向用户显示用于选择打印服务（打印机）的对话框。 它显示在应用程序指定的位置，并且是模态的。 如果规范无效或者使对话框不可见，它将显示在由实现确定的位置。 该对话框阻止其调用线程，并且是应用程序模式。

        对话框可以包括与从所述懒惰地获得定制UI一个标签面板PrintService的ServiceUIFactory当PrintService浏览。 该对话框将首先尝试将MAIN_UIROLE定位为JComponent ，然后定位为Panel 。 如果没有ServiceUIFactory或没有匹配的角色，则自定义选项卡将为空或不可见。

        如果用户确定对话框，则对话框返回用户选择的打印服务null如果用户取消对话框，则null 。

        应用程序必须传入一组打印服务才能浏览。 该数组必须为non-null且非空。 通常，应用程序将仅PrintServices能够打印特定文档风格的PrintServices 。

        应用程序可以传入PrintService以进行初始显示。 non-null参数必须包含在可浏览服务数组中。 如果此参数为null ，则实现选择服务。

        应用程序可以任选地传递要打印的香料。 如果这是non-null ，则可以更好地验证向用户提供的选项与服务支持的选项。 应用程序必须传入PrintRequestAttributeSet以返回用户选择。 在调用PrintRequestAttributeSet可能为空，或者可能包含应用程序指定的值。

        这些用于设置最初显示的打印服务的初始设置。 打印服务不支持的值将被忽略。 当用户浏览打印服务时，属性和值将复制到新显示中。 如果用户浏览不支持特定属性值的打印服务，则该服务的默认值将用作要复制的新值。

        如果用户取消对话框，则返回的属性不会反映用户所做的任何更改。

        此方法的典型基本用法可能是： 

           PrintService[] services = PrintServiceLookup.lookupPrintServices( DocFlavor.INPUT_STREAM.JPEG, null); PrintRequestAttributeSet attributes = new HashPrintRequestAttributeSet(); if (services.length > 0) { PrintService service = ServiceUI.printDialog(null, 50, 50, services, services[0], null, attributes); if (service != null) { ... print ... } }
        参数
        gc - 用于选择屏幕， null表示主屏幕或默认屏幕
        x - 对话框的位置，包括相对于 gc原点的屏幕坐标中的 gc
        y - 对话框的位置，包括相对于 gc原点的屏幕坐标中的 gc
        服务 - 要可浏览，必须是 non-null
        defaultService - 要显示的初始值 PrintService
        flavor - 要打印的风味，或 null
        attributes - on input是初始应用程序提供的首选项。 这不能是null但可能是空的。 在输出时，属性反映用户所做的更改。
        结果
        用户选择的打印服务，如果用户取消了对话框，则输入 null
        异常
        HeadlessException - 如果 GraphicsEnvironment.isHeadless()返回 true
        IllegalArgumentException - if services is null or empty, or attributes is null, or the initial PrintService is not in the list of browsable services