#include <htmlwriter.h>

Inheritance diagram for MessageViewer::HtmlWriter:

Public Member Functions
virtual	~HtmlWriter ()

virtual void	embedPart (const QByteArray &contentId, const QString &url)=0

virtual void	extraHead (const QString &str)=0

virtual void	flush ()=0

virtual void	queue (const QString &str)=0

virtual void	reset ()=0

Public Member Functions inherited from MessageViewer::Interface::HtmlWriter
virtual void	begin (const QString &cssDefinitions)=0

virtual void	end ()=0

virtual void	write (const QString &html)=0

Detailed Description

An interface to HTML sinks.

Author: Marc Mutz mutz@.nosp@m.kde..nosp@m.org

Deprecated:: KMail should be ported to Interface::HtmlWriter. This interface exposes internal working models. The queuing vs. writing() issues exposed here should be hidden by using two different implementations of KHTMLPartHtmlWriter: one for queuing, and one for writing. This should be fixed before the release, so we an keep the plugin interface stable.

Operate this interface in one and only one of the following two modes:

Mode

In sync mode, use begin() to initiate a session, then write() some chunks of HTML code and finally end() the session.

Mode

In async mode, use begin() to initialize a session, then queue() some chunks of HTML code and finally end the session by calling flush().

Queued HTML code is fed to the html sink using a timer. For this to work, control must return to the event loop so timer events are delivered.

mode

You may combine the two modes in the following way only. Any number of write() calls can precede queue() calls, but once a chunk has been queued, you must not write() more data, only queue() it.

Naturally, whenever you queued data in a given session, that session must be ended by calling flush(), not end().

Definition at line 98 of file htmlwriter.h.