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 |
- Lista de todos los miembros, incluidos los heredados
- QPrinterInfo forma parte de las API de impresoras e impresión.
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.