QPrintDialog Class
La clase QPrintDialog ofrece un cuadro de diálogo para especificar la configuración de la impresora. Más información...
| Encabezado: | #include <QPrintDialog> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
| Heredado de: | QAbstractPrintDialog |
- Lista de todos los miembros, incluidos los heredados
- QPrintDialog forma parte de los diálogos estándar y de las API de impresoras e impresión.
Propiedades
- options : PrintDialogOptions
Funciones públicas
| QPrintDialog(QWidget *parent = nullptr) | |
| QPrintDialog(QPrinter *printer, QWidget *parent = nullptr) | |
| virtual | ~QPrintDialog() |
| void | open(QObject *receiver, const char *member) |
| QAbstractPrintDialog::PrintDialogOptions | options() const |
| QPrinter * | printer() |
| void | setOption(QAbstractPrintDialog::PrintDialogOption option, bool on = true) |
| void | setOptions(QAbstractPrintDialog::PrintDialogOptions options) |
| bool | testOption(QAbstractPrintDialog::PrintDialogOption option) const |
Funciones públicas reimplementadas
| virtual void | done(int result) override |
| virtual int | exec() override |
| virtual void | setVisible(bool visible) override |
Señales
| void | accepted(QPrinter *printer) |
Descripción detallada
El cuadro de diálogo permite a los usuarios modificar la configuración relacionada con el documento, como el tamaño y la orientación del papel, el tipo de impresión (en color o en escala de grises), el rango de páginas y el número de copias que se van a imprimir.
También se proporcionan controles para que los usuarios puedan elegir entre las impresoras disponibles, incluidas las impresoras de red configuradas.
Normalmente, los objetos `QPrintDialog` se crean con un objeto ` QPrinter ` y se ejecutan mediante la función ` exec()`.
QPrintDialog printDialog(printer, parent);
if (printDialog.exec() == QDialog::Accepted) {
// print ...
}Si el usuario acepta el cuadro de diálogo, el objeto ` QPrinter ` queda correctamente configurado para la impresión.
![]() | ![]() |
El cuadro de diálogo de impresión (mostrado arriba en estilo Plastique) permite acceder a las propiedades de impresión habituales. En plataformas X11 que utilizan el sistema de impresión CUPS, la configuración de cada impresora disponible puede modificarse mediante el botón « Properties » del cuadro de diálogo.
En Windows y macOS se utiliza el cuadro de diálogo de impresión nativo, lo que significa que algunas propiedades de QWidget y QDialog establecidas en el cuadro de diálogo no se respetarán. El cuadro de diálogo de impresión nativo de macOS no admite la configuración de opciones de impresora, es decir, setOptions() y setOption() no tienen ningún efecto.
En Qt 4.4, era posible utilizar las funciones estáticas para mostrar una hoja en macOS. Esto ya no es compatible en Qt 4.5. Si desea esta funcionalidad, utilice QPrintDialog::open().
Véase también QPageSetupDialog y QPrinter.
Documentación de propiedades
options : PrintDialogOptions
Esta propiedad contiene las distintas opciones que influyen en el aspecto y el comportamiento del cuadro de diálogo
Por defecto, todas las opciones están desactivadas.
Las opciones deben configurarse antes de mostrar el cuadro de diálogo. No se garantiza que su configuración mientras el cuadro de diálogo está visible tenga un efecto inmediato en este (dependiendo de la opción y de la plataforma).
Funciones de acceso:
| QAbstractPrintDialog::PrintDialogOptions | options() const |
| void | setOptions(QAbstractPrintDialog::PrintDialogOptions options) |
Véase también setOption() y testOption().
Documentación de funciones de miembro
[explicit] QPrintDialog::QPrintDialog(QWidget *parent = nullptr)
Crea un cuadro de diálogo de impresión con el archivo « parent » indicado.
[explicit] QPrintDialog::QPrintDialog(QPrinter *printer, QWidget *parent = nullptr)
Crea un nuevo cuadro de diálogo modal de impresión para el objeto ` printer ` indicado con el objeto ` parent` indicado.
[virtual noexcept] QPrintDialog::~QPrintDialog()
Cierra el cuadro de diálogo de impresión.
[signal] void QPrintDialog::accepted(QPrinter *printer)
Esta señal se emite cuando el usuario acepta los valores establecidos en el cuadro de diálogo de impresión. El parámetro « printer » incluye la impresora a la que se han aplicado los ajustes.
[override virtual] void QPrintDialog::done(int result)
Reimplementa: ` QDialog::done(int r)`.
Cierra el cuadro de diálogo y establece su código de resultado en ` result`. Si este cuadro de diálogo se muestra con ` exec()`, `done()` provoca que finalice el bucle de eventos local y que ` exec()` devuelva ` result`.
Nota: Esta función no se aplica al cuadro de diálogo de impresión nativo en las plataformas Mac macOS y Windows, ya que dicho cuadro de diálogo debe ser modal y solo el usuario puede cerrarlo.
Véase también QDialog::done().
[override virtual] int QPrintDialog::exec()
Reimplementa: QDialog::exec().
void QPrintDialog::open(QObject *receiver, const char *member)
Abre el cuadro de diálogo y conecta su señal « accepted()» a las ranuras especificadas en « receiver » y « member ».
La señal se desconectará de la ranura cuando se cierre el cuadro de diálogo.
QPrinter *QPrintDialog::printer()
Devuelve la impresora sobre la que opera este cuadro de diálogo de impresión. Esto puede resultar útil al utilizar el método QPrintDialog::open().
void QPrintDialog::setOption(QAbstractPrintDialog::PrintDialogOption option, bool on = true)
Establece que el option especificado esté activado si on es verdadero; en caso contrario, desactiva el option especificado.
Véase también options y testOption().
[override virtual] void QPrintDialog::setVisible(bool visible)
Reimplementa: ` QDialog::setVisible` (bool visible).
bool QPrintDialog::testOption(QAbstractPrintDialog::PrintDialogOption option) const
Devuelve « true » si el « option » indicado está habilitado; en caso contrario, devuelve «false».
© 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.

