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 가 존재하지 않는지, 일치하는 롤이 존재하지 않는 경우, 커스텀 탭은 빈 상태(empty) 또는 비표시가 됩니다.

다이얼로그로 「OK」를 선택하면(자), 사용자가 선택한 인쇄 서비스가 돌려주어집니다. 다이얼로그로 「취소」를 선택하면(자), null 가 돌려주어집니다.

어플리케이션은, 브라우즈 하는 인쇄 서비스의 배열을 건네줄 필요가 있습니다. 배열은 null 또는 빈 상태(empty) 이외일 필요가 있습니다. 일반적으로, 어플리케이션은, 특정의 드큐먼트후레이바의 인쇄 기능을 가지는 PrintService 만을 건네줍니다.

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

어플리케이션은, 인쇄하는 후레이바를 옵션으로 건네줄 수도 있습니다. 이것이 null 가 아닌 경우, 사용자에게 제시되는 선택사항은, 서비스가 지원하는 선택사항보다 상세한 검증이 가능하게 됩니다. 어플리케이션은, 사용자의 선택사항을 돌려주기 위해서(때문에) PrintRequestAttributeSet 를 건네줄 필요가 있습니다. PrintRequestAttributeSet 의 호출에는, 빈 상태(empty)의 경우와 어플리케이션 지정의 값이 포함되는 경우가 있습니다.

이것들은, 최초로 표시되는 인쇄 서비스의 초기설정에 사용됩니다. 인쇄 서비스가 지원하지 않는 값은 무시됩니다. 사용자가 인쇄 서비스를 브라우즈 하는 경우, 속성 및 값은 신규 표시에 카피됩니다. 특정의 속성치를 지원하지 않는 인쇄 서비스를 사용자가 브라우즈 하는 경우, 카피되는 신규치로서 그 서비스의 디폴트가 사용됩니다.

사용자가 다이얼로그를 취소하면(자), 반환되는 속성은, 사용자에 의한 변경을 일절 반영하지 않습니다. 이 메소드의 일반적이고 기본적인 사용 방법을, 다음에 나타냅니다.

 PrintService[] services = PrintServiceLookup.lookupPrintServices(
                            DocFlavor.INPUT_STREAM.JPEG, null);
 PrintRequestAttributeSet aset = new HashPrintRequestHashAttributeSet();
 if (services.length > 0) {
    PrintService service =  ServiceUI.printDialog(null, 50, 50,
                                               services, services[0],
                                               null
                                               attributes);
    if (service ! = null) {
     ... print ...
    }
 }
 

파라미터:

gc - 스크린의 선택에 사용한다. null 는, primary 또는 디폴트 스크린을 의미하는

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

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

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

defaultService - - 최초로 표시하는 PrintService

flavor - - 인쇄하는 후레이바, 또는 null

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

반환값:

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

예외:

HeadlessException - GraphicsEnvironment.isHeadless()의 경우 하지만 true 를 돌려주는 경우

IllegalArgumentException - 서비스가 null 또는 빈 상태(empty)의 경우, 속성이 null 의 경우, 또는 초기 PrintService 가 브라우즈 가능한 서비스의 리스트에 존재하지 않는 경우