QPrinterInfo Class
The QPrinterInfo class provides access to information about existing printers. More...
| Header: | #include <QPrinterInfo> |
| qmake: | QT += printsupport |
| Since: | Qt 4.4 |
This class was introduced in Qt 4.4.
Public Functions
| QPrinterInfo(const QPrinter &printer) | |
| QPrinterInfo(const QPrinterInfo &other) | |
| QPrinterInfo() | |
| QPrinterInfo & | operator=(const QPrinterInfo &other) |
| ~QPrinterInfo() | |
| QPrinter::ColorMode | defaultColorMode() const |
| QPrinter::DuplexMode | defaultDuplexMode() const |
| QPageSize | defaultPageSize() const |
| QString | description() const |
| bool | isDefault() const |
| bool | isNull() const |
| bool | isRemote() const |
| QString | location() const |
| QString | makeAndModel() const |
| QPageSize | maximumPhysicalPageSize() const |
| QPageSize | minimumPhysicalPageSize() const |
| QString | printerName() const |
| QPrinter::PrinterState | state() const |
| QList<QPrinter::ColorMode> | supportedColorModes() const |
| QList<QPrinter::DuplexMode> | supportedDuplexModes() const |
| QList<QPageSize> | supportedPageSizes() const |
| QList<int> | supportedResolutions() const |
| bool | supportsCustomPageSizes() const |
Static Public Members
| QStringList | availablePrinterNames() |
| QList<QPrinterInfo> | availablePrinters() |
| QPrinterInfo | defaultPrinter() |
| QString | defaultPrinterName() |
| QPrinterInfo | printerInfo(const QString &printerName) |
Detailed Description
Используйте статические функции для создания списка объектов QPrinterInfo. Каждый объект QPrinterInfo в списке представляет собой один принтер и может быть запрошен по имени, поддерживаемым размерам бумаги и тому, является ли он принтером по умолчанию.
Member Function Documentation
QPrinterInfo::QPrinterInfo(const QPrinter &printer)
Создаёт объект QPrinterInfo из printer.
QPrinterInfo::QPrinterInfo(const QPrinterInfo &other)
Создаёт копию other.
QPrinterInfo::QPrinterInfo()
Создаёт пустой объект QPrinterInfo.
См. также isNull().
QPrinterInfo &QPrinterInfo::operator=(const QPrinterInfo &other)
Устанавливает объект QPrinterInfo равным other.
QPrinterInfo::~QPrinterInfo()
Удаляет объект QPrinterInfo. Ссылки на значения в объекте становятся недействительными.
[static] QStringList QPrinterInfo::availablePrinterNames()
Возвращает список всех доступных имён принтеров в этой системе.
Рекомендуется использовать этот метод вместо availablePrinters(), так как он будет быстрее на большинстве систем.
Обратите внимание, что список может стать устаревшим, если будут внесены изменения в локальной системе или на удалённом сервере печати. Создавайте необходимые экземпляры QPrinterInfo только по мере необходимости и всегда проверяйте их валидность перед вызовом.
Эта функция была добавлена в Qt 5.3.
[static] QList<QPrinterInfo> QPrinterInfo::availablePrinters()
Возвращает список объектов QPrinterInfo для всех доступных принтеров в этой системе.
НЕ рекомендуется использовать этот метод, так как создание каждого объекта принтера может занять много времени, особенно если есть удалённые принтеры по сети, и сохранённые экземпляры могут устареть, если будут внесены изменения в локальной системе или на удалённом сервере печати. Вместо этого используйте availablePrinterNames() и создавайте объекты принтера только по мере необходимости.
QPrinter::ColorMode QPrinterInfo::defaultColorMode() const
Возвращает режим цвета по умолчанию для этого принтера.
Эта функция была добавлена в Qt 5.13.
QPrinter::DuplexMode QPrinterInfo::defaultDuplexMode() const
Возвращает режим дуплексной печати по умолчанию для этого принтера.
Эта функция была добавлена в Qt 5.4.
QPageSize QPrinterInfo::defaultPageSize() const
Возвращает текущий размер страницы по умолчанию для этого принтера.
Эта функция была добавлена в Qt 5.3.
[static] QPrinterInfo QPrinterInfo::defaultPrinter()
Возвращает принтер по умолчанию в системе.
Значение возврата следует проверить с помощью isNull() перед использованием, на случай, если принтер по умолчанию отсутствует.
В некоторых системах могут быть доступные принтеры, но ни один из них не назначен принтером по умолчанию.
См. также isNull(), isDefault() и availablePrinters().
[static] QString QPrinterInfo::defaultPrinterName()
Возвращает текущее имя принтера по умолчанию.
Эта функция была добавлена в Qt 5.3.
QString QPrinterInfo::description() const
Возвращает описание принтера в удобочитаемой форме.
Эта функция была добавлена в Qt 5.0.
См. также QPrinterInfo::printerName().
bool QPrinterInfo::isDefault() const
Возвращает значение, указывающее, является ли данный принтер принтером по умолчанию.
bool QPrinterInfo::isNull() const
Возвращает значение, указывающее, содержит ли этот объект QPrinterInfo определение принтера.
Пустой объект QPrinterInfo может получиться, например, при вызове defaultPrinter() в случае отсутствия принтеров в системе.
bool QPrinterInfo::isRemote() const
Возвращает значение, указывающее, является ли этот принтер удаленным сетевым принтером.
Эта функция была добавлена в Qt 5.3.
QString QPrinterInfo::location() const
Возвращает удобочитаемое расположение принтера.
Эта функция была добавлена в Qt 5.0.
QString QPrinterInfo::makeAndModel() const
Возвращает удобочитаемую информацию о производителе и модели принтера.
Эта функция была добавлена в Qt 5.0.
QPageSize QPrinterInfo::maximumPhysicalPageSize() const
Возвращает максимальный физический размер страницы, поддерживаемый этим принтером.
Эта функция была добавлена в Qt 5.3.
См. также minimumPhysicalPageSize().
QPageSize QPrinterInfo::minimumPhysicalPageSize() const
Возвращает минимальный физический размер страницы, поддерживаемый этим принтером.
Эта функция была добавлена в Qt 5.3.
См. также maximumPhysicalPageSize().
[static] QPrinterInfo QPrinterInfo::printerInfo(const QString &printerName)
Возвращает принтер printerName.
Перед использованием возвращаемого значения необходимо проверить его с помощью isNull(), на случай, если принтер с указанным именем не существует.
Эта функция была добавлена в Qt 5.0.
См. также isNull().
QString QPrinterInfo::printerName() const
Возвращает имя принтера.
Это уникальный идентификатор для идентификации принтера и может быть не удобочитаемым.
См. также QPrinterInfo::description() и QPrinter::setPrinterName().
QPrinter::PrinterState QPrinterInfo::state() const
Возвращает текущее состояние принтера.
Это состояние может не всегда быть точным, в зависимости от платформы, драйвера принтера или самого принтера.
Эта функция была добавлена в Qt 5.3.
QList<QPrinter::ColorMode> QPrinterInfo::supportedColorModes() const
Возвращает поддерживаемые режимы цвета этого принтера.
Эта функция была добавлена в Qt 5.13.
QList<QPrinter::DuplexMode> QPrinterInfo::supportedDuplexModes() const
Возвращает список режимов дуплексной печати, поддерживаемых этим принтером.
Эта функция была добавлена в Qt 5.4.
QList<QPageSize> QPrinterInfo::supportedPageSizes() const
Возвращает список поддерживаемых размеров страниц этого принтера.
Эта функция была добавлена в Qt 5.3.
QList<int> QPrinterInfo::supportedResolutions() const
Возвращает список поддерживаемых разрешений принтера.
Эта функция была добавлена в Qt 5.3.
bool QPrinterInfo::supportsCustomPageSizes() const
Возвращает значение, указывающее, поддерживает ли этот принтер пользовательские размеры страниц.
Эта функция была добавлена в Qt 5.3.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qprinterinfo.html