javax.print
클래스 ServiceUI

java.lang.Object 
  javax.print.ServiceUI

public class ServiceUI
extends Object 

이 클래스는 Java Print Service API를 개입시켜 룩 업 된 인쇄 서비스 열람용의 그래피컬한 사용자 다이얼로그를 제공하는 편리성의 높은 UI 메서드의 컬렉션입니다.

다이얼로그는 표준 패턴에 준거해, 사용자에 대해서 「계속」이나 「취소」옵션을 제공합니다. 또, 사용자는 이 다이얼로그를 사용해 인쇄 서비스를 선택해, 용지 사이즈나 카피 부수등을 지정할 수 있습니다.

다이얼로그는 이러한 인쇄 서비스의 public API를 개입시켜, 플러그 인 가능한 인쇄 서비스와 협조 동작하도록 설계되고 있습니다.

인쇄 서비스가 어떤 것인가의 벤더 확장 기능을 제공하는 경우, 이러한 기능에는 벤더의 제공하는 탭 패널 Component를 사용해 액세스 가능하게 됩니다. 이러한 벤더 확장 기능에서는 Swing! 사용 및 Accessibility API 지원가 추천 되고 있습니다. 벤더 확장 기능은 설정을 AttributeSet 일부로서 돌려줄 필요가 있습니다. 사용자 설정을 보의존된 어플리케이션은 이러한 설정을 사용해 인쇄 작업을 지정할 필요가 있습니다. 이 클래스가 Java Print Service 외의 부분으로부터 참조될 것은 없습니다. 또, AWT 패키지의 존재에 존하지 않는 프로파일에 이 클래스를 포함할 수 없습니다.

생성자 개요

ServiceUI ()

메서드 개요

static PrintService

printDialog (GraphicsConfiguration gc, int x, int y, PrintService [] services, PrintService defaultService, DocFlavor flavor, PrintRequestAttributeSet attributes) 인쇄 서비스 (프린터) 선택용 다이얼로그를 사용자에 게 제공합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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 

인쇄 서비스 (프린터) 선택용 다이얼로그를 사용자에 게 제공합니다. 이것은 어플리케이션에 의해 지정된 위치에 표시되는 모덜인 다이얼로그입니다. 사양이 무효인지, 사양에 의해 다이얼로그가 비표시로 설정되었을 경우, 구현에 의해 지정된 위치에 표시됩니다. 다이얼로그는 호출 thread를 블록 해, 어플리케이션 모덜이 됩니다.

다이얼로그에는 PrintService 브라우즈시에 PrintService ServiceUIFactory 로부터 늦어 취득된 커스텀 UI를 보관 유지하는 탭 패널을 포함할 수 있습니다 . 다이얼로그는 MAIN_UIROLE 검출을 최초로 JComponent 로서 다음에 Panel 로서 시도합니다. ServiceUIFactory가 존재하지 않는지, 일치하는 롤이 존재하지 않는 경우, 커스텀 탭은 비어있거나 또는 비표시가 됩니다.

다이얼로그로 「OK」를 선택하면, 사용자가 선택한 인쇄 서비스가 리턴됩니다 . 다이얼로그로 「취소」를 선택하면, null이 리턴됩니다 .

어플리케이션은 브라우즈 하는 인쇄 서비스의 배열을 건네줄 필요가 있습니다. 배열은 null 또는 공백 이외일 필요가 있습니다. 보통, 어플리케이션은 특정의 다큐먼트 플레이버 의 인쇄 기능을 가지는 PrintService 만을 건네줍니다.

어플리케이션은 최초로 표시하는 PrintService를 건네줄 수가 있습니다. null이 아닌 파라미터를, 브라우즈 가능한 서비스의 배열에 포함할 필요가 있습니다. 이 파라미터가 null인 경우, 서비스가 구현에 의해 선택됩니다.

어플리케이션은 인쇄하는 플레이버를 옵션으로 건네줄 수도 있습니다. 이것이 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 - 화면 좌표내의 경계를 포함한 다이얼로그의 위치

y - 화면 좌표내의 경계를 포함한 다이얼로그의 위치

services - 브라우즈 가능하기 때문에는 null 이외가 아니면 안되는

defaultService - 최초로 표시하는 PrintService

flavor - 인쇄하는 플레이버, 또는 null

attributes - 입력시는 초기 어플리케이션의 제공하는 설정. 이것은 null 여서는 안 되지만, 공백은 허가된다. 출력시는 사용자에 한 변경을 속성에 반영된다

반환값:

사용자 의 선택한 인쇄 서비스, 또는 사용자가 다이얼로그를 취소했을 경우는 null

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true를 돌려주는 경우

IllegalArgumentException - 서비스가 null 또는 비어있는 경우, 속성이 null인 경우, 또는 초기 PrintService가 브라우즈 가능한 서비스의 리스트에 존재하지 않는 경우