PageRanges

PageRanges (인쇄할 페이지 범위)

Printer 객체가 인쇄할 각 문서의 각 사본에 대해 사용하는 인쇄 스트림 페이지의 범위를 식별하는 정수 집합(셋) 인쇄 속성 클래스예요.

출처: Java API Reference

본문

문서에 존재하지 않는 식별된 페이지는 아무것도 인쇄되지 않아요. 이 속성은 인쇄 스트림 페이지와 연관되며, 애플리케이션 번호 페이지(예: 특정 워드 프로세싱 애플리케이션의 머리글·바닥글에 있는 페이지 번호)와는 연관되지 않아요.

대부분의 경우 정확히 인쇄할 페이지는 장치 드라이버가 생성하므로 이 속성이 필요하지 않을 수 있어요. 그러나 이미 형식화된 보관 문서를 인쇄할 때 최종 사용자는 문서에 포함된 페이지의 부분집합만 인쇄하도록 선택할 수 있어요. 이 경우 "n-m" 페이지 범위가 지정되면 첫 번째로 인쇄할 페이지는 페이지 n이고, 문서의 모든 후속 페이지는 페이지 m까지 인쇄돼요.

인쇄 작업에 PageRanges 속성이 지정되지 않으면 문서의 모든 페이지가 인쇄돼요. 다시 말해 PageRanges 속성의 기본값은 항상 {{1, Integer.MAX_VALUE}}예요.

다중 문서 인쇄 작업에서 PageRanges 속성의 효과는 모든 문서가 같은 페이지 범위를 지정했는지, 서로 다른 문서가 서로 다른 페이지 범위를 지정했는지, 그리고 (아마 기본값인) MultipleDocumentHandling 속성 값에 따라 달라져요.

  • SINGLE_DOCUMENT — 모든 입력 문서가 하나의 출력 문서로 결합되고, 그 출력 문서의 지정된 페이지 범위가 인쇄돼요.
  • SINGLE_DOCUMENT_NEW_SHEET — 모든 입력 문서가 하나의 출력 문서로 결합되고, 각 입력 문서의 첫 인상은 항상 새 매체 시트에서 시작해요. 그 출력 문서의 지정된 페이지 범위가 인쇄돼요.
  • SEPARATE_DOCUMENTS_UNCOLLATED_COPIES — 각 분리 입력 문서에 대해 지정된 페이지 범위가 인쇄돼요.
  • SEPARATE_DOCUMENTS_COLLATED_COPIES — 각 분리 입력 문서에 대해 지정된 페이지 범위가 인쇄돼요.

IPP 호환성: PageRanges 속성의 정규 배열 형태는 IPP "page-ranges" 속성에 포함될 각 페이지 범위의 하한과 상한을 줘요. 정규 배열 형태에 대한 설명은 SetOfIntegerSyntax 클래스를 참고하세요. getName()이 반환하는 카테고리 이름이 IPP 속성 이름을 줘요.

생성자 요약

  • PageRanges(int[][] members) — 주어진 멤버로 새 페이지 범위 속성을 생성해요. 멤버는 "배열 형태"로 지정돼요. members가 null이거나 요소가 null이면 NullPointerException, 요소가 길이 1 또는 2 배열이 아니거나 members가 길이 0 배열이거나 집합 멤버가 1보다 작으면 IllegalArgumentException을 던져요.
  • PageRanges(String members) — 문자열 형태의 주어진 멤버로 새 페이지 범위 속성을 생성해요. members가 null이거나 요소가 null이면 NullPointerException, 올바른 구문을 따르지 않거나 생성된 정수 집합이 길이 0 배열이거나 멤버가 1보다 작으면 IllegalArgumentException을 던져요.
  • PageRanges(int member) — 단일 정수를 포함하는 새 페이지 범위 속성을 생성해요. 즉 한 페이지만 인쇄돼요. member < 1이면 IllegalArgumentException을 던져요.
  • PageRanges(int lowerBound, int upperBound) — 단일 정수 범위를 포함하는 새 페이지 범위 속성을 생성해요. 즉 한 범위의 페이지만 인쇄돼요. null 범위가 지정되거나 lowerBound가 1보다 작은 비-null 범위가 지정되면 IllegalArgumentException을 던져요.

메서드 요약

  • boolean equals(Object object) — 이 페이지 범위 속성이 전달받은 객체와 동등한지 여부를 반환해요. 동등하려면 object가 null이 아니고, PageRanges 클래스의 인스턴스이며, 두 멤버 집합이 같아야 해요.
  • final Class<? extends Attribute> getCategory() — 이 인쇄 속성 값의 "카테고리"로 사용할 인쇄 속성 클래스를 가져와요. PageRanges 클래스의 카테고리는 PageRanges 클래스 자체예요.
  • final String getName() — 이 속성 값이 인스턴스인 카테고리의 이름을 가져와요. PageRanges 클래스의 카테고리 이름은 "page-ranges"예요.

더 알아보기 (Learn more)