패키지 javax.print.attribute.standard

이 패키지에는 지정된 인쇄 속성의 클래스가 포함되어 있습니다.

참조:
설명

클래스의 개요

Chromaticity	Chromaticity 클래스는 흑백 또는 칼라 프린트를 지정하는 열거형의 인쇄 속성 클래스입니다.
ColorSupported	ColorSupported 클래스는 디바이스가 풀 프로세스 칼라와 하이라이트 칼라를 포함한, 모든 종류의 칼라 프린트가 가능한가 어떤가를 식별하는 열거형의 인쇄 속성 클래스입니다.
Compression	Compression 클래스는 인쇄 데이터의 압축 방법을 지정하는 열거형의 인쇄 속성 클래스입니다.
Copies	Copies 클래스는 인쇄하는 부수를 지정하는 정수형의 값의 인쇄 속성 클래스입니다.
CopiesSupported	CopiesSupported 클래스는 Copies 속성에 대해서 서포트하는 값을 지정하는 정수형 세트의 인쇄 속성 클래스입니다.
DateTimeAtCompleted	DateTimeAtCompleted 클래스는 Print Job 가 완료했는지 또는 취소해, 중단된 일자와 시각을 표시하는 일자와 시각 속성의 인쇄 속성 클래스입니다.
DateTimeAtCreation	DateTimeAtCreation 클래스는 Print Job 가 생성된 일자와 시각을 표시하는 일자와 시각 속성의 인쇄 속성 클래스입니다.
DateTimeAtProcessing	DateTimeAtProcessing 클래스는 Print Job 가 최초로 처리를 개시한 일자와 시각을 표시하는 일자와 시각 속성의 인쇄 속성 클래스입니다.
Destination	Destination 클래스는 spool 된 프린터 형식의 데이터의 대체 출력처를 나타내기 위해서(때문에) 사용하는 URI 인쇄 속성 클래스입니다.
DocumentName	DocumentName 클래스는 문서의 이름을 지정하는 텍스트 속성의 인쇄 속성 클래스입니다.
Fidelity	Fidelity 클래스는 인쇄 요구 속성을 지정하는 클라이언트에 대해서 완전한 충실도가 필요한가 어떤가를 나타내는 열거형의 인쇄 속성 클래스입니다.
Finishings	Finishings 클래스는 프린터가 어떠한 장정을 실시하는 종료 조작을, 작업의 인쇄 문서의 카피 마다 적용할지 어떨지를 나타내는 열거형의 인쇄 속성 클래스입니다.
JobHoldUntil	JobHoldUntil 클래스는 작업이 인쇄의 후보가 되는 정확한 일자와 시각을 지정하는 일자와 시각 속성의 인쇄 속성 클래스입니다.
JobImpressions	JobImpressions 클래스는 송신되는 문서의 인쇄 데이터의 수의 합계수를 지정하는 정수형의 값의 인쇄 속성 클래스입니다.
JobImpressionsCompleted	JobImpressionsCompleted 클래스는 지금까지 작업이 완료한 인쇄 데이터의 수를 지정하는 정수형의 값의 인쇄 속성 클래스입니다.
JobImpressionsSupported	JobImpressionsSupported 클래스는 JobImpressions 속성을 서포트하는 값을 지정하는 정수형 세트의 인쇄 속성 클래스입니다.
JobKOctets	JobKOctets 클래스는 K 8중창단위, 즉 작업의 처리로 요구되는 1024 8중창단위로, 문서의 합계 사이즈를 지정하는 정수형의 값의 인쇄 속성 클래스입니다.
JobKOctetsProcessed	JobKOctetsProcessed 클래스는 K 8중창단위, 즉 1024 8중창단위로, 지금까지 처리된 인쇄 데이터의 합계 8중창수를 지정하는 정수형의 값의 인쇄 속성 클래스입니다.
JobKOctetsSupported	JobKOctetsSupported 클래스는 JobKOctets 속성을 서포트하는 값을 지정하는 정수형 세트의 인쇄 속성 클래스입니다.
JobMediaSheets	JobMediaSheets 클래스는 이 작업을 위해서(때문에) 생성되는 미디어 시트의 합계수를 지정하는 정수형의 값의 인쇄 속성 클래스입니다.
JobMediaSheetsCompleted	JobMediaSheetsCompleted 클래스는 이러한 시트가 한 면 또는 양면에 처리되고 있는 없는에 관계없이, 지금까지 모든 작업에 대해서 마킹과 스탁킹을 완료한 미디어 시트의 수를 지정하는 정수형의 값의 인쇄 속성 클래스입니다.
JobMediaSheetsSupported	JobMediaSheetsSupported 클래스는 JobMediaSheets 속성을 서포트하는 값을 지정하는 정수형 세트의 인쇄 속성 클래스입니다.
JobMessageFromOperator	JobMessageFromOperator 클래스는 오퍼레이터, 시스템 관리 책임자, 또는 최종 사용자로 변경 이유 또는 작업에 대해서 빼앗긴 그 외의 관리 액션을 나타내는 「인텔리전트」프로세스로부터의 메세지를 제공하는 텍스트 속성의 인쇄 속성 클래스입니다.
JobName	JobName 클래스는 인쇄 작업의 이름을 지정하는 텍스트 속성의 인쇄 속성 클래스입니다.
JobOriginatingUserName	JobOriginatingUserName 는 인쇄 작업을 개시한 최종 사용자명을 저장하는 텍스트 속성의 인쇄 속성 클래스입니다.
JobPriority	JobPriority 는 인쇄 작업의 우선 순위를 지정하는 정수치의 인쇄 속성 클래스입니다.
JobPrioritySupported	JobPrioritySupported 는 인쇄 서비스 인스턴스가 JobPriority 속성을 서포트하고 있을지 어떨지를 지정해, 서포트되고 있는 인쇄 순위 레벨수를 지정하는 정수치의 인쇄 속성 클래스입니다.
JobSheets	JobSheets 는 작업의 개시시와 종료시에 인쇄하는 시트가 있는 경우에, 그 중의 어떤 것을 사용하는지를 열거해 결정하는 인쇄 속성 클래스입니다.
JobState	JobState 는 인쇄 작업의 현재 상태를 식별해 열거하는 인쇄 속성 클래스입니다.
JobStateReason	JobStateReason 는 작업의 현재 상태에 대한 추가 정보, 즉 작업의 JobState 속성을 보다 알기 쉽게 하는 정보를 값의 열거로서 제공하는 인쇄 속성 클래스입니다.
JobStateReasons	JobStateReasons 는 작업의 현재 상태에 대한 추가 정보, 즉 작업의 JobState 속성을 보다 알기 쉽게 하는 정보를, 값세트로서 열거하는 인쇄 속성 클래스입니다.
Media	Media 는 인쇄하는 매체를 지정하는 인쇄 속성 클래스입니다.
MediaName	MediaName 클래스는 Media 의 서브 클래스이며, 인쇄 작업으로 사용하는 매체명을 열거해 지정하는 인쇄 속성 클래스입니다.
MediaPrintableArea	MediaPrintableArea 는 매체의 인쇄 가능 area와 인쇄 불가능 area를 구별하는 인쇄 속성입니다.
MediaSize	MediaSize 는 타테나가에 두었을 경우의 매체의 치수를 이차원의 사이즈치로서 가리키는 인쇄 속성 클래스입니다.
MediaSize.Engineering	MediaSize.Engineering 클래스에는 기술 규격 매체의 MediaSize 치가 저장되고 있습니다.
MediaSize.ISO	MediaSize.ISO 클래스에는 ISO 매체의 MediaSize 치가 저장되고 있습니다.
MediaSize.JIS	MediaSize.
MediaSize.NA	MediaSize.NA 클래스에는 북미 규격 매체의 MediaSize 치가 저장되고 있습니다.
MediaSize.Other	MediaSize.Other 클래스에는 그 외의 매체의 MediaSize 치가 저장되고 있습니다.
MediaSizeName	MediaSizeName 클래스는 Media 의 서브 클래스입니다.
MediaTray	MediaTray 클래스는 Media 클래스의 서브 클래스이며, 작업으로 사용하는 페이퍼 트래이를 열거해 지정하는 인쇄 속성 클래스입니다.
MultipleDocumentHandling	MultipleDocumentHandling 는 종료 조작, 및 1 kr 이상의 출력 스트림 페이지의 인쇄 데이터와 용지상에서의 배치 방법을 제어하는 값을 열거해 가리키는 인쇄 속성 클래스입니다.
NumberOfDocuments	NumberOfDocuments 는 프린터가 이 작업에 대해서 수신한 문서의 수를 나타내는 정수치의 인쇄 속성 클래스입니다.
NumberOfInterveningJobs	NumberOfInterveningJobs 는 완료 예정 시간의 승순, 즉 현재 스케줄 되고 있는 순서로 작업을 늘어놓았을 경우에, 이 작업의 전에 있는 작업의 수를 정수치로 가리키는 인쇄 속성 클래스입니다.
NumberUp	NumberUp 는 선택된 매체의 한 면에 인쇄하는 출력 스트림의 페이지수를 정수로 나타내는 인쇄 속성 클래스입니다.
NumberUpSupported	NumberUpSupported 는 NumberUp 속성에 대해서 서포트되는 값을 정수치세트로 가리키는 인쇄 속성 클래스입니다.
OrientationRequested	OrientationRequested 는 인쇄되는 출력 스트림 페이지의 방향을 값의 열거로 가리키는 인쇄 속성 클래스입니다.
OutputDeviceAssigned	OutputDeviceAssigned 는 서비스가 이 작업을 할당한 출력 디바이스를 식별하는 텍스트 속성의 인쇄 속성 클래스입니다.
PageRanges	PageRanges 는 프린터 오브젝트가 인쇄하는 각 문서에 사용하는 출력 스트림의 범위를 정수치세트로 나타내는 인쇄 속성 클래스입니다.
PagesPerMinute	PagesPerMinute 는 이 프린터 (예를 들어 simplex 흑백 프린터)가 1 분간에 생성할 수 있는 페이지수를 가장 가까운 정수치로 나타내는 인쇄 속성 클래스입니다.
PagesPerMinuteColor	PagesPerMinuteColor 는 이 프린터 (예를 들어 simplex 칼라 프린터)가 1 분간에 생성할 수 있는 칼라 페이지수를 가장 가까운 정수치로 나타내는 인쇄 속성 클래스입니다.
PDLOverrideSupported	PDLOverrideSupported 는 문서의 인쇄 데이터에 짜넣어진 처리 인스트럭션을, 인쇄 데이터외로부터 속성으로서 지정된 처리 인스트럭션으로 오버라이드(override) 할 수 있을지 어떨지를 열거해 가리키는 인쇄 속성 클래스입니다.
PresentationDirection	PresentationDirection 는 NumberUp 속성과 함께 사용되어 복수의 출력 스트림 페이지가 선택된 매체의 한 면에 정리해 인쇄하는 경우의 레이아웃을 열거해 가리키는 인쇄 속성 클래스입니다.
PrinterInfo	PrinterInfo 는 프린터에 관한 설명적인 정보를 제공하는 텍스트 속성의 인쇄 속성 클래스입니다.
PrinterIsAcceptingJobs	PrinterIsAcceptingJobs 는 프린터가 현재 작업을 받아들이고 가능한가 어떤가를 값의 열거로 가리키는 인쇄 속성 클래스입니다.
PrinterLocation	PrinterLocation 는 디바이스가 놓여져 있는 장소를 식별하는 텍스트 속성의 인쇄 속성 클래스입니다.
PrinterMakeAndModel	PrinterMakeAndModel 는 프린터의 메이커와 모델에 대한 정보를 제공하는 텍스트 속성의 인쇄 속성 클래스입니다.
PrinterMessageFromOperator	PrinterMessageFromOperator 는 오퍼레이터, 시스템 관리 책임자, 또는 인텔리전트 프로세스로부터 최종 사용자에게 건네지는 프린터 자체 또는 그 스테이터스에 대한 정보 메세지를 제공하는 텍스트 속성의 인쇄 속성 클래스입니다.
PrinterMoreInfo	PrinterMoreInfo 는 이 프린터 고유의 추가 정보를 취득하기 위해서 사용되는 URI 의 인쇄 속성 클래스입니다.
PrinterMoreInfoManufacturer	PrinterMoreInfoManufacturer 는 이 형태의 디바이스에 대한 추가 정보를 취득하기 위해서 사용하는 URI 의 인쇄 속성 클래스입니다.
PrinterName	PrinterName 는 프린터명을 지정하는 텍스트 속성의 인쇄 속성 클래스입니다.
PrinterResolution	PrinterResolution 는 프린터가 서포트하고 있는지 또는 인쇄 작업이 사용하는 정확한 해상도를 지정하는 인쇄 속성 클래스입니다.
PrinterState	PrinterState 는 프린터의 현재 상태를 식별해 열거하는 인쇄 속성 클래스입니다.
PrinterStateReason	PrinterStateReason 는 프린터의 현재 상태에 대한 추가 정보, 즉 프린터의 PrinterState 속성을 보다 알기 쉽게 하는 정보를, 값의 열거로서 제공하는 인쇄 속성 클래스입니다.
PrinterStateReasons	PrinterStateReasons 는 프린터의 현재 상태에 대한 추가 정보, 즉 프린터의 PrinterState 속성을 보다 알기 쉽게 하는 정보를, 값세트로서 열거하는 인쇄 속성 클래스입니다.
PrinterURI	PrinterURI 는 프린터의 포괄적으로 일의인 이름을 나타내는 URI 의 인쇄 속성 클래스입니다.
PrintQuality	PrintQuality 는 프린터가 작업에 대해서 사용하는 인쇄 품질을 열거해 지정하는 인쇄 속성 클래스입니다.
QueuedJobCount	QueuedJobCount 는 JobState 가 PENDING, PENDING_HELD, PROCESSING, 또는 PROCESSING_STOPPED 의 어떤 것인가인 프린터의 작업수를 정수치로 가리키는 인쇄 속성 클래스입니다.
ReferenceUriSchemesSupported	ReferenceUriSchemesSupported 는 URI 상의 인쇄 데이터 취득에 프린터를 사용할 수 있는 「http:」나 「ftp:」등의 URI schema를 열거해 가리키는 인쇄 속성 클래스입니다.
RequestingUserName	RequestingUserName 는 인쇄 작업을 송신한 최종 사용자명을 지정하는 텍스트 속성의 인쇄 속성 클래스입니다.
Severity	Severity 는 PrinterStateReason 속성의 중요도를 값의 열거로 가리키는 인쇄 속성 클래스입니다.
SheetCollate	SheetCollate 는 문서를 2 부 이상 인쇄하는 것이 Copies 속성으로 지정되고 있는 경우, 그 작업의 인쇄 문서를 부 단위로 인쇄할지 어떨지를 열거해 지정하는 인쇄 속성 클래스입니다.
Sides	Sides 는 선택된 매체의 각면에의, 출력 스트림 페이지의 배치 방법, 즉 인쇄 데이터의 생성 방법을 값의 열거로 지정하는 인쇄 속성 클래스입니다.

패키지 javax.print.attribute.standard 의 설명

이 패키지에는 지정된 인쇄 속성의 클래스가 포함되어 있습니다. 친패키지의 javax.print.attribute 는 Java 의 인쇄 서비스 속성의 형태를 기술하는 클래스와 인터페이스, 및 그러한 속성 세트에의 수집 방법을 제공합니다.

속성은 인쇄 서비스가 제공 가능한 인쇄 기능을 나타냅니다. 인쇄 서비스가 모든 속성을 서포트하는 프로텍션은 없습니다. 서포트되는 속성의 값에 대해서도, 그 모든 것을 서포트하는 프로텍션은 없습니다.

API 측에서는 특정의 속성의 서포트를 필수로 합니다만, 그 이외는 옵션이며, 서포트할지 어떨지는 서비스측에서 선택할 수 있습니다. 받아들이고 가능한 값은 속성에 따라서 달라, 특정의 속성에 대해서 특정의 값이 필수가 됩니다. 그 이외의 속성치는 속성 자체와 같게 옵션이며, 서포트할지 어떨지는 서비스측에서 선택할 수 있습니다. 이러한 서포트 조건은 각 속성 클래스의 문서에 기술됩니다.

javax.print.attribute.standard 패키지는 인쇄 도메인으로 넓게 사용되는 표준 인쇄 속성과 표준 인쇄 속성치를 포함합니다. 인쇄 서비스의 벤더는 표준의 속성에 가세해, 벤더 고유의 인쇄 속성을 제공할 수 있어 또 예를 들어, 서브 클래스에서 표준 인쇄 속성에 벤더 고유의 값을 추가해, 확장할 수 있습니다. 클라이언트측에서 이러한 추가 속성이나 확장 속성을 사용 가능하게 하기 위해서는 벤더는 새로운 속성 클래스를 공개할 필요가 있습니다.

표준 속성 클래스의 상당수는 javax.print.attribute 패키지의 추상 구문 클래스의 1 개를 확장한 것입니다. 예를 들어 EnumSyntax 클래스는 형태 프로텍션된 열거를 나타냅니다. 추상 구문 클래스는 속성치의 래퍼를 제공합니다.

속성 클래스가 EnumSyntax 를 확장해, 속성의 값이 IPP 호환의 경우, 속성의 toString 메소드는 속성치의 IPP 캐릭터 라인 표현을 돌려줍니다. 예를 들어 JobState 속성에는 processing-stopped 와 같은 값이 돌려주어집니다. 다만 EnumSyntax 클래스는 확장 가능하기 때문에, 벤더 독자적인 속성 클래스를 정의할 수 있습니다. 속성으로 EnumSyntax 클래스가 사용되어 벤더 정의의 값이 설정되는 경우,toString 메소드는 값의 IPP 캐릭터 라인 표현을 돌려주지 않습니다.

인쇄 클라이언트 어플리케이션은 통상 javax.print.attribute.standard 패키지의 모든 인쇄 속성 클래스를 사용할 필요는 없고, 어플리케이션 관련의 것만을 사용합니다.

javax.print.attribute.standard 패키지의 속성 클래스는 2000 년 9 월에 제정된, 인터넷 RFC 문서,RFC 2911 Internet Printing Protocol/1. 1: Model and Semantics 로 정의되고 있는 Internet Printing Protocol (IPP) 속성에 근거하고 있습니다. 자세한 것은 RFC 2911 을 참조해 주세요. 각 속성 클래스의 설명은 주로 상기의 문서로부터의 인용입니다. 이러한 문서의 작자에게 이 장소를 빌리고 감사 드리겠습니다.

속성의 구성

인쇄 속성에는 문서 속성, 인쇄 요구 속성, 인쇄 작업 속성, 인쇄 서비스 속성, 서포트치 속성의 5 종류가 있습니다.

문서 속성

문서 속성은 개개의 문서, 및 그 문서에 적용되는 인쇄 작업 설정을 지정합니다. 문서 속성 클래스는 DocAttribute 인터페이스를 구현합니다. 문서 속성은 DocAttributeSet 로 사용할 수 있습니다.

인쇄 요구 속성

인쇄 요구 속성은 인쇄 작업 전체, 및 그 작업의 모든 문서에 적용되는 설정을 지정합니다. 인쇄 요구 속성 클래스는 PrintRequestAttribute 인터페이스를 구현합니다. 인쇄 요구 속성은 PrintRequestAttributeSet 로 사용할 수 있습니다.

문서 속성이어도 인쇄 요구 속성이 아닌 속성이 있어, 이러한 속성은 문서 레벨만으로 지정할 수 있습니다. 반대로 인쇄 요구 속성이어도 문서 속성이 아닌 속성도 있어, 이러한 속성은 인쇄 요구 레벨만으로 지정할 수 있습니다. 어디라도 지정할 수 있는 속성도 있습니다.

속성을 문서 레벨로 지정하면(자), 속성은 그 문서인 만큼 적용됩니다. 인쇄 요구 레벨로 지정하면(자), 작업 전체, 그 작업에 포함되는 모든 문서에 적용됩니다. 양쪽 모두로 지정되고 있는 경우, 문서 레벨의 속성이 인쇄 요구 레벨로 같은 카테고리로 지정된 속성을 오버라이드(override) 합니다.

인쇄 작업 속성

인쇄 작업 속성은 인쇄 작업의 스테이터스를 통지합니다. 인쇄 작업 속성 클래스는 PrintJobAttribute 인터페이스를 구현합니다. 인쇄 작업 속성은 PrintJobAttributeSet 로 사용할 수 있습니다.

인쇄 요구 속성 및 인쇄 작업 속성의 어느 쪽이라고 해도 지정 가능한 속성이 있습니다. 이러한 속성을 인쇄 요구에 추가하면(자), 그 이후의 인쇄 작업의 특성을 지정할 수 있습니다. 이러한 속성은 인쇄 작업의 속성 세트에도 지정됩니다. 인쇄 작업 속성이어도 인쇄 의뢰 속성이 아닌 속성은 인쇄 서비스 자체에 의해 인쇄 작업의 속성 세트에 추가됩니다.

인쇄 서비스 속성

인쇄 서비스 속성은 인쇄 서비스의 스테이터스를 통지합니다. 인쇄 서비스 속성 클래스는 PrintServiceAttribute 인터페이스를 구현합니다. 인쇄 서비스 속성은 PrintServiceAttributeSet 로 사용할 수 있습니다.

서포트치 속성

서포트치 속성은 인쇄 서비스가 서포트하고 있는 다른 속성에 대한 정당한 값을 나타냅니다. 서포트치 속성 클래스는 SupportedValuesAttribute 인터페이스를 구현합니다. 다만 서포트치 속성은 속성 세트에는 표시되지 않기 때문에, 이것에 대한 AttributeSet 서브 인터페이스는 제한된 것이 됩니다.

속성 테이블

다음의 겉(표)는 모든 인쇄 속성의 리스트입니다. Attribute 인터페이스에 가세해, 각 속성 클래스가 구현하는 태그 기능 인터페이스도 기재되어 API 에서의 속성의 사용 방법을 나타내고 있습니다. 인쇄 서비스가, 각 문서 속성과 인쇄 요구 속성의 속성 카테고리에 대해서 서포트하고 있는 값을 나타내는 서포트치 속성 클래스가 있는 경우는 SupportedValuesAttribute 열에 표시됩니다.

속성 클래스	Doc Attribute	Print Request Attribute	Print Job Attribute	Print Service Attribute	SupportedValuesAttribute
Compression	X
DocumentName	X
Chromaticity	X	X	X
Copies		X	X		CopiesSupported
Finishings	X	X	X
JobHoldUntil		X	X
JobImpressions		X	X		JobImpressionsSupported
JobKOctets		X	X		JobKOctetsSupported
JobMediaSheets		X	X		JobMediaSheetsSupported
JobName		X	X
JobPriority		X	X		JobPrioritySupported
JobSheets		X	X
Media	X	X	X
MediaSize
MultipleDocumentHandling		X	X
NumberUp	X	X	X		NumberUpSupported
OrientationRequested	X	X	X
PageRanges	X	X	X
PresentationDirection	X	X	X
PrinterResolution	X	X	X
PrintQuality	X	X	X
RequestingUserName		X	X
SheetCollate	X	X	X
Sides	X	X	X
DateTimeAtCompleted			X
DateTimeAtCreation			X
DateTimeAtProcessing			X
JobImpressionsCompleted			X
JobKOctetsProcessed			X
JobMediaSheetsCompleted			X
JobMessageFromOperator			X
JobOriginatingUserName			X
JobState			X
JobStateReasons 제로 이상이 포함된다			X
-- JobStateReason
NumberOfDocuments			X
NumberOfInterveningJobs			X
OutputDeviceAssigned			X
ColorSupported				X
PagesPerMinute				X
PagesPerMinuteColor				X
PDLOverrideSupported				X
PrinterIsAcceptingJobs				X
PrinterInfo				X
PrinterLocation				X
PrinterMessageFromOperator				X
PrinterMakeAndModel				X
PrinterMoreInfo				X
PrinterMoreInfoManufacturer				X
PrinterName				X
PrinterState				X
PrinterStateReasons 제로 이상이 포함된다				X
-- PrinterStateReason
-- Severity
QueuedJobCount				X
ReferenceUriSchemesSupported

javax.print API 에서는 메소드에의 null 참조 파라미터 지정은 문서에 의미가 명기되어 있는 경우를 제외해 부정한 것으로 주의해 주세요. null 참조 파라미터 지정이 사용되고 있는 코딩은 부정한 코딩이며, 즉시, 또는 나중이 되고 나서 실행시 에러가 됩니다. 이러한 경우의 전형적인, 수락 가능 실행시 예외로서는 IllegalArgumentException 와 NullPointerException 가 있습니다.

도입된 버젼:

1.4