QPrinter Class

멤버 함수 설명

[explicit] QPrinter::QPrinter(QPrinter::PrinterMode mode = ScreenResolution)

지정된 ` mode`을 사용하여 새로운 프린터 객체를 생성합니다.

[explicit] QPrinter::QPrinter(const QPrinterInfo &printer, QPrinter::PrinterMode mode = ScreenResolution)

지정된 ` printer ` 및 ` mode`을 사용하여 새로운 프린터 객체를 생성합니다.

[virtual noexcept] QPrinter::~QPrinter()

프린터 객체를 파기하고 할당된 리소스를 모두 해제합니다. 인쇄 작업이 진행 중인 상태에서 프린터가 파기될 경우, 인쇄 작업에 영향을 미칠 수도 있고 미치지 않을 수도 있습니다.

bool QPrinter::abort()

현재 인쇄 작업을 중단합니다. 인쇄 작업이 성공적으로 중단된 경우 ` true `를 반환하고, ` printerState()`는 ` QPrinter::Aborted`를 반환하며, 그렇지 않은 경우 ` false`를 반환합니다.

인쇄 작업을 항상 중단할 수 있는 것은 아닙니다. 예를 들어, 모든 데이터가 프린터로 전송되었지만, 요청을 받았음에도 프린터가 작업을 취소할 수 없거나 취소하지 않는 경우가 있습니다.

bool QPrinter::collateCopies() const

‘다중 복사’가 선택된 상태에서 정렬 기능이 켜져 있으면 true 를 반환합니다. ‘다중 복사’가 선택된 상태에서 정렬 기능이 꺼져 있으면 false 를 반환합니다. 정렬 기능이 꺼져 있을 경우, 다음 페이지로 넘어가기 전에 각 페이지를 numCopies()만큼 반복해서 인쇄합니다. 정렬 기능이 켜져 있을 경우, 해당 페이지들의 다음 사본을 인쇄하기 전에 모든 페이지가 먼저 인쇄됩니다.

setCollateCopies()도 참조하십시오 .

QPrinter::ColorMode QPrinter::colorMode() const

현재 색상 모드를 반환합니다.

setColorMode()도 참조하십시오 .

int QPrinter::copyCount() const

인쇄될 사본 수를 반환합니다. 기본값은 1입니다.

setCopyCount() 및 supportsMultipleCopies()도 참조하십시오 .

QString QPrinter::creator() const

문서를 생성한 애플리케이션의 이름을 반환합니다.

setCreator()도 참조하십시오 .

QString QPrinter::docName() const

문서 이름을 반환합니다.

setDocName() 및 QPrintEngine::PrintEnginePropertyKey도 참조하십시오 .

QPrinter::DuplexMode QPrinter::duplex() const

현재의 이중 전송 모드를 반환합니다.

setDuplex()도 참조하십시오 .

bool QPrinter::fontEmbeddingEnabled() const

글꼴 임베딩이 활성화되어 있으면 true 를 반환합니다.

setFontEmbeddingEnabled()도 참조하십시오 .

int QPrinter::fromPage() const

인쇄할 페이지 범위 중 첫 번째 페이지의 번호를 반환합니다(“시작 페이지” 설정). 문서의 페이지 번호는 첫 번째 페이지를 1페이지로 하는 관례에 따라 매겨집니다.

기본적으로 이 함수는 0이라는 특수 값을 반환하며, 이는 "시작 페이지" 설정이 지정되지 않았음을 의미합니다.

setFromTo(), toPage(), pageRanges()도 참조하십시오 .

bool QPrinter::fullPage() const

프린터 좌표계의 원점이 페이지 모서리에 있는 경우 true 를 반환하고, 인쇄 가능 영역의 가장자리에 있는 경우 false를 반환합니다.

자세한 내용과 주의 사항은 setFullPage()을 참조하십시오.

setFullPage() 및 QPagedPaintDevice::pageLayout()도 참조하십시오 .

bool QPrinter::isValid() const

현재 선택된 프린터가 시스템에 등록된 유효한 프린터이거나 순수 PDF 프린터인 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

다른 오류를 감지하려면 QPainter::begin() 또는 QPrinter::newPage()의 출력 결과를 확인하십시오.

    QPrinter printer;
    printer.setOutputFormat(QPrinter::PdfFormat);
    printer.setOutputFileName("/foobar/nonwritable.pdf");
    QPainter painter;
    if (! painter.begin(&printer)) { // 파일 열기에 실패함
        qWarning("failed to open file, is it writable?");
       return 1;
    }
    painter.drawText(10, 10, "Test");
    if (! printer.newPage()) {
        qWarning("failed in flushing page to disk, disk full?");
       return 1;
    }
    painter.drawText(10, 10, "Test 2");
    painter.end();

setPrinterName()도 참조하십시오 .

[override virtual] bool QPrinter::newPage()

QPagedPaintDevice::newPage()를 재구현합니다.

프린터에 현재 페이지를 배출하고 새 페이지로 인쇄를 계속하도록 지시합니다. 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

비활성 상태인 QPrinter 객체에서 newPage()를 호출하면 항상 실패합니다.

QString QPrinter::outputFileName() const

출력 파일의 이름을 반환합니다. 기본적으로 이 값은 빈 문자열입니다(프린터가 파일에 출력해서는 안 됨을 나타냄).

setOutputFileName() 및 QPrintEngine::PrintEnginePropertyKey도 참조하십시오 .

QPrinter::OutputFormat QPrinter::outputFormat() const

이 프린터의 출력 형식을 반환합니다.

setOutputFormat()도 참조하십시오 .

QPrinter::PageOrder QPrinter::pageOrder() const

현재 페이지 순서를 반환합니다.

기본 페이지 순서는 ` FirstPageFirst`입니다.

setPageOrder()도 참조하십시오 .

QRectF QPrinter::pageRect(QPrinter::Unit unit) const

unit 로 표현된 페이지의 직사각형을 반환합니다. 일반적으로 페이지의 테두리와 용지 사이에는 여백이 있기 때문에, 이 값은 paperRect()에서 반환되는 값보다 작습니다.

QPagedPaintDevice::pageLayout()도 참조하십시오 .

[override virtual] QPaintEngine *QPrinter::paintEngine() const

QPaintDevice::paintEngine() const를 재구현합니다.

프린터에서 사용하는 페인트 엔진을 반환합니다.

QRectF QPrinter::paperRect(QPrinter::Unit unit) const

unit 로 표현된 용지의 직사각형을 반환합니다. 이 값은 일반적으로 pageRect()보다 큽니다.

pageRect()도 참조하십시오 .

QPrinter::PaperSource QPrinter::paperSource() const

프린터의 용지 공급원을 반환합니다. 이 값은 ‘ Manual ’이거나 프린터 용지함 또는 용지 카세트입니다.

setPaperSource()도 참조하십시오 .

QPagedPaintDevice::PdfVersion QPrinter::pdfVersion() const

이 프린터에 대한 PDF 버전을 반환합니다. 기본값은 PdfVersion_1_4 입니다.

setPdfVersion()도 참조하십시오 .

QPrintEngine *QPrinter::printEngine() const

프린터에서 사용하는 인쇄 엔진을 반환합니다.

QString QPrinter::printProgram() const

프린터로 출력 결과를 전송하는 프로그램의 이름을 반환합니다.

기본값은 빈 문자열을 반환하는 것으로, 즉 ` QPrinter `는 시스템에 따라 적절한 방식을 자동으로 선택하려고 시도합니다. X11 환경에서만 이 값을 다른 값으로 설정하여 특정 출력 프로그램을 사용할 수 있습니다. 다른 플랫폼에서는 빈 문자열을 반환합니다.

setPrintProgram() 및 setPrinterSelectionOption()도 참조하십시오 .

QPrinter::PrintRange QPrinter::printRange() const

QPrinter 의 페이지 범위를 반환합니다. 인쇄 설정 대화 상자가 열린 후, 이 함수는 사용자가 선택한 값을 반환합니다.

setPrintRange()도 참조하십시오 .

QString QPrinter::printerName() const

프린터 이름을 반환합니다. 이 값은 처음에 기본 프린터 이름으로 설정됩니다.

setPrinterName()도 참조하십시오 .

QString QPrinter::printerSelectionOption() const

프린터 옵션 선택 문자열을 반환합니다. 이 기능은 print 명령이 명시적으로 설정된 경우에만 유용합니다.

기본값(빈 문자열)은 시스템에 따라 프린터를 선택해야 함을 의미합니다.

그 외의 값은 지정된 값을 사용해야 함을 의미합니다.

이 함수는 Windows와 Mac에서는 항상 빈 문자열을 반환합니다.

setPrinterSelectionOption() 및 setPrintProgram()도 참조하십시오 .

QPrinter::PrinterState QPrinter::printerState() const

프린터의 현재 상태를 반환합니다. 이 정보가 항상 정확한 것은 아닙니다(예를 들어, 프린터가 운영 체제에 상태를 보고할 수 없는 경우 등).

int QPrinter::resolution() const

setResolution() 함수나 프린터 드라이버를 통해 설정된 프린터의 현재 가정 해상도를 반환합니다.

setResolution()도 참조하십시오 .

void QPrinter::setCollateCopies(bool collate)

인쇄 대화 상자가 표시될 때 ‘정렬’ 확인란의 기본값을 설정합니다. collate 가 true인 경우, setCollateCopiesEnabled()가 활성화됩니다. 기본값은 false입니다. 이 값은 사용자가 인쇄 대화 상자에서 선택한 내용에 따라 변경됩니다.

collateCopies()도 참조하십시오 .

void QPrinter::setColorMode(QPrinter::ColorMode newColorMode)

프린터의 색상 모드를 ‘ newColorMode ’로 설정합니다. 이 값은 ‘ Color ’ 또는 ‘ GrayScale ’ 중 하나일 수 있습니다.

colorMode()도 참조하십시오 .

void QPrinter::setCopyCount(int count)

인쇄할 부수 수를 ‘ count ’로 설정합니다.

프린터 드라이버는 이 설정을 읽어들이고 지정된 부수만큼 인쇄합니다.

copyCount() 및 supportsMultipleCopies()도 참조하십시오 .

void QPrinter::setCreator(const QString &creator)

문서를 생성한 애플리케이션의 이름을 ` creator`로 설정합니다.

이 함수는 Qt의 X11 버전에서만 사용할 수 있습니다. 생성자 이름이 지정되지 않은 경우, 생성자는 "Qt" 뒤에 버전 번호가 붙은 형태로 설정됩니다.

creator()도 참조하십시오 .

void QPrinter::setDocName(const QString &name)

문서 이름을 name 로 설정합니다.

X11 환경에서 문서 이름은 예를 들어 QPrintDialog 의 기본 출력 파일 이름으로 사용됩니다. 프린터가 파일로 출력하는 경우 문서 이름이 파일 이름에 영향을 미치지 않는다는 점에 유의하십시오. 이 경우 setOutputFile() 함수를 사용하십시오.

docName() 및 QPrintEngine::PrintEnginePropertyKey도 참조하십시오 .

void QPrinter::setDuplex(QPrinter::DuplexMode duplex)

duplex 모드를 기반으로 양면 인쇄를 활성화합니다.

duplex()도 참조하십시오 .

[protected] void QPrinter::setEngines(QPrintEngine *printEngine, QPaintEngine *paintEngine)

이 함수는 ` QPrinter `의 하위 클래스에서 사용자 정의 출력 및 페인트 엔진(각각 `printEngine ` 및 ` paintEngine`)을 지정하는 데 사용됩니다.

QPrinter 이 함수는 엔진의 소유권을 인수하지 않으므로, 이러한 엔진 인스턴스는 직접 관리해야 합니다.

엔진을 변경하면 프린터 상태와 모든 속성이 재설정된다는 점에 유의하십시오.

printEngine(), paintEngine() 및 setOutputFormat()도 참조하십시오 .

void QPrinter::setFontEmbeddingEnabled(bool enable)

enable 에 따라 글꼴 임베딩을 활성화하거나 비활성화합니다.

fontEmbeddingEnabled()도 참조하십시오 .

void QPrinter::setFromTo(int from, int to)

from 및 to 로 지정된 번호가 붙은 페이지들을 포함하도록 인쇄할 페이지 범위를 설정합니다. 여기서 from 는 해당 범위의 첫 번째 페이지에 해당하고, to 는 마지막 페이지에 해당합니다.

이 함수는 주로 setup()을 호출할 때 사용자가 인쇄 대화 상자에서 재정의할 수 있는 기본값을 설정하는 데 사용됩니다.

fromPage(), toPage(), pageRanges()도 참조하십시오 .

void QPrinter::setFullPage(bool fp)

fp 가 true인 경우, 페이지 전체에 대한 그리기 기능을 지원하며, 그렇지 않은 경우 기기에서 보고하는 인쇄 가능 영역으로만 그리기를 제한합니다.

기본적으로 전체 페이지 인쇄는 비활성화되어 있습니다. 이 경우, ` QPrinter`의 좌표계 원점은 인쇄 가능 영역의 왼쪽 상단 모서리와 일치합니다.

전체 페이지 인쇄가 활성화된 경우, QPrinter 의 좌표계 원점은 용지 자체의 왼쪽 상단 모서리와 일치합니다. 이 경우, device metrics 는 {QPageSize}에 표시된 것과 정확히 동일한 치수를 보고합니다. 프린터의 여백으로 인해 물리적 페이지 전체에 인쇄하는 것이 불가능할 수 있으므로, 애플리케이션에서 여백을 직접 고려해야 합니다.

fullPage(), QPagedPaintDevice::pageLayout(), QPagedPaintDevice::setPageSize()도 참조하십시오 .

void QPrinter::setOutputFileName(const QString &fileName)

출력 파일 이름을 fileName 로 설정합니다.

이름을 null 또는 빈 문자열(0 또는 "")로 설정하면 파일로 출력하는 기능이 비활성화됩니다. 비어 있지 않은 이름을 설정하면 파일로 출력하는 기능이 활성화됩니다.

이 설정은 outputFormat()의 값을 변경할 수 있습니다. 파일 이름에 ".pdf" 확장자가 있으면 PDF가 생성됩니다. 파일 이름에 ".pdf" 이외의 확장자가 있으면, setOutputFormat()로 설정된 출력 형식이 사용됩니다.

QPrinter 각각 Qt의 크로스 플랫폼 PDF 인쇄 엔진을 사용합니다. 이 형식을 네이티브로 생성할 수 있는 경우(예: macOS는 자체 인쇄 엔진을 통해 PDF를 생성할 수 있음), 출력 형식을 다시 NativeFormat 로 설정하십시오.

outputFileName() 및 setOutputFormat()도 참조하십시오 .

void QPrinter::setOutputFormat(QPrinter::OutputFormat format)

이 프린터의 출력 형식을 ‘ format ’로 설정합니다.

format 가 현재 설정된 값과 동일할 경우 변경 사항이 적용되지 않습니다.

format 가 NativeFormat 인 경우, printerName 가 기본 프린터로 설정됩니다. 유효한 프린터가 구성되어 있지 않으면 변경 사항이 적용되지 않습니다. NativeFormat 를 특정 printerName 로 설정하려면 setPrinterName()를 사용하십시오.

outputFormat() 및 setPrinterName()도 참조하십시오 .

void QPrinter::setPageOrder(QPrinter::PageOrder pageOrder)

페이지 순서를 pageOrder 로 설정합니다.

페이지 순서는 QPrinter::FirstPageFirst 또는 QPrinter::LastPageFirst 일 수 있습니다. 애플리케이션은 페이지 순서를 읽어들이고 그에 따라 인쇄할 책임이 있습니다.

이 함수는 주로 사용자가 인쇄 대화 상자에서 재정의할 수 있는 기본값을 설정하는 데 유용합니다.

이 함수는 X11 환경에서만 지원됩니다.

pageOrder()도 참조하십시오 .

void QPrinter::setPaperSource(QPrinter::PaperSource source)

용지 공급원 설정을 ‘ source ’으로 설정합니다.

Windows 전용: 이 옵션은 인쇄 중에 변경할 수 있으며, 다음에 newPage()를 호출할 때부터 적용됩니다.

paperSource()도 참조하십시오 .

void QPrinter::setPdfVersion(QPagedPaintDevice::PdfVersion version)

이 프린터의 PDF 버전을 ‘ version ’으로 설정합니다.

version 가 현재 설정된 값과 동일한 경우 변경 사항이 적용되지 않습니다.

pdfVersion()도 참조하십시오 .

void QPrinter::setPrintProgram(const QString &printProg)

인쇄 작업을 수행할 프로그램의 이름을 ` printProg`로 설정합니다.

X11 환경에서는 이 함수가 PDF 출력 시 호출할 프로그램을 설정합니다. 다른 플랫폼에서는 아무런 효과가 없습니다.

printProgram()도 참조하십시오 .

void QPrinter::setPrintRange(QPrinter::PrintRange range)

인쇄 범위 옵션을 range 로 설정합니다.

printRange()도 참조하십시오 .

void QPrinter::setPrinterName(const QString &name)

프린터 이름을 ‘ name ’로 설정합니다.

name 가 비어 있는 경우 출력 형식은 PdfFormat 로 설정됩니다.

name 가 유효한 프린터가 아닌 경우 변경 사항이 적용되지 않습니다.

name 가 유효한 프린터인 경우, 출력 형식은 NativeFormat 로 설정됩니다.

printerName(), isValid(), setOutputFormat()도 참조하십시오 .

void QPrinter::setPrinterSelectionOption(const QString &option)

프린터 선택에 ` option `를 사용하도록 프린터를 설정합니다. ` option `는 기본적으로 null이며(이는 Qt가 올바르게 추측할 수 있을 만큼 지능적이어야 함을 의미합니다), 특정 프린터 선택 옵션을 사용하려면 다른 값으로 설정할 수 있습니다.

프린터가 활성화된 상태에서 프린터 선택 옵션이 변경되면, 현재 인쇄 작업에 영향을 미칠 수도 있고 미치지 않을 수도 있습니다.

이 함수는 Windows나 Mac에서는 아무런 효과가 없습니다.

printerSelectionOption() 및 setPrintProgram()도 참조하십시오 .

void QPrinter::setResolution(int dpi)

프린터가 dpi 또는 dpi 에 최대한 가깝게 출력하도록 요청합니다.

이 설정은 예를 들어 QPainter::viewport() 함수가 반환하는 좌표계에 영향을 미칩니다.

모든 플랫폼에서 이 설정이 적용되려면 QPainter::begin()을 호출하기 전에 이 함수를 호출해야 합니다.

resolution() 및 QPagedPaintDevice::setPageSize()도 참조하십시오 .

QList<QPrinter::PaperSource> QPrinter::supportedPaperSources() const

이 프린터에서 지원하는 용지 크기를 반환합니다.

반환값은 ` QPrinter::PaperSource ` 열거형 항목 중 하나와 일치하는 값이거나 드라이버별 값입니다. 드라이버별 값은 `wingdi.h`에 선언된 상수 `DMBIN_USER`보다 큽니다.

QList<int> QPrinter::supportedResolutions() const

프린터가 지원한다고 표시하는 해상도(인치당 도트 수를 나타내는 정수 목록) 목록을 반환합니다.

모든 인쇄가 PDF로 직접 이루어지는 X11 환경에서는, 이 함수는 항상 PDF 해상도, 즉 72(72 dpi – 단, PrinterMode 참조)만 포함하는 단일 항목 리스트를 반환합니다.

bool QPrinter::supportsMultipleCopies() const

프린터가 하나의 작업으로 동일한 문서를 여러 부 인쇄하는 기능을 지원하는 경우 ` true `를 반환하고, 그렇지 않은 경우 `false`를 반환합니다.

대부분의 시스템에서 이 함수는 true를 반환합니다. 그러나 CUPS를 지원하지 않는 X11 시스템에서는 이 함수가 false를 반환합니다. 즉, 응용 프로그램에서 필요한 횟수만큼 동일한 문서를 인쇄하여 부수 수를 처리해야 합니다.

setCopyCount() 및 copyCount()도 참조하십시오 .

int QPrinter::toPage() const

인쇄할 페이지 범위 중 마지막 페이지의 번호(“종료 페이지” 설정)를 반환합니다. 문서의 페이지 번호는 첫 번째 페이지를 1페이지로 하는 규칙에 따라 매겨집니다.

기본적으로 이 함수는 0이라는 특수 값을 반환하며, 이는 “종료 페이지” 설정이 지정되지 않았음을 의미합니다.

프로그래머는 이 설정을 읽고 그에 따라 인쇄할 책임이 있습니다.

setFromTo(), fromPage() 및 pageRanges()도 참조하십시오 .