QTextDocumentWriter Class

成员函数

QTextDocumentWriter::QTextDocumentWriter()

Constructs an empty QTextDocumentWriter object. Before writing, you must call setFormat() to set a document format, then setDevice() or setFileName().

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

Constructs a QTextDocumentWriter object to write to the given device in the document format specified by format.

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

Constructs an QTextDocumentWriter object that will write to a file with the name fileName, using the document format specified by format. If format is not provided, QTextDocumentWriter will detect the document format by inspecting the extension of fileName.

QTextDocumentWriter::~QTextDocumentWriter()

Destroys the QTextDocumentWriter object.

QTextCodec *QTextDocumentWriter::codec() const

Returns the codec that is currently assigned to the writer.

参见 setCodec().

QIODevice *QTextDocumentWriter::device() const

Returns the device currently assigned, or 0 if no device has been assigned.

参见 setDevice().

QString QTextDocumentWriter::fileName() const

If the currently assigned device is a QFile, or if setFileName() has been called, this function returns the name of the file to be written to. In all other cases, it returns an empty string.

参见 setFileName() and setDevice().

QByteArray QTextDocumentWriter::format() const

Returns the format used for writing documents.

参见 setFormat().

void QTextDocumentWriter::setCodec(QTextCodec *codec)

Sets the codec for this stream to codec. The codec is used for encoding any data that is written. By default, QTextDocumentWriter uses UTF-8.

参见 codec().

void QTextDocumentWriter::setDevice(QIODevice *device)

Sets the writer's device to the device specified. If a device has already been set, the old device is removed but otherwise left unchanged.

If the device is not already open, QTextDocumentWriter will attempt to open the device in QIODevice::WriteOnly mode by calling open().

Note: This will not work for certain devices, such as QProcess, QTcpSocket and QUdpSocket, where some configuration is required before the device can be opened.

参见 device() and setFileName().

void QTextDocumentWriter::setFileName(const QString &fileName)

Sets the name of the file to be written to fileName. Internally, QTextDocumentWriter will create a QFile and open it in QIODevice::WriteOnly mode, and use this file when writing the document.

参见 fileName() and setDevice().

void QTextDocumentWriter::setFormat(const QByteArray &format)

Sets the format used to write documents to the format specified. format is a case insensitive text string. For example:

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

You can call supportedDocumentFormats() for the full list of formats QTextDocumentWriter supports.

参见 format().

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

Returns the list of document formats supported by QTextDocumentWriter.

By default, Qt can write the following formats:

参见 setFormat().

bool QTextDocumentWriter::write(const QTextDocument *document)

Writes the given document to the assigned device or file and returns true if successful; otherwise returns false.

bool QTextDocumentWriter::write(const QTextDocumentFragment &fragment)

Writes the document fragment specified by fragment to the assigned device or file and returns true if successful; otherwise returns false.