QTextDocumentWriter Class
QTextDocumentWriter 클래스는 파일이나 다른 장치에 QTextDocument 을 쓰기 위한 형식 독립적인 인터페이스를 제공합니다. 더 보기...
헤더: | #include <QTextDocumentWriter> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake: | QT += gui |
- 상속된 멤버를 포함한 모든 멤버 목록
- QTextDocumentWriter는 리치 텍스트 처리 API의 일부입니다.
공용 함수
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를 반환합니다.
supportedDocumentFormats()를 호출하여 QTextDocumentWriter가 쓸 수 있는 형식 목록을 확인합니다.
지원되는 출력 형식의 기능은 상당히 다양하므로, 작성기는 각 형식에 적합한 객체의 하위 집합을 출력하기만 하면 됩니다. 여기에는 일반적으로 문서에 포함된 형식이 지정된 텍스트와 이미지가 포함됩니다.
멤버 함수 문서
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");
supportedDocumentFormats()를 호출하여 QTextDocumentWriter 지원 형식의 전체 목록을 확인할 수 있습니다.
format()도 참조하세요 .
[static]
QList<QByteArray> QTextDocumentWriter::supportedDocumentFormats()
QTextDocumentWriter 에서 지원하는 문서 형식의 목록을 반환합니다.
기본적으로 Qt는 다음 형식을 쓸 수 있습니다:
포맷 | 설명 |
---|---|
일반 텍스트 | 일반 텍스트 |
HTML | 하이퍼텍스트 마크업 언어 |
마크다운 | 마크다운(CommonMark 또는 GitHub 방언) |
ODF | OpenDocument 형식 |
setFormat()도 참조하세요 .
bool QTextDocumentWriter::write(const QTextDocument *document)
지정된 document 을 할당된 장치 또는 파일에 쓰고 성공하면 true
을 반환하고, 그렇지 않으면 false
을 반환합니다.
bool QTextDocumentWriter::write(const QTextDocumentFragment &fragment)
fragment 에 지정된 문서 조각을 할당된 장치 또는 파일에 쓰고 성공하면 true
을 반환하고, 그렇지 않으면 false
을 반환합니다.
© 2025 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.