En esta página

QPrinterInfo Class

La clase QPrinterInfo permite acceder a información sobre las impresoras existentes. Más información...

Encabezado: #include <QPrinterInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS PrintSupport)
target_link_libraries(mytarget PRIVATE Qt6::PrintSupport)
qmake: QT += printsupport

Funciones públicas

QPrinterInfo()
QPrinterInfo(const QPrinter &printer)
QPrinterInfo(const QPrinterInfo &other)
~QPrinterInfo()
QPrinter::ColorMode defaultColorMode() const
QPrinter::DuplexMode defaultDuplexMode() const
QPageSize defaultPageSize() const
QString description() const
bool isDefault() const
bool isNull() const
bool isRemote() const
QString location() const
QString makeAndModel() const
QPageSize maximumPhysicalPageSize() const
QPageSize minimumPhysicalPageSize() const
QString printerName() const
QPrinter::PrinterState state() const
QList<QPrinter::ColorMode> supportedColorModes() const
QList<QPrinter::DuplexMode> supportedDuplexModes() const
QList<QPageSize> supportedPageSizes() const
QList<int> supportedResolutions() const
bool supportsCustomPageSizes() const
QPrinterInfo &operator=(const QPrinterInfo &other)

Miembros públicos estáticos

QStringList availablePrinterNames()
QList<QPrinterInfo> availablePrinters()
QPrinterInfo defaultPrinter()
QString defaultPrinterName()
QPrinterInfo printerInfo(const QString &printerName)

Descripción detallada

Utilice las funciones estáticas para generar una lista de objetos QPrinterInfo. Cada objeto QPrinterInfo de la lista representa una impresora concreta y permite consultar su nombre, los tamaños de papel compatibles y si se trata o no de la impresora predeterminada.

Documentación de las funciones de miembro

QPrinterInfo::QPrinterInfo()

Crea un objeto QPrinterInfo vacío.

Véase también ` isNull()`.

[explicit] QPrinterInfo::QPrinterInfo(const QPrinter &printer)

Crea un objeto `QPrinterInfo` a partir de ` printer`.

QPrinterInfo::QPrinterInfo(const QPrinterInfo &other)

Crea una copia de other.

[noexcept] QPrinterInfo::~QPrinterInfo()

Elimina el objeto « QPrinterInfo ». Las referencias a los valores de dicho objeto dejan de ser válidas.

[static] QStringList QPrinterInfo::availablePrinterNames()

Devuelve una lista con todos los nombres de impresoras disponibles en este sistema.

Se recomienda utilizar esta función en lugar de ` availablePrinters()` ya que será más rápida en la mayoría de los sistemas.

Ten en cuenta que la lista puede quedar desactualizada si se realizan cambios en el sistema local o en el servidor de impresión remoto. Crea instancias de ` QPrinterInfo ` solo cuando sea necesario y comprueba siempre su validez antes de llamarlas.

[static] QList<QPrinterInfo> QPrinterInfo::availablePrinters()

Devuelve una lista de objetos ` QPrinterInfo ` correspondientes a todas las impresoras disponibles en este sistema.

NO se recomienda utilizar esta función, ya que la creación de cada instancia de impresora puede llevar mucho tiempo, especialmente si hay impresoras remotas conectadas en red, y las instancias conservadas pueden quedar desactualizadas si se realizan cambios en el sistema local o en el servidor de impresión remoto. Utiliza en su lugar availablePrinterNames() y crea instancias de impresora solo cuando las necesites.

QPrinter::ColorMode QPrinterInfo::defaultColorMode() const

Devuelve el modo de color predeterminado de esta impresora.

QPrinter::DuplexMode QPrinterInfo::defaultDuplexMode() const

Devuelve el modo dúplex predeterminado de esta impresora.

QPageSize QPrinterInfo::defaultPageSize() const

Devuelve el tamaño de página predeterminado actual para esta impresora.

[static] QPrinterInfo QPrinterInfo::defaultPrinter()

Devuelve la impresora predeterminada del sistema.

Se debe comprobar el valor devuelto mediante isNull() antes de utilizarlo, por si no hubiera ninguna impresora predeterminada.

En algunos sistemas es posible que haya impresoras disponibles, pero que ninguna de ellas esté configurada como impresora predeterminada.

Véase también isNull(), isDefault() y availablePrinters().

[static] QString QPrinterInfo::defaultPrinterName()

Devuelve el nombre de la impresora predeterminada actual.

QString QPrinterInfo::description() const

Devuelve la descripción legible para el usuario de la impresora.

Véase también QPrinterInfo::printerName().

bool QPrinterInfo::isDefault() const

Indica si esta impresora es actualmente la impresora predeterminada.

bool QPrinterInfo::isNull() const

Devuelve si este objeto ` QPrinterInfo ` contiene una definición de impresora.

Un objeto ` QPrinterInfo ` vacío podría ser el resultado, por ejemplo, de llamar a ` defaultPrinter()` cuando no hay impresoras en el sistema.

bool QPrinterInfo::isRemote() const

Devuelve si esta impresora es una impresora remota en red.

QString QPrinterInfo::location() const

Devuelve la ubicación de la impresora en formato legible para el usuario.

QString QPrinterInfo::makeAndModel() const

Devuelve la marca y el modelo de la impresora en un formato legible para el usuario.

QPageSize QPrinterInfo::maximumPhysicalPageSize() const

Devuelve el tamaño máximo de página física que admite esta impresora.

Véase también ` minimumPhysicalPageSize()`.

QPageSize QPrinterInfo::minimumPhysicalPageSize() const

Devuelve el tamaño mínimo de página física que admite esta impresora.

Véase también maximumPhysicalPageSize().

[static] QPrinterInfo QPrinterInfo::printerInfo(const QString &printerName)

Devuelve la impresora printerName.

Se debe comprobar el valor devuelto mediante isNull() antes de utilizarlo, por si la impresora indicada no existiera.

Véase también isNull().

QString QPrinterInfo::printerName() const

Devuelve el nombre de la impresora.

Se trata de un identificador único para identificar la impresora y puede que no sea legible para los usuarios.

Véase también QPrinterInfo::description() y QPrinter::setPrinterName().

QPrinter::PrinterState QPrinterInfo::state() const

Devuelve el estado actual de esta impresora.

Es posible que este estado no sea siempre exacto, dependiendo de la plataforma, el controlador de la impresora o la propia impresora.

QList<QPrinter::ColorMode> QPrinterInfo::supportedColorModes() const

Devuelve los modos de color compatibles con esta impresora.

QList<QPrinter::DuplexMode> QPrinterInfo::supportedDuplexModes() const

Devuelve una lista de los modos dúplex compatibles con esta impresora.

QList<QPageSize> QPrinterInfo::supportedPageSizes() const

Devuelve una lista de los tamaños de página compatibles con esta impresora.

QList<int> QPrinterInfo::supportedResolutions() const

Devuelve una lista de las resoluciones compatibles con esta impresora.

bool QPrinterInfo::supportsCustomPageSizes() const

Indica si esta impresora admite tamaños de página personalizados.

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

Establece el objeto ` QPrinterInfo ` para que sea igual a ` other`.

© 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.