QPrinterInfo 类
QPrinterInfo 类提供了访问现有打印机信息的方式。 更多...
头文件 | #include <QPrinterInfo> |
CMake | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
qmake | QT += printsupport |
- 所有成员列表,包括继承成员
- QPrinterInfo 是 打印和打印 API 的一部分。
公共函数
QPrinterInfo() | |
QPrinterInfo(const QPrinter &printer) | |
QPrinterInfo(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 |
QPrinterInfo & | operator=(const QPrinterInfo &other) |
静态公共成员
QStringList | availablePrinterNames() |
QList<QPrinterInfo> | availablePrinters() |
QPrinterInfo | defaultPrinter() |
QString | defaultPrinterName() |
QPrinterInfo | printerInfo(const QString &printerName) |
成员函数文档
QPrinterInfo::QPrinterInfo()
构造一个空的 QPrinterInfo 对象。
另请参阅 isNull().
[显式]
QPrinterInfo::QPrinterInfo(const QPrinter &printer)
从 printer 构造 QPrinterInfo 对象。
QPrinterInfo::QPrinterInfo(const QPrinterInfo &other)
复制 other。
[noexcept]
QPrinterInfo::~QPrinterInfo()
销毁 QPrinterInfo 对象。对象中的引用变为无效。
[静态]
QStringList QPrinterInfo::availablePrinterNames()
返回系统上所有可用的打印机制名称列表。
建议使用此方法代替 availablePrinters(),因为在大多数系统上它将更快。
请注意,如果本地系统或远程打印机服务器上进行了更改,列表可能会过时。仅在需要时实例化所需的 QPrinterInfo 实例,并在调用前始终检查其有效性。
[静态]
QList<QPrinterInfo> QPrinterInfo::availablePrinters()
返回系统上所有可用打印机的 QPrinterInfo 对象列表。
不建议使用此方法,因为创建每个打印机实例可能需要很长时间,特别是在有远程网络打印机的情况下,而且如果在本地系统或远程打印机服务器上进行更改,保留的实例可能会过时。建议使用 availablePrinterNames() 并且仅在需要时实例化打印机实例。
QPrinter::ColorMode QPrinterInfo::defaultColorMode() const
返回此打印机的默认颜色模式。
QPrinter::DuplexMode QPrinterInfo::defaultDuplexMode() const
返回此打印机的默认双面打印模式。
QPageSize QPrinterInfo::defaultPageSize() const
返回此打印机的当前默认页面大小。
[静态]
QPrinterInfo QPrinterInfo::defaultPrinter()
返回系统上的默认打印机。
在使用之前,应使用 isNull() 检查返回值,以防没有默认打印机。
在某些系统上可能存在可用的打印机,但没有一个被设置为默认打印机。
另请参阅 isNull(),isDefault(),以及 availablePrinters()。
[静态]
QString QPrinterInfo::defaultPrinterName()
返回当前默认打印机的名称。
QString QPrinterInfo::description() const
返回打印机的可读描述。
另请参阅 QPrinterInfo::printerName。
bool QPrinterInfo::isDefault() const
返回该打印机是否目前是默认打印机。
bool QPrinterInfo::isNull() const
返回此 QPrinterInfo 对象是否包含打印机定义。
例如,在没有打印机的情况下调用 defaultPrinter() 可能会产生一个空的 QPrinterInfo 对象。
bool QPrinterInfo::isRemote() const
返回该打印机是否是远程网络打印机。
QString QPrinterInfo::location() const
返回打印机的可读位置。
QString QPrinterInfo::makeAndModel() const
返回打印机的可读制造商和型号。
QPageSize QPrinterInfo::maximumPhysicalPageSize() const
返回该打印机支持的物理最大页面大小。
另请参阅 minimumPhysicalPageSize。
QPageSize QPrinterInfo::minimumPhysicalPageSize() const
返回该打印机支持的物理最小页面大小。
另请参阅 maximumPhysicalPageSize。
[静态]
QPrinterInfo QPrinterInfo::printerInfo(const QString &printerName)
返回指定的打印机 printerName。
在进行操作之前,应使用 isNull() 检查返回值,以防名称的打印机不存在。
另请参阅 isNull().
QString QPrinterInfo::printerName() const
返回打印机的名称。
这是一个唯一标识符,用于识别打印机,可能不适合人类阅读。
另请参阅 QPrinterInfo::description 和 QPrinter::setPrinterName。
QPrinter::PrinterState QPrinterInfo::state() const
返回打印机的当前状态。
此状态可能因平台、打印机驱动程序或打印机本身而有所不同,可能不总是准确。
QList<QPrinter::ColorMode> QPrinterInfo::supportedColorModes() const
返回支持的颜色模式。
QList<QPrinter::DuplexMode> QPrinterInfo::supportedDuplexModes() const
返回打印机支持的复式打印模式列表。
QList<QPageSize> QPrinterInfo::supportedPageSizes() const
返回打印机支持的纸张尺寸列表。
QList<int> QPrinterInfo::supportedResolutions() const
返回打印机支持的分辨率列表。
bool QPrinterInfo::supportsCustomPageSizes() const
返回该打印机是否支持自定义页尺寸。
QPrinterInfo &QPrinterInfo::operator=(const QPrinterInfo &other)
将 QPrinterInfo 对象设置为等于 other。
© 2024 Qt 公司有限。本文件中的文档贡献是各自所有者的版权。本文件提供的文档根据由自由软件基金会发布的 GNU 自由文档许可证版本 1.3 的条款进行许可。Qt 以及相应的标志是芬兰的 Qt 公司及其在全球其他国家和地区的商标。所有其他商标均为各自所有者的财产。