javax.print

Класс ServiceUI

java.lang. Объект

javax.print. ServiceUI

public class ServiceUI
extends Object

Этот class является набором методов удобства UI, которые обеспечивают графическое пользовательское диалоговое окно для того, чтобы оно просмотрело службы печати, искавшие через API Службы печати Java.

Диалоговые окна следуют за стандартным образцом действия как продолжать/отменять опция для пользователя так же как разрешения пользователю выбрать службу печати, чтобы использовать и определить варианты, такие как формат бумаги и число копий.

Диалоговые окна разрабатываются, чтобы работать со сменными службами печати хотя общедоступные API тех служб печати.

Если служба печати обеспечивает какие-либо расширения поставщика, они могут быть сделаны доступными для пользователя через поставщика предоставленная панель Component вкладки. Такое расширение поставщика поощряется использовать Swing! и поддерживать его API доступности. Расширения поставщика должны возвратить настройки как часть AttributeSet. Приложения, которые хотят сохранить пользовательские настройки, должны использовать те настройки, чтобы определить задание печати. Отметьте, что на этот class не ссылается никакая другая часть Службы печати Java и не может быть включен в профили, которые не могут зависеть от присутствия пакетов AWT.

Сводка конструктора

Конструкторы

Конструктор и Описание
ServiceUI()

Сводка метода

Модификатор и Тип	Метод и Описание
static PrintService	printDialog(GraphicsConfiguration gc, int x, int y, PrintService[] services, PrintService defaultService, DocFlavor flavor, PrintRequestAttributeSet attributes) Представляет диалоговое окно пользователю для того, чтобы выбрать службу печати (принтер).

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

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, лениво полученным из ServiceUIFactory PrintService, когда PrintService просматривается. Диалоговое окно попытается определить местоположение MAIN_UIROLE сначала как JComponent, затем как Панель. Если не будет никакого ServiceUIFactory или никакой роли соответствия, то пользовательская вкладка будет пуста или не видима.

Диалоговое окно возвращает службу печати, выбранную пользователем, если пользовательский OK диалоговое окно и нуль, если пользователь отменяет диалоговое окно.

Приложение должно передать в массиве служб печати, чтобы просмотреть. Массив должен быть ненулем и непустой. Обычно приложение передаст в только PrintServices, способном к печати определенной разновидности документа.

Приложение может передать в PrintService, который будет первоначально выведен на экран. Ненулевой параметр должен быть включен в массив доступных для просмотра служб. Если этот параметр является нулем, служба выбирается реализацией.

Приложение может дополнительно передать в разновидности, которая будет напечатана. Если это - ненулевые варианты, представленные пользователю, может быть лучше проверен против поддерживаемых службами. Приложение должно передать в 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 - используемый, чтобы выбрать экран. нуль означает основной или экран значения по умолчанию.

x - расположение диалогового окна включая границу в экранных координатах

y - расположение диалогового окна включая границу в экранных координатах

services - чтобы быть доступным для просмотра, должен быть ненуль.

defaultService - начальный PrintService, чтобы вывести на экран.

flavor - разновидность, которая будет напечатана, или нуль.

attributes - на вводе начальное приложение предоставленное предпочтение. Это не может быть нулем, но может быть пусто. На выводе атрибуты отражают изменения, произведенные пользователем.

Возвраты:

служба печати, выбранная пользователем, или нулем, если пользователь, отмененный диалоговое окно.

Броски:

HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.

IllegalArgumentException - если службы являются нулем или пустой, или атрибуты нуль, или начальный PrintService не находится в списке доступных для просмотра служб.