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 为空，则将创建一个自定义名称，格式为 "自定义（宽 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 调用QPageSize::sizePoints() 以找出PageSizeId 的实际点大小。

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

使用给定的matchPolicy 在units 中返回给定size 的标准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 Points（1/72 英寸）为单位返回页面矩形。

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

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

以所需的units 返回页面大小。

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

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

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

QSize QPageSize::sizePixels(int resolution) const

以设备像素（Device Pixels）为单位返回给定resolution 的页面大小。

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

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

以设备像素为单位，返回给定resolution 的标准pageSizeId 大小。

QSize QPageSize::sizePoints() const

以 Postscript Points（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)

Move-assignsother 到QPageSize 实例，将托管指针的所有权转移到该实例。

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

赋值运算符，为other 赋值。