Класс PrinterStateReason

java.lang.Object

javax.print.attribute.EnumSyntax

javax.print.attribute.standard.PrinterStateReason

Все реализованные интерфейсы:: Serializable, Cloneable, Attribute

public class PrinterStateReason extends EnumSyntax implements Attribute

Класс PrinterStateReason — это класс атрибутов печати, перечисление, которое предоставляет дополнительную информацию о текущем состоянии принтера, то есть информацию, которая дополняет значение атрибута принтера PrinterState. Класс PrinterStateReason определяет стандартные значения причины состояния принтера. Реализация службы печати должна сообщать только те причины состояния принтера, которые подходят для конкретной реализации; она не обязана сообщать каждую определённую причину состояния принтера.

Экземпляры PrinterStateReason не отображаются напрямую в наборе атрибутов службы печати. Вместо этого в наборе атрибутов службы печати появляется атрибут PrinterStateReasons. Атрибут PrinterStateReasons содержит ноль, один или более объектов PrinterStateReason, относящихся к состоянию службы печати, и каждый объект PrinterStateReason связан с уровнем Severity серьёзности REPORT (наименее серьёзный), WARNING или ERROR (наиболее серьёзный). Принтер добавляет объект PrinterStateReason к атрибуту службы печати PrinterStateReasons, когда соответствующее условие становится истинным для принтера, и принтер удаляет объект PrinterStateReason снова, когда соответствующее условие становится ложным, независимо от того, изменилось ли общее состояние PrinterState службы печати.

Совместимость с IPP: Строковые значения, возвращаемые каждым отдельным PrinterStateReason, а также сопутствующим объектом Severity методами toString(), соединённые вместе дефисом ("-") между ними, дают значение ключевого слова IPP для PrinterStateReasons. Имя категории, возвращаемое getName(), даёт имя атрибута IPP.

См. также:

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

Modifier and Type	Field	Description
`static final PrinterStateReason`	`CONNECTING_TO_DEVICE`	Принтер запланировал задание на выходном устройстве и в процессе подключения к общедоступному сетевому выходному устройству (и, возможно, не сможет фактически начать печать задания в течение произвольно долгого времени в зависимости от использования выходного устройства другими серверами в сети).
`static final PrinterStateReason`	`COVER_OPEN`	Одна или несколько крышек на устройстве открыты.
`static final PrinterStateReason`	`DEVELOPER_EMPTY`	На устройстве закончился тонер.
`static final PrinterStateReason`	`DEVELOPER_LOW`	Устройство почти закончилось тонером.
`static final PrinterStateReason`	`DOOR_OPEN`	Одна или несколько дверей на устройстве открыты.
`static final PrinterStateReason`	`FUSER_OVER_TEMP`	Температура плавильного устройства превышает норму.
`static final PrinterStateReason`	`FUSER_UNDER_TEMP`	Температура плавильного устройства ниже нормы.
`static final PrinterStateReason`	`INPUT_TRAY_MISSING`	Один или несколько лотков ввода не установлены в устройстве.
`static final PrinterStateReason`	`INTERLOCK_OPEN`	Один или несколько устройств блокировки на принтере разблокированы.
`static final PrinterStateReason`	`INTERPRETER_RESOURCE_UNAVAILABLE`	Ресурс интерпретатора недоступен (например, шрифт, форма).
`static final PrinterStateReason`	`MARKER_SUPPLY_EMPTY`	На устройстве закончились расходные материалы (например, тонер, чернила, лента).
`static final PrinterStateReason`	`MARKER_SUPPLY_LOW`	Устройство почти закончилось расходными материалами (например, тонер, чернила, лента).
`static final PrinterStateReason`	`MARKER_WASTE_ALMOST_FULL`	Корзина для отходов расходных материалов устройства почти полна.
`static final PrinterStateReason`	`MARKER_WASTE_FULL`	Корзина для отходов расходных материалов устройства полна.
`static final PrinterStateReason`	`MEDIA_EMPTY`	Хотя бы один лоток ввода пуст.
`static final PrinterStateReason`	`MEDIA_JAM`	На устройстве замятие носителя.
`static final PrinterStateReason`	`MEDIA_LOW`	Хотя бы один лоток ввода почти пуст носителя.
`static final PrinterStateReason`	`MEDIA_NEEDED`	Лоток закончился носителем.
`static final PrinterStateReason`	`MOVING_TO_PAUSED`	Кто-то приостановил принтер, но устройство(я) затрачивает значительное время на остановку.
`static final PrinterStateReason`	`OPC_LIFE_OVER`	Оптический фотопроводник больше не функционирует.
`static final PrinterStateReason`	`OPC_NEAR_EOL`	Оптический фотопроводник близок к концу срока службы.
`static final PrinterStateReason`	`OTHER`	Принтер обнаружил ошибку, отличную от перечисленных ниже.
`static final PrinterStateReason`	`OUTPUT_AREA_ALMOST_FULL`	Один или несколько выходных участков почти полны (например, лоток, стопка, агрегат для совмещения).
`static final PrinterStateReason`	`OUTPUT_AREA_FULL`	Один или несколько выходных участков полны (например, лоток, стопка, агрегат для совмещения).
`static final PrinterStateReason`	`OUTPUT_TRAY_MISSING`	Один или несколько выходных лотков не установлены в устройстве.
`static final PrinterStateReason`	`PAUSED`	Кто-то приостановил принтер, и состояние принтера `PrinterState` является `STOPPED`.
`static final PrinterStateReason`	`SHUTDOWN`	Кто-то снял принтер с обслуживания, и устройство может быть выключено или физически удалено.
`static final PrinterStateReason`	`SPOOL_AREA_FULL`	Достигнут предел выделенного постоянного хранилища для очереди печати.
`static final PrinterStateReason`	`STOPPED_PARTLY`	Когда принтер управляет более чем одним выходным устройством, это причина указывает на то, что одно или несколько выходных устройств остановлены.
`static final PrinterStateReason`	`STOPPING`	Принтер в процессе остановки устройства и остановится через некоторое время.
`static final PrinterStateReason`	`TIMED_OUT`	Сервер смог подключиться к выходному устройству (или всегда подключен), но не смог получить ответ от выходного устройства.
`static final PrinterStateReason`	`TONER_EMPTY`	На устройстве закончился тонер.
`static final PrinterStateReason`	`TONER_LOW`	Устройство почти закончилось тонером.

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

PrinterStateReason(int value)

Modifier	Constructor	Description
`protected`	Создаёт новый перечисление причины состояния принтера с заданным значением целого числа.

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

Modifier and Type	Method	Description
`final Class<? extends Attribute>`	`getCategory()`	Получить класс атрибута печати, который должен использоваться в качестве «категории» для данного значения атрибута печати.
`protected EnumSyntax[]`	`getEnumValueTable()`	Возвращает таблицу значений перечисления для класса `PrinterStateReason`.
`final String`	`getName()`	Получить имя категории, членом которой является данное значение атрибута.
`protected String[]`	`getStringTable()`	Возвращает таблицу строк для класса `PrinterStateReason`.

Methods declared in class javax.print.attribute.EnumSyntax

clone, getOffset, getValue, hashCode, readResolve, toString

Methods declared in class java.lang.Object

equals, finalize, getClass, notify, notifyAll, wait, wait, wait

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

OTHER

public static final PrinterStateReason OTHER

Принтер обнаружил ошибку, отличную от перечисленных ниже.

MEDIA_NEEDED

public static final PrinterStateReason MEDIA_NEEDED

В лотке закончились носители.

MEDIA_JAM

public static final PrinterStateReason MEDIA_JAM

В устройстве застрял носитель.

MOVING_TO_PAUSED

public static final PrinterStateReason MOVING_TO_PAUSED

Кто-то приостановил принтер, но устройству(ам) требуется значительное время для остановки. Позже, когда весь вывод будет остановлен, PrinterState станет STOPPED, а значение PAUSED заменит значение MOVING_TO_PAUSED в атрибуте PrinterStateReasons. Это значение должно поддерживаться, если принтер может быть приостановлен, и реализация требует значительного времени для приостановки устройства в определённых обстоятельствах.

PAUSED

public static final PrinterStateReason PAUSED

Кто-то приостановил принтер, и PrinterState принтера имеет значение STOPPED. В этом состоянии принтер не должен генерировать печатный вывод, но должен выполнять другие запрошенные клиентом операции. Если принтер печатал задание при приостановке, Printer должен продолжить печать этого задания, когда принтер больше не приостановлен, и не оставлять в печатном выводе никаких следов такой приостановки. Это значение должно поддерживаться, если принтер может быть приостановлен.

SHUTDOWN

public static final PrinterStateReason SHUTDOWN

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

CONNECTING_TO_DEVICE

public static final PrinterStateReason CONNECTING_TO_DEVICE

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

TIMED_OUT

public static final PrinterStateReason TIMED_OUT

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

STOPPING

public static final PrinterStateReason STOPPING

Принтер в процессе остановки устройства и будет остановлен через некоторое время. При остановке устройства принтер изменит PrinterState на STOPPED. Причина STOPPING никогда не является ошибкой, даже для принтера с одним выходным устройством. Когда выходное устройство перестаёт принимать задания, у PrinterStateReasons принтера будет эта причина, пока выходное устройство завершает печать.

STOPPED_PARTLY

public static final PrinterStateReason STOPPED_PARTLY

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

TONER_LOW

public static final PrinterStateReason TONER_LOW

Устройство испытывает низкий уровень тонера.

TONER_EMPTY

public static final PrinterStateReason TONER_EMPTY

В устройстве закончился тонер.

SPOOL_AREA_FULL

public static final PrinterStateReason SPOOL_AREA_FULL

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

COVER_OPEN

public static final PrinterStateReason COVER_OPEN

Одна или несколько крышек на устройстве открыты.

INTERLOCK_OPEN

public static final PrinterStateReason INTERLOCK_OPEN

Одна или несколько устройств межблочной блокировки на принтере разблокированы.

DOOR_OPEN

public static final PrinterStateReason DOOR_OPEN

Одна или несколько дверей на устройстве открыты.

INPUT_TRAY_MISSING

public static final PrinterStateReason INPUT_TRAY_MISSING

Один или несколько лотков ввода отсутствуют в устройстве.

MEDIA_LOW

public static final PrinterStateReason MEDIA_LOW

В одном или нескольких лотках ввода закончились носители.

MEDIA_EMPTY

public static final PrinterStateReason MEDIA_EMPTY

В одном или нескольких лотках ввода закончились носители.

OUTPUT_TRAY_MISSING

public static final PrinterStateReason OUTPUT_TRAY_MISSING

Один или несколько лотков вывода отсутствуют в устройстве.

OUTPUT_AREA_ALMOST_FULL

public static final PrinterStateReason OUTPUT_AREA_ALMOST_FULL

Одна или несколько областей вывода почти заполнены (например, лоток, стопка, агрегат для совмещения).

OUTPUT_AREA_FULL

public static final PrinterStateReason OUTPUT_AREA_FULL

Одна или несколько областей вывода заполнены (например, лоток, стопка, агрегат для совмещения).

MARKER_SUPPLY_LOW

public static final PrinterStateReason MARKER_SUPPLY_LOW

Устройство испытывает низкий уровень хотя бы одного расходного материала (например, тонер, чернила, лента).

MARKER_SUPPLY_EMPTY

public static final PrinterStateReason MARKER_SUPPLY_EMPTY

В устройстве закончился хотя бы один расходный материал (например, тонер, чернила, лента).

MARKER_WASTE_ALMOST_FULL

public static final PrinterStateReason MARKER_WASTE_ALMOST_FULL

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

MARKER_WASTE_FULL

public static final PrinterStateReason MARKER_WASTE_FULL

Корзина для отходов расходных материалов устройства полна.

FUSER_OVER_TEMP

public static final PrinterStateReason FUSER_OVER_TEMP

Температура устройства термофиксации выше нормы.

FUSER_UNDER_TEMP

public static final PrinterStateReason FUSER_UNDER_TEMP

Температура устройства термофиксации ниже нормы.

OPC_NEAR_EOL

public static final PrinterStateReason OPC_NEAR_EOL

Оптический фотопроводник приближается к концу срока службы.

OPC_LIFE_OVER

public static final PrinterStateReason OPC_LIFE_OVER

Оптический фотопроводник больше не функционирует.

DEVELOPER_LOW

public static final PrinterStateReason DEVELOPER_LOW

Устройство испытывает низкий уровень разработчика.

DEVELOPER_EMPTY

public static final PrinterStateReason DEVELOPER_EMPTY

В устройстве закончился разработчик.

INTERPRETER_RESOURCE_UNAVAILABLE

public static final PrinterStateReason INTERPRETER_RESOURCE_UNAVAILABLE

Ресурс интерпретатора недоступен (например, шрифт, форма).

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

PrinterStateReason

protected PrinterStateReason(int value)

Создаёт новый перечислимый элемент причины состояния принтера со заданным целочисленным значением.

Параметры:: value - Целочисленное значение

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

getStringTable

protected String[] getStringTable()

Возвращает таблицу строк для класса PrinterStateReason.

Overrides:: getStringTable в классе EnumSyntax
Возвращает:: таблицу строк

getEnumValueTable

protected EnumSyntax[] getEnumValueTable()

Возвращает таблицу значений перечисления для класса PrinterStateReason.

Overrides:: getEnumValueTable в классе EnumSyntax
Возвращает:: таблицу значений

getCategory

public final Class<? extends Attribute> getCategory()

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

Для класса PrinterStateReason и любых определённых производителем подклассов, категория — это сам класс PrinterStateReason.

Указано в:: getCategory в интерфейсе Attribute
Возвращает:: класс атрибута печати (категория), экземпляр класса java.lang.Class

getName

public final String getName()

Получить имя категории, к которой относится данное значение атрибута.

Для класса PrinterStateReason и любых определённых производителем подклассов, имя категории — "printer-state-reason".

Указано в:: getName в интерфейсе Attribute
Возвращает:: имя категории атрибута

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/attribute/standard/PrinterStateReason.html