Класс ServiceUI

public ServiceUI()

Создает ServiceUI.

public static PrintService printDialog(GraphicsConfiguration gc, int x, int y, PrintService[] services, PrintService defaultService, DocFlavor flavor, PrintRequestAttributeSet attributes) throws HeadlessException

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

Диалоговое окно может содержать панель вкладок с пользовательским интерфейсом, который лениво загружается из PrintService's ServiceUIFactory при просмотре PrintService. Сначала диалоговое окно попытается найти MAIN_UIROLE в роли JComponent, а затем в роли Panel. Если ServiceUIFactory отсутствует или подходящая роль не найдена, пользовательская вкладка будет пустой или не будет отображаться.

Если пользователь нажмет «ОК», диалоговое окно вернет выбранную им службу печати; если пользователь отменит действие, будет возвращено null.

Приложение должно передать массив служб печати для просмотра. Массив должен быть non-null и непустым. Обычно приложение передает только 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 ...
   }
}