QPrinterInfo 类

QPrinterInfo 类提供了访问现有打印机信息的方式。 更多...

头文件 #include <QPrinterInfo>
CMakefind_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmakeQT += printsupport

公共函数

QPrinterInfo()
QPrinterInfo(const QPrinter &printer)
QPrinterInfo(const QPrinterInfo &other)
~QPrinterInfo()
QPrinter::ColorModedefaultColorMode() const
QPrinter::DuplexModedefaultDuplexMode() const
QPageSizedefaultPageSize() const
QStringdescription() const
boolisDefault() const
boolisNull() const
boolisRemote() const
QStringlocation() const
QStringmakeAndModel() const
QPageSizemaximumPhysicalPageSize() const
QPageSizeminimumPhysicalPageSize() const
QStringprinterName() const
QPrinter::PrinterStatestate() const
QList<QPrinter::ColorMode>supportedColorModes() const
QList<QPrinter::DuplexMode>supportedDuplexModes() const
QList<QPageSize>supportedPageSizes() const
QList<int>supportedResolutions() const
boolsupportsCustomPageSizes() const
QPrinterInfo &operator=(const QPrinterInfo &other)

静态公共成员

QStringListavailablePrinterNames()
QList<QPrinterInfo>availablePrinters()
QPrinterInfodefaultPrinter()
QStringdefaultPrinterName()
QPrinterInfoprinterInfo(const QString &printerName)

详细描述

使用静态函数生成 QPrinterInfo 对象的列表。列表中的每个 QPrinterInfo 对象代表一个打印机,可以查询其名称、支持的纸张大小以及是否为默认打印机。

成员函数文档

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::descriptionQPrinter::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 公司及其在全球其他国家和地区的商标。所有其他商标均为各自所有者的财产。