- java.lang.Object
-
- javafx.print.Printer
-
public final class Printer extends Object
Объект Printer представляет собой место назначения для задания печати.Принтеры могут быть перечислены и выбраны для использования с заданием печати.
Затем конфигурация параметров принтера по умолчанию используется для заполнения начальных параметров задания.
Поскольку доступность принтеров может измениться во время выполнения программы из-за административных действий, долго выполняющаяся программа, которая кэшировала принтер, который с тех пор был отключен, может создать задание, используя этот экземпляр, но печать завершится неудачно.
- С тех пор:
- JavaFX 8.0
-
Краткое описание свойств
Свойства Тип Свойство Описание static ReadOnlyObjectProperty<Printer>defaultPrinterСвойство объекта только для чтения, представляющее текущий принтер по умолчанию.
-
Краткое описание вложенных классов
Вложенные классы Модификатор и тип Класс Описание static classPrinter.MarginTypeТип отступов используется для определения области печати в PageLayout.
-
Краткое описание методов
Все методыСтатические методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание PageLayoutcreatePageLayout(Paper paper, PageOrientation orient, double lMargin, double rMargin, double tMargin, double bMargin)Получение нового PageLayout для этого принтера, используя указанные параметры.PageLayoutcreatePageLayout(Paper paper, PageOrientation orient, Printer.MarginType mType)Получение нового объекта PageLayout для этого принтера, используя указанные параметры.static ReadOnlyObjectProperty<Printer>defaultPrinterProperty()Свойство объекта только для чтения, представляющее текущий принтер по умолчанию.static ObservableSet<Printer>getAllPrinters()Получение установленных принтеров.PageLayoutgetDefaultPageLayout()Возвращение макета страницы по умолчанию для этого принтера.static PrintergetDefaultPrinter()Получение принтера по умолчанию.StringgetName()Возвращение имени, используемого основной системой для идентификации принтера для пользователей и/или приложений.PrinterAttributesgetPrinterAttributes()Возвращает объект делегата, инкапсулирующий атрибуты и возможности принтера.StringtoString()
-
Подробное описание свойства
-
defaultPrinter
public static ReadOnlyObjectProperty<Printer> defaultPrinterProperty
Только для чтения свойство объекта, представляющее текущий принтер по умолчанию. Если установленных принтеров нет, значение обернутого объекта будет null.- См. также:
getDefaultPrinter()
-
-
Подробное описание методов
-
getAllPrinters
public static ObservableSet<Printer> getAllPrinters()
Получить установленные принтеры. Набор принтеров может быть динамическим. Следовательно, нет гарантии, что результат будет одинаковым при каждом вызове, но он должен изменяться только в результате изменения принтера по умолчанию в среде приложения.Примечание: принтеры могут быть установлены, но офлайн, поэтому приложение может запросить статус принтера перед его использованием.
- Возвращает:
- может быть null, если принтеров нет.
- Имеет исключение:
-
SecurityException- если у приложения нет разрешения на просмотр принтеров.
-
defaultPrinterProperty
public static ReadOnlyObjectProperty<Printer> defaultPrinterProperty()
Только для чтения свойство объекта, представляющее текущий принтер по умолчанию. Если установленных принтеров нет, значение обернутого объекта будет null.- См. также:
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)
Создает новый PageLayout для этого принтера, используя указанные параметры. Бумага должна быть одной из поддерживаемых, а ориентация - одной из поддерживаемых.Значения отступов задаются в 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.