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

프린터 옵션 선택 문자열을 반환합니다. 이 함수는 인쇄 명령이 명시적으로 설정된 경우에만 유용합니다.

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

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

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

setPrinterSelectionOption() 및 setPrintProgram()도 참조하세요 .

QPrinter::PrinterState QPrinter::printerState() const

프린터의 현재 상태를 반환합니다. 프린터에 운영 체제에 상태를 보고하는 기능이 없는 경우와 같이 항상 정확하지 않을 수 있습니다(예: 프린터에 상태를 보고할 수 없는 경우).

int QPrinter::resolution() const

setResolution() 또는 프린터 드라이버에서 설정한 프린터의 현재 가정 해상도를 반환합니다.

setResolution()도 참조하세요 .

void QPrinter::setCollateCopies(bool collate)

인쇄 대화 상자가 나타날 때 데이터 정렬 확인란의 기본값을 설정합니다. collate 가 참이면 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 이 참이면 전체 페이지에 페인팅을 지원하고, 그렇지 않으면 장치에서 보고한 인쇄 가능한 영역으로 페인팅을 제한합니다.

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

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

fullPage(), QPagedPaintDevice::pageLayout() 및 QPagedPaintDevice::setPageSize()도 참조하세요 .

void QPrinter::setOutputFileName(const QString &fileName)

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

널 또는 빈 이름(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의 경우, 이 함수는 항상 72(72dpi - PrinterMode 참조)와 같은 PDF 해상도만 포함된 하나의 항목 목록을 반환합니다.

bool QPrinter::supportsMultipleCopies() const

프린터가 한 작업에서 동일한 문서의 여러 복사본 인쇄를 지원하는 경우 true 을 반환하고, 그렇지 않으면 false를 반환합니다.

대부분의 시스템에서 이 함수는 참을 반환합니다. 그러나 CUPS를 지원하지 않는 X11 시스템에서는 이 함수가 false를 반환합니다. 즉, 애플리케이션이 동일한 문서를 필요한 횟수만큼 인쇄하여 사본 수를 처리해야 합니다.

setCopyCount() 및 copyCount()도 참조하세요 .

int QPrinter::toPage() const

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

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

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

setFromTo(), fromPage() 및 pageRanges()도 참조하세요 .