이 페이지에서

QTextDocumentWriter Class

QTextDocumentWriter 클래스는 QTextDocument QTextDocument 를 파일이나 다른 장치에 기록하기 위한 형식 독립적인 인터페이스를 제공합니다. 더 보기...

헤더: #include <QTextDocumentWriter>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

공개 함수

QTextDocumentWriter()
QTextDocumentWriter(QIODevice *device, const QByteArray &format)
QTextDocumentWriter(const QString &fileName, const QByteArray &format = QByteArray())
~QTextDocumentWriter()
QIODevice *device() const
QString fileName() const
QByteArray format() const
void setDevice(QIODevice *device)
void setFileName(const QString &fileName)
void setFormat(const QByteArray &format)
bool write(const QTextDocument *document)
bool write(const QTextDocumentFragment &fragment)

정적 공용 멤버

QList<QByteArray> supportedDocumentFormats()

상세 설명

문서를 작성하려면 파일 이름이나 장치 객체를 사용하여 QTextDocumentWriter 객체를 생성하고, 작성할 문서 형식을 지정합니다. 작성기를 생성한 후 나중에 setFormat()를 사용하여 형식을 설정할 수 있습니다.

write()를 호출하여 문서를 장치에 작성합니다. 문서가 성공적으로 작성되면 이 함수는 true 를 반환합니다. 그러나 문서 작성 중 오류가 발생하면 false를 반환합니다.

QTextDocumentWriter가 작성할 수 있는 형식 목록을 확인하려면 supportedDocumentFormats()를 호출하십시오.

지원되는 출력 형식의 기능이 상당히 다양하기 때문에, 라이터는 각 형식에 적합한 객체 하위 집합만을 출력합니다. 여기에는 일반적으로 문서에 포함된 서식이 적용된 텍스트와 이미지가 포함됩니다.

멤버 함수 설명서

QTextDocumentWriter::QTextDocumentWriter()

빈 QTextDocumentWriter 객체를 생성합니다. 쓰기 작업을 수행하기 전에 먼저 setFormat()을 호출하여 문서 형식을 설정한 다음, setDevice() 또는 setFileName()을 호출해야 합니다.

QTextDocumentWriter::QTextDocumentWriter(QIODevice *device, const QByteArray &format)

format 에서 지정한 문서 형식으로, 주어진 device 에 내용을 기록하기 위해 QTextDocumentWriter 객체를 생성합니다.

[explicit] QTextDocumentWriter::QTextDocumentWriter(const QString &fileName, const QByteArray &format = QByteArray())

format 에서 지정한 문서 형식을 사용하여 fileName 라는 이름의 파일에 내용을 기록할 QTextDocumentWriter 객체를 생성합니다. format 가 지정되지 않은 경우, QTextDocumentWriter는 fileName 의 확장자를 확인하여 문서 형식을 자동으로 감지합니다.

[noexcept] QTextDocumentWriter::~QTextDocumentWriter()

QTextDocumentWriter 객체를 삭제합니다.

QIODevice *QTextDocumentWriter::device() const

현재 할당된 장치를 반환하거나, 할당된 장치가 없는 경우 ` nullptr `를 반환합니다.

setDevice()도 참조하십시오 .

QString QTextDocumentWriter::fileName() const

현재 할당된 장치가 QFile 인 경우, 또는 setFileName()이 호출된 경우, 이 함수는 쓰기 대상 파일의 이름을 반환합니다. 그 외의 모든 경우에는 빈 문자열을 반환합니다.

setFileName() 및 setDevice()도 참조하십시오 .

QByteArray QTextDocumentWriter::format() const

문서 작성에 사용되는 형식을 반환합니다.

setFormat()도 참조하십시오 .

void QTextDocumentWriter::setDevice(QIODevice *device)

라이터의 장치를 지정된 device 로 설정합니다. 이미 장치가 설정되어 있는 경우, 기존 장치는 제거되지만 그 외에는 변경되지 않습니다.

장치가 아직 열려 있지 않은 경우, QTextDocumentWriter 는 open()을 호출하여 장치를 WriteOnly 모드로 열려고 시도합니다.

참고: QProcess, QTcpSocket, QUdpSocket 과 같이 장치를 열기 전에 특정 구성이 필요한 일부 장치의 경우이 함수는 작동하지 않습니다.

device() 및 setFileName()도 참조하십시오 .

void QTextDocumentWriter::setFileName(const QString &fileName)

fileName 에 기록될 파일의 이름을 설정합니다. 내부적으로 QTextDocumentWriter 는 QFile 를 생성하여 WriteOnly 모드로 열고, 문서를 기록할 때 이 파일을 사용합니다.

fileName() 및 setDevice()도 참조하십시오 .

void QTextDocumentWriter::setFormat(const QByteArray &format)

지정된 format 에 문서를 기록할 때 사용되는 형식을 설정합니다. format 는 대소문자를 구분하지 않는 텍스트 문자열입니다. 예:

        QTextDocumentWriter writer;
        writer.setFormat("odf"); // same as writer.setFormat("ODF");

QTextDocumentWriter 가 지원하는 전체 형식 목록을 확인하려면 supportedDocumentFormats()를 호출하십시오.

format()도 참조하십시오 .

[static] QList<QByteArray> QTextDocumentWriter::supportedDocumentFormats()

QTextDocumentWriter 에서 지원하는 문서 형식 목록을 반환합니다.

기본적으로 Qt는 다음 형식으로 파일을 작성할 수 있습니다:

형식설명
plaintext일반 텍스트
HTML하이퍼텍스트 마크업 언어
마크다운마크다운 (CommonMark 또는 GitHub 방언)
ODF오픈문서 형식

setFormat()도 참조하십시오 .

bool QTextDocumentWriter::write(const QTextDocument *document)

지정된 ` document `를 할당된 장치나 파일에 기록하고, 성공하면 ` true `를 반환하며, 그렇지 않으면 ` false`를 반환합니다.

bool QTextDocumentWriter::write(const QTextDocumentFragment &fragment)

fragment 로 지정된 문서 조각을 할당된 장치나 파일에 기록하고, 성공하면 true 를 반환하며, 그렇지 않으면 false 를 반환합니다.

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