QPageSize 类

成员函数文档

QPageSize::QPageSize()

创建一个空的QPageSize。

QPageSize::QPageSize(QPageSize::PageSizeId pageSize)

创建一个标准pageSize的QPageSize。

如果pageSize是QPageSize::Custom，则生成的QPageSize将无效。请改用自定义大小构造函数。

[显式] QPageSize::QPageSize(const QSize &pointSize, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

使用匹配的matchPolicy创建一个点数pointSize的QPageSize。

如果给定的pointSize匹配标准QPageSize::PageSizeId，则将使用该页大小。请注意，如果matchPolicy是FuzzyMatch，则这可能导致pointSize调整为标准大小。要防止这种情况发生，请使用ExactMatch。

如果给定的pointSize不是标准QPageSize::PageSizeId，则创建一个QPageSize::Custom大小。

如果name为null，则使用标准的本地化名称。如果是自定义页面大小，则创建格式为"Custom (宽度 x 高度)"的自定义名称。

matchPolicy的默认值为FuzzyMatch。

[显式] QPageSize::QPageSize(const QSizeF &size, QPageSize::Unit units, const QString &name = QString(), QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

创建一个给定size和units的自定义页。

如果给定的尺寸与标准QPageSize::PageSizeId匹配，则将使用该页尺寸。注意，如果匹配策略是FuzzyMatch，这可能会导致尺寸进行调整以匹配标准尺寸。要防止这种情况发生，请使用匹配策略为ExactMatch。

如果给定的尺寸不是标准QPageSize::PageSizeId，则将创建一个QPageSize::Custom尺寸。原始单位尺寸将被保留并用作所有其他单位尺寸计算的基数。

如果名称为null，则将创建一个自定义名称，格式为"Custom (宽度 x 高度)"，其中尺寸以提供的单位表示。

QPageSize::QPageSize(const QPageSize &other)

复制构造函数，将other复制到本实例。

[noexcept] QPageSize::~QPageSize()

销毁页面。

QSizeF QPageSize::definitionSize() const

返回页面尺寸的定义尺寸。

对于标准页面尺寸，这将是在相关标准中定义的尺寸，例如，ISO A4将在毫米中定义，ANSI Letter将在英寸中定义。

对于自定义页面尺寸，这将是在创建页面尺寸对象时使用的原始尺寸。

如果QPageSize无效，则QSizeF将无效。

另请参阅definitionUnits()。

[static] QSizeF QPageSize::definitionSize(QPageSize::PageSizeId pageSizeId)

返回标准pageSizeId的定义尺寸。

要获取定义单位，请调用QPageSize::definitionUnits()。

QPageSize::Unit QPageSize::definitionUnits() const

返回页面尺寸的定义单位。

对于标准页面尺寸，这将是相关标准中定义的单位，例如，ISO A4将在毫米中定义，ANSI Letter将在英寸中定义。

对于自定义页面尺寸，这将是创建页面尺寸对象时使用的原始单位。

如果QPageSize无效，则QPageSize::Unit将无效。

另请参阅definitionSize()。

[static] QPageSize::Unit QPageSize::definitionUnits(QPageSize::PageSizeId pageSizeId)

返回标准pageSizeId的定义单位。

要获取定义尺寸，请调用QPageSize::definitionSize()。

QPageSize::PageSizeId QPageSize::id() const

返回页面标准QPageSize::PageSizeId或QPageSize::Custom。

如果QPageSize无效，则ID将为QPageSize::Custom。

[静态] QPageSize::PageSizeId QPageSize::id(const QSize &pointSize, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

使用给定的matchPolicy返回以磅为单位的给定pointSize的标准QPageSize::PageSizeId。

如果使用FuzzyMatch，则返回的PageSizeId的点大小可能与传入的pointSize不完全匹配。在执行任何计算之前，您应使用返回的PageSizeId调用QPageSize::sizePoints()以获取PageSizeId的实际点大小。

[静态] QPageSize::PageSizeId QPageSize::id(const QSizeF &size, QPageSize::Unit units, QPageSize::SizeMatchPolicy matchPolicy = FuzzyMatch)

使用给定的matchPolicy返回给定的size和units的标准QPageSize::PageSizeId。

如果使用FuzzyMatch，则返回的PageSizeId的单位大小可能与传入的size不完全匹配。在执行任何计算之前，您应使用返回的PageSizeId调用QPageSize::size()以获取PageSizeId的实际单位大小。

[静态] QPageSize::PageSizeId QPageSize::id(int windowsId)

返回给定Windows DMPAPER枚举值windowsId的PageSizeId。

如果没有匹配的PageSizeId，则返回QPageSize::Custom。

bool QPageSize::isEquivalentTo(const QPageSize &other) const

如果此页面等于other页面（即页面具有相同的尺寸，无论其他属性（如名称）如何），则返回true。

bool QPageSize::isValid() const

如果此页面大小有效，则返回true。

如果使用无效的PageSizeId创建、具有负值或无效的QSize或QSizeF，或调用null构造函数，则页面大小可能无效。

QString QPageSize::key() const

返回页面大小的唯一密钥。

默认情况下，这是页面大小的PPD标准mediaOption关键字，或PPD自定义格式密钥。如果QPageSize实例是从打印设备获得的，则这将是打印设备提供的密钥，可能不同于标准密钥。

如果 QPageSize 无效，则键将为空字符串。

此键绝不应该显示给最终用户，它仅是内部键。要使用人类可读的名称，请使用 name()。

另请参阅 name。

[静态] QString QPageSize::key(QPageSize::PageSizeId pageSizeId)

返回标准 pageSizeId 的 PPD 媒体选项关键字。

如果 QPageSize 无效，则键将为空。

QString QPageSize::name() const

返回页面大小的人类可读名称。

如果 QPageSize 实例是从打印设备获得的，则使用的名称是打印设备提供的。请注意，打印设备可能不支持当前默认区域语言的当前默认值。

如果 QPageSize 无效，则名称将为空字符串。

[静态] QString QPageSize::name(QPageSize::PageSizeId pageSizeId)

返回标准 pageSizeId 的本地化名称。

如果 QPageSize 无效，则名称将为空。

QRectF QPageSize::rect(QPageSize::Unit units) const

返回所需 units 的页面矩形。

如果 QPageSize 无效，则 QRect 将无效。

QRect QPageSize::rectPixels(int resolution) const

返回在给定 resolution 的设备象素中的页面矩形。

如果 QPageSize 无效，则 QRect 将无效。

QRect QPageSize::rectPoints() const

以 Postscript 点（1/72 英寸）为单位返回页面矩形。

如果 QPageSize 无效，则 QRect 将无效。

QSizeF QPageSize::size(QPageSize::Unit units) const

返回所需 units 中页面的尺寸。

如果QPageSize无效，则QSizeF将无效。

[静态] QSizeF QPageSize::size(QPageSize::PageSizeId pageSizeId, QPageSize::Unit units)

返回请求 units 的标准 pageSizeId 的大小。

QSize QPageSize::sizePixels(int resolution) const

返回在给定 resolution 的设备像素中的页面大小。

如果 QPageSize 无效，则 QSize 将无效。

[静态] QSize QPageSize::sizePixels(QPageSize::PageSizeId pageSizeId, int resolution)

返回给定resolution的默认pageSizeId在设备像素中的大小。

QSize QPageSize::sizePoints() const

以点为单位，返回页面的Postscript点大小（1/72英寸）。

如果 QPageSize 无效，则 QSize 将无效。

[静态] QSize QPageSize::sizePoints(QPageSize::PageSizeId pageSizeId)

返回标准pageSizeId的点大小。

[noexcept] void QPageSize::swap(QPageSize &other)

交换此QPageSize与other。此函数非常快速且从未失败。

int QPageSize::windowsId() const

返回纸张大小的Windows DMPAPER枚举值。

并非所有有效的PPD页面大小都有Windows等效值，在这种情况下将返回0。

如果QPageSize无效，则Windows ID将为0。

另请参阅id()。

[静态] int QPageSize::windowsId(QPageSize::PageSizeId pageSizeId)

返回标准pageSizeId的Windows DMPAPER枚举值。

并非所有有效的PPD页面大小都有Windows等效值，在这种情况下将返回0。

[noexcept] QPageSize &QPageSize::operator=(QPageSize &&other)

将other移动分配给此QPageSize实例，将管理指针的所有权转移到此实例。

QPageSize &QPageSize::operator=(const QPageSize &other)

赋值运算符，将other赋值给此对象。