Класс Printer

java.lang.Object

javafx.print.Printer

public final class Printer extends Object

Экземпляр Printer представляет собой место назначения для задания печати.

Принтеры могут быть перечислены и выбраны для использования в задании печати.

Настройка параметров принтера по умолчанию затем используется для заполнения начальных настроек задания.

Поскольку доступность принтеров может изменяться во время выполнения программы из-за административных действий, долго выполняющаяся программа, кэшировавшая принтер, который был отключен, может создать задание, используя этот экземпляр, но печать завершится неудачей.

Since:: JavaFX 8.0

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static enum`	`Printer.MarginType`	Тип отступов MarginType используется для определения области печати PageLayout.

Краткое описание свойств

Тип	Свойство	Описание
`static ReadOnlyObjectProperty<Printer>`	`defaultPrinter`	Только для чтения свойство объекта, представляющее текущий принтер по умолчанию.

Краткое описание методов

Модификатор и тип	Метод	Описание
`PageLayout`	`createPageLayout(Paper paper, PageOrientation orient, double lMargin, double rMargin, double tMargin, double bMargin)`	Получение нового PageLayout для данного принтера с использованием указанных параметров.
`PageLayout`	`createPageLayout(Paper paper, PageOrientation orient, Printer.MarginType mType)`	Получение нового экземпляра PageLayout для данного принтера с использованием указанных параметров.
`static ReadOnlyObjectProperty<Printer>`	`defaultPrinterProperty()`	Только для чтения свойство объекта, представляющее текущий принтер по умолчанию.
`static ObservableSet<Printer>`	`getAllPrinters()`	Получение установленных принтеров.
`PageLayout`	`getDefaultPageLayout()`	Возвращение макета страницы по умолчанию для этого принтера.
`static Printer`	`getDefaultPrinter()`	Получение принтера по умолчанию.
`String`	`getName()`	Возвращает имя, используемое базовой системой для идентификации принтера для пользователей и/или приложений.
`PrinterAttributes`	`getPrinterAttributes()`	Получение объекта-делегата, инкапсулирующего атрибуты и возможности принтера.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание свойств

defaultPrinter

public static ReadOnlyObjectProperty<Printer> defaultPrinterProperty

Только для чтения свойство объекта, представляющее текущий принтер по умолчанию. Если установленных принтеров нет, упакованное значение будет null.

См. также:

Подробное описание методов

getAllPrinters

public static ObservableSet<Printer> getAllPrinters()

Получение установленных принтеров. Множество принтеров может быть динамическим. Следовательно, нет гарантии, что результат будет одинаковым при каждом вызове, но он должен изменяться только в результате изменения значения по умолчанию в среде приложения.

Примечание: поскольку принтеры могут быть установлены, но не активны, приложение может захотеть запросить состояние принтера перед его использованием.

Возвращает:: может быть null, если принтеров нет.

defaultPrinterProperty

public static ReadOnlyObjectProperty<Printer> defaultPrinterProperty()

Возвращает:

текущий принтер по умолчанию

См. также:

getDefaultPrinter

public static Printer getDefaultPrinter()

Получение принтера по умолчанию. Может вернуть null, если принтеры не установлены.

Настройка доступных принтеров может быть динамической. Следовательно, нет гарантии, что результат будет одинаковым при каждом вызове, но он должен меняться только в результате изменения значения по умолчанию в среде приложения.

Возвращает:: принтер по умолчанию или null.

getName

public String getName()

Возвращает имя, используемое базовой системой для идентификации принтера для пользователей и/или приложений.

Возвращает:: имя принтера.

getPrinterAttributes

public PrinterAttributes getPrinterAttributes()

Получение объекта-делегата, инкапсулирующего атрибуты и возможности принтера.

Возвращает:: атрибуты принтера.

getDefaultPageLayout

public PageLayout getDefaultPageLayout()

Возвращение макета страницы по умолчанию для этого принтера.

Возвращает:: макет страницы по умолчанию.

createPageLayout

public PageLayout createPageLayout(Paper paper, PageOrientation orient, Printer.MarginType mType)

Получение нового экземпляра PageLayout для этого принтера с использованием указанных параметров. Бумага должна быть одной из поддерживаемых, а ориентация — поддерживаемой. Если принтер не поддерживает макет как указано, он скорректирует возвращаемый макет до поддерживаемой конфигурации.

Параметры:: paper — Используемая бумага; orient — Используемая ориентация; mType — Используемый тип отступов
Возвращает:: PageLayout, основанный на указанных параметрах.
Исключение:: NullPointerException — если любой из параметров равен null.

createPageLayout

public PageLayout createPageLayout(Paper paper, PageOrientation orient, double lMargin, double rMargin, double tMargin, double bMargin)

Получение нового макета страницы для этого принтера с использованием указанных параметров. Бумага должна быть одной из поддерживаемых, а ориентация — поддерживаемой.

Значения отступов задаются в точках (1/72 дюйма). Отступы будут проверены на совместимость с принтером и при необходимости скорректированы. Этот метод обычно полезен для клиента, который хочет отступы, отличные от стандартных (например, больше), такие как 1" сверху и снизу и 0,5" слева и справа.

Клиент, который хочет узнать допустимые значения отступов, должен сначала получить PageLayout с использованием HARDWARE_MINIMUM отступов.

Если принтер не поддерживает макет как указано, он скорректирует возвращаемый макет до поддерживаемой конфигурации

Параметры:: paper — Используемая бумага; orient — Используемая ориентация; lMargin — Используемый левый отступ в точках.; rMargin — Используемый правый отступ в точках.; tMargin — Используемый верхний отступ в точках.; bMargin — Используемый нижний отступ в точках.
Возвращает:: PageLayout, основанный на указанных параметрах.
Исключение:: NullPointerException — если бумага или ориентация равны null.; IllegalArgumentException — если любое из значений отступов меньше нуля.

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.