2021-06-10 09:34:59 +08:00
|
|
|
#ifndef SYNEXPORTER_H
|
|
|
|
#define SYNEXPORTER_H
|
|
|
|
|
|
|
|
#include <QString>
|
|
|
|
#include "../SynEdit.h"
|
|
|
|
|
|
|
|
|
|
|
|
|
2021-10-12 09:47:58 +08:00
|
|
|
using FormatTokenHandler = std::function<void(PSynHighlighter syntaxHighlighter, int Line, int column, const QString& token,
|
|
|
|
PSynHighlighterAttribute& attr)>;
|
2021-06-10 09:34:59 +08:00
|
|
|
class SynExporter
|
|
|
|
{
|
2021-06-12 22:36:23 +08:00
|
|
|
|
2021-06-10 09:34:59 +08:00
|
|
|
public:
|
|
|
|
explicit SynExporter();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Clears the output buffer and any internal data that relates to the last
|
|
|
|
* exported text.
|
|
|
|
*/
|
|
|
|
virtual void clear();
|
|
|
|
/**
|
|
|
|
* @brief Copies the output buffer contents to the clipboard, as the native format
|
|
|
|
* or as text depending on the ExportAsText property.
|
|
|
|
*/
|
|
|
|
void CopyToClipboard();
|
|
|
|
/**
|
|
|
|
* @brief Exports everything in the strings parameter to the output buffer.
|
|
|
|
* @param ALines
|
|
|
|
*/
|
2021-06-12 22:36:23 +08:00
|
|
|
void ExportAll(PSynEditStringList ALines);
|
2021-06-10 09:34:59 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Exports the given range of the strings parameter to the output buffer.
|
|
|
|
* @param ALines
|
|
|
|
* @param Start
|
|
|
|
* @param Stop
|
|
|
|
*/
|
2021-06-12 22:36:23 +08:00
|
|
|
void ExportRange(PSynEditStringList ALines,
|
|
|
|
BufferCoord Start, BufferCoord Stop);
|
2021-06-10 09:34:59 +08:00
|
|
|
/**
|
|
|
|
* @brief Saves the contents of the output buffer to a file.
|
|
|
|
* @param AFileName
|
|
|
|
*/
|
|
|
|
void SaveToFile(const QString& AFileName);
|
|
|
|
/**
|
|
|
|
* @brief Saves the contents of the output buffer to a stream.
|
|
|
|
* @param AStream
|
|
|
|
*/
|
2021-06-12 22:36:23 +08:00
|
|
|
void SaveToStream(QIODevice& AStream);
|
2021-06-10 09:34:59 +08:00
|
|
|
bool exportAsText() const;
|
|
|
|
void setExportAsText(bool Value);
|
|
|
|
|
|
|
|
QFont font() const;
|
|
|
|
void setFont(const QFont &font);
|
|
|
|
|
|
|
|
PSynHighlighter highlighter() const;
|
|
|
|
void setHighlighter(PSynHighlighter Value);
|
|
|
|
|
|
|
|
QString title() const;
|
|
|
|
void setTitle(const QString &Value);
|
|
|
|
|
|
|
|
bool useBackground() const;
|
|
|
|
void setUseBackground(bool Value);
|
|
|
|
|
|
|
|
FileEndingType fileEndingType() const;
|
|
|
|
void setFileEndingType(const FileEndingType &fileEndingType);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief The clipboard format the exporter creates as native format.
|
|
|
|
* @return
|
|
|
|
*/
|
|
|
|
virtual QByteArray clipboardFormat();
|
|
|
|
|
|
|
|
QColor foregroundColor() const;
|
|
|
|
void setForegroundColor(const QColor &value);
|
|
|
|
|
|
|
|
QColor backgroundColor() const;
|
|
|
|
void setBackgroundColor(const QColor &value);
|
|
|
|
|
|
|
|
QByteArray charset() const;
|
|
|
|
void setCharset(const QByteArray &charset);
|
|
|
|
|
2021-06-12 22:36:23 +08:00
|
|
|
QString defaultFilter() const;
|
|
|
|
void setDefaultFilter(const QString &defaultFilter);
|
|
|
|
|
|
|
|
FormatTokenHandler onFormatToken() const;
|
|
|
|
void setOnFormatToken(const FormatTokenHandler &onFormatToken);
|
|
|
|
|
|
|
|
const QByteArray& buffer() const;
|
|
|
|
|
2021-06-10 09:34:59 +08:00
|
|
|
protected:
|
|
|
|
QByteArray mCharset;
|
|
|
|
QColor mBackgroundColor;
|
|
|
|
QColor mForegroundColor;
|
|
|
|
QByteArray mClipboardFormat;
|
|
|
|
QString mDefaultFilter;
|
|
|
|
bool mExportAsText;
|
|
|
|
QFont mFont;
|
|
|
|
PSynHighlighter mHighlighter;
|
|
|
|
QColor mLastBG;
|
|
|
|
QColor mLastFG;
|
|
|
|
SynFontStyles mLastStyle;
|
|
|
|
QMap<QChar,QString> mReplaceReserved;
|
|
|
|
QString mTitle;
|
|
|
|
bool mUseBackground;
|
|
|
|
FileEndingType mFileEndingType;
|
|
|
|
|
2021-06-12 22:36:23 +08:00
|
|
|
QString lineBreak();
|
|
|
|
|
2021-06-10 09:34:59 +08:00
|
|
|
/**
|
|
|
|
* @brief Adds a string to the output buffer.
|
|
|
|
* @param AText
|
|
|
|
*/
|
|
|
|
void AddData(const QString& AText);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Adds a string and a trailing newline to the output buffer.
|
|
|
|
* @param AText
|
|
|
|
*/
|
|
|
|
void AddDataNewLine(const QString& AText);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Adds a newline to the output buffer.
|
|
|
|
*/
|
|
|
|
void AddNewLine();
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Copies the data under this format to the clipboard. The clipboard has to
|
|
|
|
* be opened explicitly when more than one format is to be set.
|
|
|
|
*/
|
|
|
|
void CopyToClipboardFormat(QByteArray AFormat);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Has to be overridden in descendant classes to add the closing format
|
|
|
|
* strings to the output buffer. The parameters can be used to track what
|
|
|
|
* changes are made for the next token.
|
|
|
|
* @param BackgroundChanged
|
|
|
|
* @param ForegroundChanged
|
|
|
|
* @param FontStylesChanged
|
|
|
|
*/
|
|
|
|
virtual void FormatAttributeDone(bool BackgroundChanged, bool ForegroundChanged,
|
|
|
|
SynFontStyles FontStylesChanged) = 0;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Has to be overridden in descendant classes to add the opening format
|
|
|
|
* strings to the output buffer. The parameters can be used to track what
|
|
|
|
* changes have been made in respect to the previous token.
|
|
|
|
* @param BackgroundChanged
|
|
|
|
* @param ForegroundChanged
|
|
|
|
* @param FontStylesChanged
|
|
|
|
*/
|
|
|
|
virtual void FormatAttributeInit(bool BackgroundChanged, bool ForegroundChanged,
|
|
|
|
SynFontStyles FontStylesChanged) = 0;
|
|
|
|
/**
|
|
|
|
* @brief Has to be overridden in descendant classes to add the closing format
|
|
|
|
* strings to the output buffer after the last token has been written.
|
|
|
|
*/
|
|
|
|
virtual void FormatAfterLastAttribute() = 0;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Has to be overridden in descendant classes to add the opening format
|
|
|
|
* strings to the output buffer when the first token is about to be written.
|
|
|
|
* @param BackgroundChanged
|
|
|
|
* @param ForegroundChanged
|
|
|
|
* @param FontStylesChanged
|
|
|
|
*/
|
|
|
|
virtual void FormatBeforeFirstAttribute(bool BackgroundChanged, bool ForegroundChanged,
|
|
|
|
SynFontStyles FontStylesChanged) = 0;
|
|
|
|
/**
|
|
|
|
* @brief Can be overridden in descendant classes to add the formatted text of
|
|
|
|
* the actual token text to the output buffer.
|
|
|
|
*/
|
2021-06-12 22:36:23 +08:00
|
|
|
virtual void FormatToken(const QString& Token) ;
|
2021-06-10 09:34:59 +08:00
|
|
|
/**
|
|
|
|
* @brief Has to be overridden in descendant classes to add a newline in the output
|
|
|
|
* format to the output buffer.
|
|
|
|
*/
|
|
|
|
virtual void FormatNewLine() = 0;
|
|
|
|
/**
|
|
|
|
* @brief Returns the size of the formatted text in the output buffer, to be used
|
|
|
|
* in the format header or footer.
|
|
|
|
* @return
|
|
|
|
*/
|
|
|
|
int GetBufferSize();
|
|
|
|
/**
|
|
|
|
* @brief Has to be overridden in descendant classes to return the correct output
|
|
|
|
* format footer.
|
|
|
|
* @return
|
|
|
|
*/
|
|
|
|
virtual QString GetFooter() = 0;
|
|
|
|
/**
|
|
|
|
* @brief Has to be overridden in descendant classes to return the name of the
|
|
|
|
* output format.
|
|
|
|
* @return
|
|
|
|
*/
|
|
|
|
virtual QString GetFormatName() = 0;
|
|
|
|
/**
|
|
|
|
* @brief Has to be overridden in descendant classes to return the correct output
|
|
|
|
* format header.
|
|
|
|
* @return
|
|
|
|
*/
|
|
|
|
virtual QString GetHeader() = 0;
|
|
|
|
/**
|
|
|
|
* @brief Inserts a data block at the given position into the output buffer. Is
|
|
|
|
* used to insert the format header after the exporting, since some header
|
|
|
|
* data may be known only after the conversion is done.
|
|
|
|
* @param APos
|
|
|
|
* @param AText
|
|
|
|
*/
|
|
|
|
void InsertData(int APos, const QString& AText);
|
|
|
|
/**
|
|
|
|
* @brief Returns a string that has all the invalid chars of the output format
|
|
|
|
* replaced with the entries in the replacement array.
|
|
|
|
*/
|
2021-06-12 22:36:23 +08:00
|
|
|
QString ReplaceReservedChars(const QString &AToken);
|
2021-06-10 09:34:59 +08:00
|
|
|
/**
|
|
|
|
* @brief Sets the token attribute of the next token to determine the changes
|
|
|
|
* of colors and font styles so the properties of the next token can be
|
|
|
|
* added to the output buffer.
|
|
|
|
* @param Attri
|
|
|
|
*/
|
|
|
|
virtual void SetTokenAttribute(PSynHighlighterAttribute Attri);
|
2021-06-12 22:36:23 +08:00
|
|
|
|
|
|
|
QTextCodec *getCodec();
|
2021-06-10 09:34:59 +08:00
|
|
|
private:
|
|
|
|
QByteArray mBuffer;
|
|
|
|
bool mFirstAttribute;
|
|
|
|
FormatTokenHandler mOnFormatToken;
|
2021-06-12 22:36:23 +08:00
|
|
|
|
2021-06-10 09:34:59 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif // SYNEXPORTER_H
|