KateHighlighting Class Reference

#include <katehighlight.h>

Public Types
enum	CSLPos { CSLPosColumn0 =0, CSLPosAfterWhitespace =1 }

Public Member Functions
	KateHighlighting (const KateSyntaxModeListItem *def)
	~KateHighlighting ()
bool	allowsFolding ()
int	attribute (int context) const
bool	attributeRequiresSpellchecking (int attr)
QList < KTextEditor::Attribute::Ptr >	attributes (const QString &schema)
const QString &	author () const
bool	canBreakAt (QChar c, int attrib=0) const
bool	canComment (int startAttr, int endAttr) const
const QHash< QString, QChar > &	characterEncodings (int attrib=0) const
void	clearAttributeArrays ()
signed char	commentRegion (int attr) const
KateHlContext *	contextNum (int n)
int	defaultStyleForAttribute (int attrib) const
void	doHighlight (const Kate::TextLineData *prevLine, Kate::TextLineData *textLine, const Kate::TextLineData *nextLine, bool &ctxChanged, int tabWidth=0)
void	dropDynamicContexts ()
QLinkedList< QRegExp >	emptyLines (int attribute=0) const
bool	foldingIndentationSensitive ()
const QHash< QString, QChar > &	getCharacterEncodings (int attrib) const
const KatePrefixStore &	getCharacterEncodingsPrefixStore (int attrib) const
QString	getCommentEnd (int attrib=0) const
CSLPos	getCommentSingleLinePosition (int attrib=0) const
QString	getCommentSingleLineStart (int attrib=0) const
QString	getCommentStart (int attrib=0) const
QStringList	getEmbeddedHighlightingModes () const
int	getEncodedCharactersInsertionPolicy (int attrib) const
const QString &	getIdentifier () const
void	getKateExtendedAttributeList (const QString &schema, QList< KateExtendedAttribute::Ptr > &, KConfig *cfg=0)
void	getKateExtendedAttributeListCopy (const QString &schema, QList< KateExtendedAttribute::Ptr > &, KConfig *cfg=0)
const QHash< QChar, QString > &	getReverseCharacterEncodings (int attrib) const
bool	hidden () const
QString	hlKeyForAttrib (int attrib) const
QString	hlKeyForContext (int attrib) const
QString	indentation ()
bool	isEmptyLine (const Kate::TextLineData *textline) const
bool	isInWord (QChar c, int attrib=0) const
const QString &	license () const
const QString &	name () const
const QString &	nameTranslated () const
bool	noHighlighting () const
void	release ()
const QString &	section () const
void	setKateExtendedAttributeList (const QString &schema, QList< KateExtendedAttribute::Ptr > &, KConfig *cfg=0, bool writeDefaultsToo=false)
const QString &	style () const
void	use ()
const QString &	version () const

Detailed Description

Definition at line 119 of file katehighlight.h.

Member Enumeration Documentation

enum KateHighlighting::CSLPos

This enum is used for storing the information where a single line comment marker should be inserted.

Enumerator
CSLPosColumn0
CSLPosAfterWhitespace

Definition at line 219 of file katehighlight.h.

Constructor & Destructor Documentation

KateHighlighting::KateHighlighting

(

const KateSyntaxModeListItem *

def

)

Definition at line 71 of file katehighlight.cpp.

KateHighlighting::~KateHighlighting

(

)

Definition at line 108 of file katehighlight.cpp.

Member Function Documentation

bool KateHighlighting::allowsFolding ( )

inline

Definition at line 400 of file katehighlight.h.

int KateHighlighting::attribute

(

int

context

)

const

Returns

the attribute for context.

Definition at line 1040 of file katehighlight.cpp.

bool KateHighlighting::attributeRequiresSpellchecking

(

int

attr

)

Definition at line 1045 of file katehighlight.cpp.

QList< KTextEditor::Attribute::Ptr > KateHighlighting::attributes

(

const QString &

schema

)

Definition at line 2134 of file katehighlight.cpp.

const QString& KateHighlighting::author ( ) const

inline

Definition at line 159 of file katehighlight.h.

bool KateHighlighting::canBreakAt	(	QChar	c,
		int	attrib = 0
	)		const

Returns

true if the character c is a wordwrap deliminator as specified in the general keyword section of the xml file.

Definition at line 1091 of file katehighlight.cpp.

bool KateHighlighting::canComment	(	int	startAttr,
		int	endAttr
	)		const

Returns

true if beginAttr and endAttr are members of the same highlight, and there are comment markers of either type in that.

Definition at line 1111 of file katehighlight.cpp.

const QHash< QString, QChar > & KateHighlighting::characterEncodings

(

int

attrib = 0

)

const

Definition at line 1139 of file katehighlight.cpp.

void KateHighlighting::clearAttributeArrays

(

)

Definition at line 2102 of file katehighlight.cpp.

signed char KateHighlighting::commentRegion

(

int

attr

)

const

Returns

0 if highlighting which attr is a member of does not define a comment region, otherwise the region is returned

Definition at line 1106 of file katehighlight.cpp.

KateHlContext* KateHighlighting::contextNum ( int  n )

inline

Definition at line 267 of file katehighlight.h.

int KateHighlighting::defaultStyleForAttribute

(

int

attrib

)

const

void KateHighlighting::doHighlight	(	const Kate::TextLineData *	prevLine,
		Kate::TextLineData *	textLine,
		const Kate::TextLineData *	nextLine,
		bool &	ctxChanged,
		int	tabWidth = 0
	)

Parse the text and fill in the context array and folding list array.

Parameters

prevLine	The previous line, the context array is picked up from that if present.
textLine	The text line to parse
nextLine	The next line, to check if indentation changed for indentation based folding.
ctxChanged	will be set to reflect if the context changed
tabWidth	tab width for indentation based folding, if wanted, else 0

check if the folding begin/ends are balanced! constructed on demand!

loop over line content!

for each end region, decrement counter for that type, erase if count reaches 0!

increment counter for each begin region!

check if folding is not balanced and we have more starts then ends then this line is a possible folding start!

possible folding start, if imbalanced, aka hash not empty!

kill hash

has the context stack changed?

try to share the simple stack that contains only 0

next try: try to share data with last line

ok, really use newly constructed stack!

compute if we increase indentation in next line

Definition at line 253 of file katehighlight.cpp.

void KateHighlighting::dropDynamicContexts

(

)

Drop all dynamic contexts.

Shall be called with extreme care, and shall be immediately followed by a full HL invalidation.

Definition at line 238 of file katehighlight.cpp.

QLinkedList< QRegExp > KateHighlighting::emptyLines

(

int

attribute = 0

)

const

Definition at line 1097 of file katehighlight.cpp.

bool KateHighlighting::foldingIndentationSensitive ( )

inline

Definition at line 399 of file katehighlight.h.

const QHash< QString, QChar > & KateHighlighting::getCharacterEncodings

(

int

attrib

)

const

Definition at line 689 of file katehighlight.cpp.

const KatePrefixStore & KateHighlighting::getCharacterEncodingsPrefixStore

(

int

attrib

)

const

Definition at line 694 of file katehighlight.cpp.

QString KateHighlighting::getCommentEnd

(

int

attrib = 0

)

const

Returns

the muiltiline comment end marker for the highlight corresponding to attrib.

Definition at line 1124 of file katehighlight.cpp.

KateHighlighting::CSLPos KateHighlighting::getCommentSingleLinePosition

(

int

attrib = 0

)

const

Returns

the single comment marker position for the highlight corresponding to attrib.

Definition at line 1134 of file katehighlight.cpp.

QString KateHighlighting::getCommentSingleLineStart

(

int

attrib = 0

)

const

Returns

the single comment marker for the highlight corresponding to attrib.

Definition at line 1129 of file katehighlight.cpp.

QString KateHighlighting::getCommentStart

(

int

attrib = 0

)

const

Returns

the mulitiline comment start marker for the highlight corresponding to attrib.

Definition at line 1119 of file katehighlight.cpp.

QStringList KateHighlighting::getEmbeddedHighlightingModes

(

)

const

Returns a list of names of embedded modes.

Definition at line 2166 of file katehighlight.cpp.

int KateHighlighting::getEncodedCharactersInsertionPolicy

(

int

attrib

)

const

Definition at line 704 of file katehighlight.cpp.

const QString& KateHighlighting::getIdentifier ( ) const

inline

Definition at line 161 of file katehighlight.h.

void KateHighlighting::getKateExtendedAttributeList	(	const QString &	schema,
		QList< KateExtendedAttribute::Ptr > &	list,
		KConfig *	cfg = 0
	)

Definition at line 584 of file katehighlight.cpp.

void KateHighlighting::getKateExtendedAttributeListCopy	(	const QString &	schema,
		QList< KateExtendedAttribute::Ptr > &	list,
		KConfig *	cfg = 0
	)

Definition at line 639 of file katehighlight.cpp.

const QHash< QChar, QString > & KateHighlighting::getReverseCharacterEncodings

(

int

attrib

)

const

Definition at line 699 of file katehighlight.cpp.

bool KateHighlighting::hidden ( ) const

inline

Definition at line 156 of file katehighlight.h.

QString KateHighlighting::hlKeyForAttrib

(

int

attrib

)

const

map attribute to its highlighting file.

the returned string is used as key for m_additionalData.

Definition at line 1068 of file katehighlight.cpp.

QString KateHighlighting::hlKeyForContext

(

int

attrib

)

const

Definition at line 1054 of file katehighlight.cpp.

QString KateHighlighting::indentation ( )

inline

Definition at line 252 of file katehighlight.h.

bool KateHighlighting::isEmptyLine

(

const Kate::TextLineData *

textline

)

const

Definition at line 2171 of file katehighlight.cpp.

bool KateHighlighting::isInWord	(	QChar	c,
		int	attrib = 0
	)		const

Returns

true if the character c is not a deliminator character for the corresponding highlight.

Definition at line 1084 of file katehighlight.cpp.

const QString& KateHighlighting::license ( ) const

inline

Definition at line 160 of file katehighlight.h.

const QString& KateHighlighting::name ( ) const

inline

Definition at line 153 of file katehighlight.h.

const QString& KateHighlighting::nameTranslated ( ) const

inline

Definition at line 154 of file katehighlight.h.

bool KateHighlighting::noHighlighting ( ) const

inline

Definition at line 247 of file katehighlight.h.

void KateHighlighting::release

(

)

Decrease the usage count, and trigger cleanup if needed.

Definition at line 730 of file katehighlight.cpp.

const QString& KateHighlighting::section ( ) const

inline

Definition at line 155 of file katehighlight.h.

void KateHighlighting::setKateExtendedAttributeList	(	const QString &	schema,
		QList< KateExtendedAttribute::Ptr > &	list,
		KConfig *	cfg = 0,
		bool	writeDefaultsToo = false
	)

Saves the attribute definitions to the config file.

Parameters

schema	The id of the schema group to save
list	QList<KateExtendedAttribute::Ptr> containing the data to be used

Definition at line 657 of file katehighlight.cpp.

const QString& KateHighlighting::style ( ) const

inline

Definition at line 158 of file katehighlight.h.

void KateHighlighting::use

(

)

Increase the usage count, and trigger initialization if needed.

Definition at line 719 of file katehighlight.cpp.

const QString& KateHighlighting::version ( ) const

inline

Definition at line 157 of file katehighlight.h.

---

The documentation for this class was generated from the following files:

• katehighlight.h
• katehighlight.cpp