QAbstractPrintDialog Class
QAbstractPrintDialog 类为用于配置打印机的打印对话框提供了基础实现。更多内容...
| 头文件： | #include <QAbstractPrintDialog> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake： | QT += printsupport |
| 继承自： | QDialog |
| 被继承类： |
- 所有成员列表（包括继承的成员）
- QAbstractPrintDialog 属于打印机和打印 API 的一部分。
公共类型
| enum | PrintDialogOption { PrintToFile, PrintSelection, PrintPageRange, PrintShowPageSize, PrintCollateCopies, PrintCurrentPage } |
| flags | PrintDialogOptions |
| enum | PrintRange { AllPages, Selection, PageRange, CurrentPage } |
公共函数
| QAbstractPrintDialog(QPrinter *printer, QWidget *parent = nullptr) | |
| int | fromPage() const |
| int | maxPage() const |
| int | minPage() const |
| QAbstractPrintDialog::PrintRange | printRange() const |
| QPrinter * | printer() const |
| void | setFromTo(int from, int to) |
| void | setMinMax(int min, int max) |
| void | setOptionTabs(const QList<QWidget *> &tabs) |
| void | setPrintRange(QAbstractPrintDialog::PrintRange range) |
| int | toPage() const |
详细说明
此类实现了用于自定义打印对话框中显示设置的获取器和设置器函数，但不能直接使用。请使用 `QPrintDialog ` 在您的应用程序中显示打印对话框。
另请参阅 QPrintDialog 和QPrinter 。
成员类型文档
enum QAbstractPrintDialog::PrintDialogOption
flags QAbstractPrintDialog::PrintDialogOptions
用于指定打印对话框中应显示哪些部分。
| 常量 | 值 | 描述 |
|---|---|---|
QAbstractPrintDialog::PrintToFile | 0x0001 | “打印到文件”选项已启用。 |
QAbstractPrintDialog::PrintSelection | 0x0002 | “打印选择”选项已启用。 |
QAbstractPrintDialog::PrintPageRange | 0x0004 | “页面范围选择”选项已启用。 |
QAbstractPrintDialog::PrintShowPageSize | 0x0008 | 仅当此选项已启用时，才会显示“页面尺寸 + 边距”页面。 |
QAbstractPrintDialog::PrintCollateCopies | 0x0010 | “整理副本”选项已启用 |
QAbstractPrintDialog::PrintCurrentPage | 0x0040 | “打印当前页面”选项已启用 |
PrintDialogOptions 类型是QFlags<PrintDialogOption> 的 typedef。它存储 PrintDialogOption 值的或（OR）组合。
enum QAbstractPrintDialog::PrintRange
用于指定打印范围选择选项。
| 常量 | 值 | 描述 |
|---|---|---|
QAbstractPrintDialog::AllPages | 0 | 应打印所有页面。 |
QAbstractPrintDialog::Selection | 1 | 仅应打印所选内容。 |
QAbstractPrintDialog::PageRange | 2 | 应打印指定的页面范围。 |
QAbstractPrintDialog::CurrentPage | 3 | 仅应打印当前可见的页面。 |
另请参阅 QPrinter::PrintRange 。
成员函数文档
[explicit] QAbstractPrintDialog::QAbstractPrintDialog(QPrinter *printer, QWidget *parent = nullptr)
为printer 构建一个抽象的打印对话框，其父控件为parent 。
int QAbstractPrintDialog::fromPage() const
返回要打印的第一页。默认情况下，该值设置为 0。
int QAbstractPrintDialog::maxPage() const
返回页面范围内的最大页面。从 Qt 4.4 开始，该函数默认返回 INT_MAX。早期版本默认返回 1。
int QAbstractPrintDialog::minPage() const
返回页面范围内的最小页码。默认情况下，该值设置为 1。
QAbstractPrintDialog::PrintRange QAbstractPrintDialog::printRange() const
返回打印范围。
另请参阅 setPrintRange()。
QPrinter *QAbstractPrintDialog::printer() const
返回此打印机对话框所操作的打印机。
void QAbstractPrintDialog::setFromTo(int from, int to)
将打印对话框中的范围设置为从from 到to 。
void QAbstractPrintDialog::setMinMax(int min, int max)
将此对话框中的页面范围设置为从min 到max 。这同时会启用“PrintPageRange ”选项。
void QAbstractPrintDialog::setOptionTabs(const QList<QWidget *> &tabs)
将一组小部件设置为tabs ，以便在打印对话框中显示（如果支持的话）。
目前，此选项仅在 X11 环境中受支持。
设置该选项后，相关选项卡的所有权将转移至打印对话框。
void QAbstractPrintDialog::setPrintRange(QAbstractPrintDialog::PrintRange range)
将打印范围选项设置为range 。
另请参阅 printRange()。
int QAbstractPrintDialog::toPage() const
返回最后打印的一页。默认情况下，该值设置为 0。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
