Класс QPrinterInfo
Класс QPrinterInfo предоставляет доступ к информации о существующих принтерах. Подробнее...
| Заголовок: | #include <QPrinterInfo> |
| qmake: | QT += printsupport |
| С момента: | Qt 4.4 |
Открытые функции
| QPrinterInfo() | |
| QPrinterInfo(const QPrinterInfo &other) | |
| QPrinterInfo(const QPrinter &printer) | |
| ~QPrinterInfo() | |
| 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::DuplexMode> | supportedDuplexModes() const |
| QList<QPageSize> | supportedPageSizes() const |
| QList<int> | supportedResolutions() const |
| bool | supportsCustomPageSizes() const |
| QPrinterInfo & | operator=(const QPrinterInfo &other) |
Статические открытые члены
| QStringList | availablePrinterNames() |
| QList<QPrinterInfo> | availablePrinters() |
| QPrinterInfo | defaultPrinter() |
| QString | defaultPrinterName() |
| QPrinterInfo | printerInfo(const QString &printerName) |
Подробное описание
Класс QPrinterInfo предоставляет доступ к информации о существующих принтерах.
Используйте статические функции для создания списка объектов QPrinterInfo. Каждый объект QPrinterInfo в списке представляет один принтер и может быть запрошен для получения имени, поддерживаемых размеров бумаги и того, является ли он принтером по умолчанию.
Документация по функциям-членам
QPrinterInfo::QPrinterInfo()
Создаёт пустой объект QPrinterInfo.
См. также isNull().
QPrinterInfo::QPrinterInfo(const QPrinterInfo &other)
Создаёт копию other.
QPrinterInfo::QPrinterInfo(const QPrinter &printer)
Создаёт объект QPrinterInfo из printer.
QPrinterInfo::~QPrinterInfo()
Удаляет объект QPrinterInfo. Ссылки на значения в объекте становятся недействительными.
QStringList QPrinterInfo::availablePrinterNames()
Возвращает список всех доступных имён принтеров в этой системе.
Рекомендуется использовать вместо availablePrinters(), так как это будет быстрее на большинстве систем.
Обратите внимание, что список может стать устаревшим, если внесены изменения в локальную систему или удалённый сервер печати. Создавайте необходимые экземпляры QPrinterInfo только тогда, когда это необходимо, и всегда проверяйте его корректность перед вызовом.
Функция была введена в Qt 5.3.
QList<QPrinterInfo> QPrinterInfo::availablePrinters()
Возвращает список объектов QPrinterInfo для всех доступных принтеров в этой системе.
Не рекомендуется использовать, так как создание каждого экземпляра принтера может занять много времени, особенно если есть удалённые принтеры по сети, и сохранённые экземпляры могут стать устаревшими, если внесены изменения в локальную систему или удалённый сервер печати. Используйте availablePrinterNames() вместо этого и создавайте экземпляры принтеров только по мере необходимости.
QPrinter::DuplexMode QPrinterInfo::defaultDuplexMode() const
Возвращает режим дуплексной печати по умолчанию для этого принтера.
Функция была введена в Qt 5.4.
QPageSize QPrinterInfo::defaultPageSize() const
Возвращает текущий размер страницы по умолчанию для этого принтера.
Функция была введена в Qt 5.3.
QPrinterInfo QPrinterInfo::defaultPrinter()
Возвращает принтер по умолчанию в системе.
Результат нужно проверить с помощью isNull() перед использованием, на случай, если принтер по умолчанию отсутствует.
На некоторых системах могут быть доступные принтеры, но ни один из них не задан как принтер по умолчанию.
См. также isNull(), isDefault() и availablePrinters().
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::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
Возвращает значение true, если этот принтер поддерживает пользовательские размеры страниц, иначе false.
Эта функция была введена в Qt 5.3.
QPrinterInfo &QPrinterInfo::operator=(const QPrinterInfo &other)
Устанавливает объект QPrinterInfo равным other.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qprinterinfo.html