QPageSize Class

成员函数文档

QPageSize::QPageSize()

创建一个为空的 QPageSize。

QPageSize::QPageSize(QPageSize::PageSizeId pageSize)

创建一个标准pageSize 格式的QPageSize对象。

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

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

使用匹配的matchPolicy ，根据给定的pointSize （以点为单位）创建一个QPageSize。

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

如果给定的pointSize 不是标准页面尺寸（QPageSize::PageSizeId ），则会创建一个QPageSize::Custom 尺寸。

如果name 为空，则使用标准本地化名称。如果是自定义页面尺寸，则会创建格式为“自定义 (宽度 x 高度)”的自定义名称。

matchPolicy 的默认值为FuzzyMatch 。

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

在units 中创建指定size 的自定义页面。

如果给定的size 与标准QPageSize::PageSizeId 匹配，则将使用该页面尺寸。请注意，如果matchPolicy 为FuzzyMatch ，这可能会导致size 被调整为标准尺寸。为防止这种情况发生，请改用matchPolicy 值ExactMatch 。

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

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

QPageSize::QPageSize(const QPageSize &other)

复制构造函数，将 `other ` 复制到 `this` 中。

[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 。

[static] QPageSize::PageSizeId QPageSize::id(int windowsId)

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

如果不存在匹配的PageSizeId ，则返回QPageSize::Custom 。

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

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

如果使用FuzzyMatch ，则返回的PageSizeId 的点大小可能与您传入的pointSize 不完全一致。在将PageSizeId 用于任何计算之前，您应使用返回的PageSizeId 调用QPageSize::sizePoints()，以确定 的实际点大小。

[static] 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 的实际单位大小。

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

如果该页面与other 页面等价，即无论名称等其他属性如何，该页面的尺寸都与之相同，则返回true 。

bool QPageSize::isValid() const

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

如果使用无效的 `PageSizeId` 创建页面大小，或者 `QSize ` 或 `QSizeF` 为负数或无效，或者使用了空构造函数，则该页面大小可能无效。

QString QPageSize::key() const

返回页面大小的唯一键。

默认情况下，这是 PPD 标准 mediaOption 关键字对应的页面大小，或是 PPD 自定义格式键。如果QPageSize 实例是从打印设备获取的，则此处将使用打印设备提供的键，该键可能与标准键不同。

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

该键绝不应显示给最终用户，它仅作为内部键使用。如需可读名称，请使用name()。

另请参阅 name()。

[static] QString QPageSize::key(QPageSize::PageSizeId pageSizeId)

返回标准pageSizeId 中的PPD mediaOption关键字。

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

QString QPageSize::name() const

返回页面大小的本地化、易于阅读的名称。

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

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

[static] 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 也将无效。

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

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

QSize QPageSize::sizePixels(int resolution) const

返回给定resolution 处页面以设备像素为单位的尺寸。

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

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

返回给定resolution 在标准pageSizeId 中的尺寸（以设备像素为单位）。

QSize QPageSize::sizePoints() const

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

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

[static] 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()。

[static] int QPageSize::windowsId(QPageSize::PageSizeId pageSizeId)

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

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

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

将other 通过“move-assign”操作赋值给此QPageSize 实例，从而将该受管指针的所有权转移至该实例。

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

赋值运算符，将other 赋值给this。