Класс Printer

java.lang.Object

javafx.print.Printer

public final class Printer
extends Object

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

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

Затем конфигурация параметров принтера по умолчанию используется для заполнения начальных настроек задания.

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

С момента:: JavaFX 8.0

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

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

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

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

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

Модификатор и тип	Метод	Описание
`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.

См. также:: getDefaultPrinter()

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

getAllPrinters

public static ObservableSet<Printer> getAllPrinters()

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

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

Возвращает:: может быть null, если принтеров нет.
Имеет исключения:: SecurityException - если у приложения нет разрешения на просмотр принтеров.

defaultPrinterProperty

public static ReadOnlyObjectProperty<Printer> defaultPrinterProperty()

См. также:: getDefaultPrinter()

getDefaultPrinter

public static Printer getDefaultPrinter()

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

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

Возвращает:: принтер по умолчанию или null.
Имеет исключения:: SecurityException - если у приложения нет разрешения на просмотр принтеров.

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.