T.M. SoftStudio

feci quod potui, faciant meliora potentes

Класс PrinterJob

Класс PrinterJob является базовым классом программного интерфейса Printing API печати графа сцены.

Класс PrinterJob обеспечивает создание задания на печать, получение конфигурации печати для ее определения, установку принтера и запуск печати.

Класс PrinterJob имеет следующие свойства и методы:

  • Свойство public final ObjectProperty<Printer> printerProperty - представляет принтер.

  • Свойство public ReadOnlyObjectProperty<PrinterJob.JobStatus> jobStatusProperty - текущий статус печати.

  • Метод public static final PrinterJob createPrinterJob(), public static final PrinterJob createPrinterJob(Printer printer) - создает задание на печать.

  • Метод public final ObjectProperty<Printer> printerProperty(), public Printer getPrinter(), public void setPrinter(Printer printer) - определяет принтер для печати.

  • Метод public JobSettings getJobSettings() - определяет конфигурацию печати.

  • Метод public boolean showPrintDialog(Window owner) - отображает диалоговое окно установок принтера и конфигурации.

  • Метод public boolean showPageSetupDialog(Window owner) - отображает диалоговое окно настройки параметров страницы.

  • Метод public boolean printPage(PageLayout pageLayout, Node node), public boolean printPage(Node node) - печать узла графа сцены.

  • Метод public ReadOnlyObjectProperty<PrinterJob.JobStatus> jobStatusProperty(), public PrinterJob.JobStatus getJobStatus() - возвращает статус печати.

  • Метод public void cancelJob() - прерывает печать.

  • Метод public boolean endJob() - возвращает true, если задание успешно добавлено в очередь печати.

Класс Printer представляет принтер для выполнения задания на печать.

Класс Printer имеет следующие свойства и методы:

  • Свойство public static ReadOnlyObjectProperty<Printer> defaultPrinterProperty - принтер по умолчанию.
  • Метод public static ObservableSet<Printer> getAllPrinters() - возвращает список установленных принтеров.
  • Метод public static ReadOnlyObjectProperty<Printer> defaultPrinterProperty(), public static Printer getDefaultPrinter() - возвращает принтер по умолчанию.
  • Метод public java.lang.String getName() - возвращает имя принтера.
  • Метод public PrinterAttributes getPrinterAttributes() - возвращает характеристики принтера.
  • Метод public PageLayout getDefaultPageLayout() - возвращает компоновку страницы по умолчанию.
  • Метод public PageLayout createPageLayout(Paper paper, PageOrientation orient, Printer.MarginType mType), public PageLayout createPageLayout(Paper paper, PageOrientation orient, double lMargin, double rMargin, double tMargin, double bMargin) - создает компоновку страницы печати.

Класс PrinterAttributes предоставляет информацию о характеристиках принтера с помощью следующих методов:

  • public int getDefaultCopies() - возвращает количество копий по умолчанию.
  • public int getMaxCopies() - максимальное количество копий.
  • public boolean supportsPageRanges() - указывает есть ли поддержка диапазона страниц.
  • public Collation getDefaultCollation() - указывает компоновку копий по умолчанию.
  • public java.util.Set<Collation> getSupportedCollations() - возвращает возможные компоновки копий. Перечисление Collation имеет два значения UNCOLLATED и COLLATED.
  • public PrintSides getDefaultPrintSides() - указывает установку по умолчанию опции печати с двух сторон.
  • public java.util.Set<PrintSides> getSupportedPrintSides() - возвращает возможные установки печати с двух сторон. Перечисление PrintSides имеет значения DUPLEX, ONE_SIDED, TUMBLE.
  • public PrintColor getDefaultPrintColor() - возвращает цвет печати по умолчанию.
  • public java.util.Set<PrintColor> getSupportedPrintColors() - возвращает возможные цвета печати. Перечисление PrintColor имеет значения COLOR и MONOCHROME.
  • public PrintQuality getDefaultPrintQuality() - возвращает установки качества печати по умолчанию.
  • public java.util.Set<PrintQuality> getSupportedPrintQuality() - возвращает возможные установки качества печати. Перечисление PrintQuality имеет значения DRAFT, HIGH, LOW и NORMAL.
  • public PrintResolution getDefaultPrintResolution() - возвращает разрешение печати по умолчанию.
  • public java.util.Set<PrintResolution> getSupportedPrintResolutions() - возвращает возможные разрешения печати. Класс PrintResolution имеет методы public int getCrossFeedResolution() - возвращает разрешение в точках на дюйм. поперек направления подачи бумаги и public int getFeedResolution() - возвращает разрешение в точках на дюйм. в направлении подачи бумаги.
  • public PageOrientation getDefaultPageOrientation() - возвращает ориентацию страницы по умолчанию.
  • public java.util.Set<PageOrientation> getSupportedPageOrientations() - возвращает возможные ориентации. Перечисление PageOrientation имеет значения LANDSCAPE, PORTRAIT, REVERSE_LANDSCAPE и REVERSE_PORTRAIT.
  • public Paper getDefaultPaper() - возвращает размер страницы по умолчанию.
  • public java.util.Set<Paper> getSupportedPapers() - возвращает возможные размеры страницы. Перечисление Paper имеет значения A0, A1, A2, A3, A4, A5, A6, C, DESIGNATED_LONG, EXECUTIVE, JAPANESE_POSTCARD, JIS_B4, JIS_B5, JIS_B6, LEGAL, MONARCH_ENVELOPE, NA_8X10, NA_LETTER, NA_NUMBER_10_ENVELOPE, TABLOID.
  • public PaperSource getDefaultPaperSource() - указывает подачу бумаги по умолчанию.
  • public java.util.Set<PaperSource> getSupportedPaperSources() - возвращает возможные варианты подачи бумаги. Перечисление PaperSource имеет значения AUTOMATIC, BOTTOM, ENVELOPE, LARGE_CAPACITY, MAIN, MANUAL, MIDDLE, SIDE, TOP.

Класс PageLayout содержит информацию, необходимую для компоновки контента страницы, такую как отступы, размеры и ориентацию.

Класс PageLayout имеет следующие методы:

  • public PageOrientation getPageOrientation() - возвращает ориентацию страницы.
  • public Paper getPaper() - возвращает объект страницы.
  • public double getPrintableWidth() - возвращает ширину области печати.
  • public double getPrintableHeight() - возвращает высоту области печати.
  • public double getLeftMargin() - возвращает левый отступ.
  • public double getRightMargin()- возвращает правый отступ.
  • public double getTopMargin() - возвращает верхний отступ.
  • public double getBottomMargin() - возвращает нижний отступ.

Перечисление Printer.MarginType определяет область печати с помощью значений:

  • DEFAULT - отступы 0.75 дюйма с каждой стороны.
  • HARDWARE_MINIMUM - наименьшие отступы, позволяемые оборудованием.
  • EQUAL - выбирается наибольший отступ из 4 и используется для всех сторон.
  • EQUAL_OPPOSITES - аналогично EQUAL, только раздельно для верх-низ и слева-справа.

Класс JobSettings определяет конфигурацию задания на печать с помощью следующих свойств и методов:

  • Свойство public final StringProperty jobNameProperty - имя задания.
  • Свойство public final IntegerProperty copiesProperty - количество копий.
  • Свойство public final ObjectProperty pageRangesProperty - диапазон страниц для печати.
  • Свойство public final ObjectProperty<PrintSides> printSidesProperty - печать с одной или двух сторон страницы.
  • Свойство public final ObjectProperty<Collation> collationProperty - компоновка копий.
  • Свойство public final ObjectProperty<PrintColor> printColorProperty - цвет печати.
  • Свойство public final ObjectProperty<PrintQuality> printQualityProperty - качество печати.
  • Свойство public final ObjectProperty<PrintResolution> printResolutionProperty - разрешение печати.
  • Свойство public final ObjectProperty<PaperSource> paperSourceProperty - подача печати.
  • Свойство public final ObjectProperty<PageLayout> pageLayoutProperty - компоновка печати.
  • Метод public final StringProperty jobNameProperty(), public java.lang.String getJobName(), public void setJobName(java.lang.String name) - определяет имя задания на печать.
  • Метод public final IntegerProperty copiesProperty(), public int getCopies(), public final void setCopies(int nCopies) - определяет количество копий.
  • Метод public final ObjectProperty pageRangesProperty(), public PageRange[] getPageRanges(), public void setPageRanges(PageRange... pages) - определяет диапазон страниц для печати.
  • Метод public final ObjectProperty<PrintSides> printSidesProperty(), public PrintSides getPrintSides(), public void setPrintSides(PrintSides sides) - определяет количество сторон печати.
  • Метод public final ObjectProperty<Collation> collationProperty(), public Collation getCollation(), public void setCollation(Collation collation) - определяет компоновку копий.
  • Метод public final ObjectProperty<PrintColor> printColorProperty(), public PrintColor getPrintColor(), public void setPrintColor(PrintColor color) - определяет цвет печати.
  • Метод public final ObjectProperty<PrintQuality> printQualityProperty(), public PrintQuality getPrintQuality(), public void setPrintQuality(PrintQuality quality) - определяет качество печати.
  • Метод public final ObjectProperty<PrintResolution> printResolutionProperty(), public PrintResolution getPrintResolution(), public void setPrintResolution(PrintResolution resolution) - определяет разрешение печати.
  • Метод public final ObjectProperty<PaperSource> paperSourceProperty(), public PaperSource getPaperSource(), public void setPaperSource(PaperSource value) - определяет подачу печати.
  • Метод public final ObjectProperty<PageLayout> pageLayoutProperty(), public PageLayout getPageLayout(), public void setPageLayout(PageLayout pageLayout) - определяет компоновку печати.

Перечисление PrinterJob.JobStatus определяет статус печати с помощью значений CANCELED, DONE, ERROR, NOT_STARTED, PRINTING.