Класс QPrinterInfo
Класс QPrinterInfo предоставляет доступ к информации о существующих принтерах. Подробнее...
| Заголовок: | #include <QPrinterInfo> |
| CMake: | find_package(Qt6 COMPONENTS PrintSupport REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
Открытые функции
| 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 |
Статические открытые члены
| QStringList | availablePrinterNames() |
| QList<QPrinterInfo> | availablePrinters() |
| QPrinterInfo | defaultPrinter() |
| QString | defaultPrinterName() |
| QPrinterInfo | printerInfo(const QString &printerName) |
Подробное описание
Используйте статические функции для генерации списка объектов QPrinterInfo. Каждый объект QPrinterInfo в списке представляет один принтер и может быть запрошен по имени, поддерживаемым размерам бумаги и является ли он принтером по умолчанию.
Документация функций-членов
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, since 5.3] QStringList QPrinterInfo::availablePrinterNames()
Возвращает список всех доступных имен принтеров в этой системе.
Рекомендуется использовать вместо availablePrinters(), так как это будет быстрее на большинстве систем.
Обратите внимание, что список может устареть, если вносились изменения на локальном компьютере или удаленном сервере печати. Создавайте экземпляры QPrinterInfo только по мере необходимости и всегда проверяйте их валидность перед вызовом.
Эта функция была добавлена в Qt 5.3.
[static] QList<QPrinterInfo> QPrinterInfo::availablePrinters()
Возвращает список объектов QPrinterInfo для всех доступных принтеров в этой системе.
Использование НЕ рекомендуется, так как создание каждого объекта принтера может занять много времени, особенно если есть удаленные сетевые принтеры, и сохраненные экземпляры могут устареть, если на локальной системе или удаленном сервере печати произошли изменения. Используйте availablePrinterNames() вместо этого и создавайте экземпляры принтеров только по мере необходимости.
[since 5.13] QPrinter::ColorMode QPrinterInfo::defaultColorMode() const
Возвращает режим цвета по умолчанию для этого принтера.
Эта функция была добавлена в Qt 5.13.
[since 5.4] QPrinter::DuplexMode QPrinterInfo::defaultDuplexMode() const
Возвращает режим дуплексной печати по умолчанию для этого принтера.
Эта функция была добавлена в Qt 5.4.
[since 5.3] QPageSize QPrinterInfo::defaultPageSize() const
Возвращает текущий размер страницы по умолчанию для этого принтера.
Эта функция была добавлена в Qt 5.3.
[static] QPrinterInfo QPrinterInfo::defaultPrinter()
Возвращает принтер по умолчанию в системе.
Возвращаемое значение следует проверять на isNull() перед использованием, на случай, если принтер по умолчанию отсутствует.
В некоторых системах могут быть доступные принтеры, но ни один из них не установлен как принтер по умолчанию.
См. также isNull(), isDefault() и availablePrinters().
[static, since 5.3] QString QPrinterInfo::defaultPrinterName()
Возвращает текущее имя принтера по умолчанию.
Эта функция была добавлена в Qt 5.3.
[since 5.0] QString QPrinterInfo::description() const
Возвращает удобочитаемое описание принтера.
Эта функция была добавлена в Qt 5.0.
См. также QPrinterInfo::printerName().
bool QPrinterInfo::isDefault() const
Возвращает значение, указывающее, является ли этот принтер в настоящее время принтером по умолчанию.
bool QPrinterInfo::isNull() const
Возвращает значение, указывающее, содержит ли этот объект QPrinterInfo определение принтера.
Пустой объект QPrinterInfo может получиться, например, при вызове defaultPrinter() в случае отсутствия принтеров в системе.
[since 5.3] bool QPrinterInfo::isRemote() const
Возвращает значение, указывающее, является ли этот принтер удаленным сетевым принтером.
Эта функция была добавлена в Qt 5.3.
[since 5.0] QString QPrinterInfo::location() const
Возвращает удобочитаемое расположение принтера.
Эта функция была добавлена в Qt 5.0.
[since 5.0] QString QPrinterInfo::makeAndModel() const
Возвращает удобочитаемую модель и производителя принтера.
Эта функция была добавлена в Qt 5.0.
[since 5.3] QPageSize QPrinterInfo::maximumPhysicalPageSize() const
Возвращает максимальный физический размер страницы, поддерживаемый этим принтером.
Эта функция была добавлена в Qt 5.3.
См. также minimumPhysicalPageSize().
[since 5.3] QPageSize QPrinterInfo::minimumPhysicalPageSize() const
Возвращает минимальный физический размер страницы, поддерживаемый этим принтером.
Эта функция была добавлена в Qt 5.3.
См. также maximumPhysicalPageSize().
[static, since 5.0] QPrinterInfo QPrinterInfo::printerInfo(const QString &printerName)
Возвращает принтер printerName.
Перед использованием возвращаемого значения необходимо проверить его с помощью isNull(), чтобы убедиться, что принтер с указанным именем существует.
Эта функция была добавлена в Qt 5.0.
См. также isNull().
QString QPrinterInfo::printerName() const
Возвращает имя принтера.
Это уникальный идентификатор принтера, который может быть не удобочитаемым.
См. также QPrinterInfo::description() и QPrinter::setPrinterName().
[since 5.3] QPrinter::PrinterState QPrinterInfo::state() const
Возвращает текущее состояние этого принтера.
Это состояние может не всегда быть точным, в зависимости от платформы, драйвера принтера или самого принтера.
Эта функция была добавлена в Qt 5.3.
[since 5.13] QList<QPrinter::ColorMode> QPrinterInfo::supportedColorModes() const
Возвращает поддерживаемые режимы цветности этого принтера.
Эта функция была добавлена в Qt 5.13.
[since 5.4] QList<QPrinter::DuplexMode> QPrinterInfo::supportedDuplexModes() const
Возвращает список режимов дуплексной печати, поддерживаемых этим принтером.
Эта функция была добавлена в Qt 5.4.
[since 5.3] QList<QPageSize> QPrinterInfo::supportedPageSizes() const
Возвращает список поддерживаемых размеров страниц этого принтера.
Эта функция была добавлена в Qt 5.3.
[since 5.3] QList<int> QPrinterInfo::supportedResolutions() const
Возвращает список поддерживаемых разрешений этого принтера.
Эта функция была добавлена в Qt 5.3.
[since 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-6.1/qprinterinfo.html