Класс 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.0/qprinterinfo.html