Класс Printer

java.lang.Object

javafx.print.Printer

public final class Printer extends Object

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

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

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

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

Since:: JavaFX 8.0

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

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

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

Модификатор и тип	Класс	Описание
`static enum`	`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()
defaultPrinterProperty()

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

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.