QPrinterInfo Class
QPrinterInfo 클래스는 기존 프린터에 대한 정보에 접근할 수 있게 해줍니다. 더 보기...
| 헤더: | #include <QPrinterInfo> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
- 상속된 멤버를 포함한 모든 멤버 목록
- QPrinterInfo는 프린터 및 인쇄 API의 일부입니다.
공개 함수
| 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) |
정적 공용 멤버
| QStringList | availablePrinterNames() |
| QList<QPrinterInfo> | availablePrinters() |
| QPrinterInfo | defaultPrinter() |
| QString | defaultPrinterName() |
| QPrinterInfo | printerInfo(const QString &printerName) |
상세 설명
정적 함수를 사용하여 QPrinterInfo 객체 목록을 생성합니다. 목록에 있는 각 QPrinterInfo 객체는 단일 프린터를 나타내며, 이름, 지원되는 용지 크기 및 기본 프린터 여부를 조회할 수 있습니다.
멤버 함수 설명
QPrinterInfo::QPrinterInfo()
빈 QPrinterInfo 객체를 생성합니다.
isNull()도 참조하십시오 .
[explicit] QPrinterInfo::QPrinterInfo(const QPrinter &printer)
printer 를 기반으로 QPrinterInfo 객체를 생성합니다.
QPrinterInfo::QPrinterInfo(const QPrinterInfo &other)
other 의 복사본을 생성합니다.
[noexcept] QPrinterInfo::~QPrinterInfo()
QPrinterInfo 객체를 삭제합니다. 이 객체의 값에 대한 참조는 더 이상 유효하지 않게 됩니다.
[static] QStringList QPrinterInfo::availablePrinterNames()
이 시스템에서 사용 가능한 모든 프린터 이름의 목록을 반환합니다.
대부분의 시스템에서 더 빠른 성능을 보여주므로, ` availablePrinters()` 대신 이 메서드를 사용하는 것이 좋습니다.
로컬 시스템이나 원격 인쇄 서버에서 변경 사항이 발생하면 목록이 최신 상태가 아닐 수 있습니다. 필요한 경우에만 QPrinterInfo 인스턴스를 생성하고, 호출하기 전에 항상 유효성을 확인하십시오.
[static] QList<QPrinterInfo> QPrinterInfo::availablePrinters()
이 시스템에서 사용 가능한 모든 프린터에 대한 ` QPrinterInfo ` 객체 목록을 반환합니다.
각 프린터 인스턴스를 생성하는 데 시간이 오래 걸릴 수 있으므로(특히 원격 네트워크 프린터가 있는 경우), 이 방법을 사용하는 것은 권장되지 않습니다. 또한 로컬 시스템이나 원격 인쇄 서버에서 변경 사항이 발생하면 유지된 인스턴스가 최신 상태가 아닐 수 있습니다. 대신 ` availablePrinterNames()`를 사용하고, 필요할 때만 프린터 인스턴스를 생성하십시오.
QPrinter::ColorMode QPrinterInfo::defaultColorMode() const
이 프린터의 기본 색상 모드를 반환합니다.
QPrinter::DuplexMode QPrinterInfo::defaultDuplexMode() const
이 프린터의 기본 양면 인쇄 모드를 반환합니다.
QPageSize QPrinterInfo::defaultPageSize() const
이 프린터의 현재 기본 페이지 크기를 반환합니다.
[static] QPrinterInfo QPrinterInfo::defaultPrinter()
시스템의 기본 프린터를 반환합니다.
기본 프린터가 없는 경우를 대비하여, 반환된 값을 사용하기 전에 ` isNull()`를 사용하여 확인해야 합니다.
일부 시스템에서는 사용 가능한 프린터가 있음에도 불구하고, 그중 어느 것도 기본 프린터로 설정되어 있지 않은 경우가 있을 수 있습니다.
isNull(), isDefault() 및 availablePrinters()도 참조하십시오 .
[static] QString QPrinterInfo::defaultPrinterName()
현재 기본 프린터 이름을 반환합니다.
QString QPrinterInfo::description() const
프린터에 대한 사람이 읽기 쉬운 설명을 반환합니다.
QPrinterInfo::printerName()도 참조하십시오 .
bool QPrinterInfo::isDefault() const
이 프린터가 현재 기본 프린터인지 여부를 반환합니다.
bool QPrinterInfo::isNull() const
이 QPrinterInfo 객체가 프린터 정의를 포함하고 있는지 여부를 반환합니다.
예를 들어, 시스템에 프린터가 없는 상태에서 defaultPrinter()를 호출하면 빈 QPrinterInfo 객체가 반환될 수 있습니다.
bool QPrinterInfo::isRemote() const
이 프린터가 원격 네트워크 프린터인지 여부를 반환합니다.
QString QPrinterInfo::location() const
프린터의 사람이 읽기 쉬운 위치를 반환합니다.
QString QPrinterInfo::makeAndModel() const
프린터의 사람 눈으로 읽기 쉬운 제조사와 모델을 반환합니다.
QPageSize QPrinterInfo::maximumPhysicalPageSize() const
이 프린터에서 지원하는 최대 물리적 페이지 크기를 반환합니다.
minimumPhysicalPageSize()도 참조하십시오 .
QPageSize QPrinterInfo::minimumPhysicalPageSize() const
이 프린터에서 지원하는 최소 물리적 페이지 크기를 반환합니다.
maximumPhysicalPageSize()도 참조하십시오 .
[static] QPrinterInfo QPrinterInfo::printerInfo(const QString &printerName)
printerName 를 반환합니다.
지정된 프린터가 존재하지 않을 경우를 대비하여, 사용 전에 isNull()을 사용하여 반환 값을 확인해야 합니다.
isNull()도 참조하십시오 .
QString QPrinterInfo::printerName() const
프린터의 이름을 반환합니다.
이는 프린터를 식별하는 고유 ID이며, 사람이 읽기 쉬운 형식이 아닐 수 있습니다.
QPrinterInfo::description() 및 QPrinter::setPrinterName()도 참조하십시오 .
QPrinter::PrinterState QPrinterInfo::state() const
이 프린터의 현재 상태를 반환합니다.
플랫폼, 프린터 드라이버 또는 프린터 자체에 따라 이 상태가 항상 정확한 것은 아닐 수 있습니다.
QList<QPrinter::ColorMode> QPrinterInfo::supportedColorModes() const
이 프린터에서 지원하는 색상 모드를 반환합니다.
QList<QPrinter::DuplexMode> QPrinterInfo::supportedDuplexModes() const
이 프린터에서 지원하는 양면 인쇄 모드 목록을 반환합니다.
QList<QPageSize> QPrinterInfo::supportedPageSizes() const
이 프린터에서 지원하는 페이지 크기 목록을 반환합니다.
QList<int> QPrinterInfo::supportedResolutions() const
이 프린터에서 지원하는 해상도 목록을 반환합니다.
bool QPrinterInfo::supportsCustomPageSizes() const
이 프린터가 사용자 지정 용지 크기를 지원하는지 여부를 반환합니다.
QPrinterInfo &QPrinterInfo::operator=(const QPrinterInfo &other)
QPrinterInfo 객체를 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.