#include <katetextrange.h>

Inherits MovingRange.

Public Member Functions
	TextRange (TextBuffer &buffer, const KTextEditor::Range &range, InsertBehaviors insertBehavior, EmptyBehavior emptyBehavior=AllowEmpty)

	~TextRange ()

KTextEditor::Attribute::Ptr	attribute () const

bool	attributeOnlyForViews () const

KTextEditor::Document *	document () const

EmptyBehavior	emptyBehavior () const

const KTextEditor::MovingCursor &	end () const

const TextCursor &	endInternal () const

KTextEditor::MovingRangeFeedback *	feedback () const

bool	hasAttribute () const

InsertBehaviors	insertBehaviors () const

	operator const KTextEditor::Range () const

void	setAttribute (KTextEditor::Attribute::Ptr attribute)

void	setAttributeOnlyForViews (bool onlyForViews)

void	setEmptyBehavior (EmptyBehavior emptyBehavior)

void	setFeedback (KTextEditor::MovingRangeFeedback *feedback)

void	setInsertBehaviors (InsertBehaviors insertBehaviors)

void	setRange (const KTextEditor::Range &range)

void	setRange (const KTextEditor::Cursor &start, const KTextEditor::Cursor &end)

void	setView (KTextEditor::View *view)

void	setZDepth (qreal zDepth)

const KTextEditor::MovingCursor &	start () const

const TextCursor &	startInternal () const

const KTextEditor::Range	toRange () const

KTextEditor::View *	view () const

qreal	zDepth () const

Detailed Description

Class representing a 'clever' text range.

It will automagically move if the text inside the buffer it belongs to is modified. By intention no subclass of KTextEditor::Range, must be converted manually. A TextRange is allowed to be empty. If you call setInvalidateIfEmpty(true), a TextRange will become automatically invalid as soon as start() == end() position holds.

Definition at line 46 of file katetextrange.h.

Constructor & Destructor Documentation

Kate::TextRange::TextRange	(	TextBuffer &	buffer,
		const KTextEditor::Range &	range,
		InsertBehaviors	insertBehavior,
		EmptyBehavior	emptyBehavior = `AllowEmpty`
	)

Construct a text range.

A TextRange is not allowed to be empty, as soon as start == end position, it will become automatically invalid!

Parameters

buffer	parent text buffer
range	The initial text range assumed by the new range.
insertBehavior	Define whether the range should expand when text is inserted adjacent to the range.
emptyBehavior	Define whether the range should invalidate itself on becoming empty.

Definition at line 29 of file katetextrange.cpp.

Kate::TextRange::~TextRange ( )

Destruct the text block.

reset feedback, don't want feedback during destruction

trigger update, if we have attribute notify right view here we can ignore feedback, even with feedback, we want none if the range is deleted!

Definition at line 46 of file katetextrange.cpp.

Member Function Documentation

KTextEditor::Attribute::Ptr Kate::TextRange::attribute ( ) const

inline

Gets the active Attribute for this range.

Returns: a pointer to the active attribute

Definition at line 173 of file katetextrange.h.

bool Kate::TextRange::attributeOnlyForViews ( ) const

inline

Is this range's attribute only visible in views, not for example prints? Default is false.

Returns: range visible only for views

Definition at line 211 of file katetextrange.h.

KTextEditor::Document * Kate::TextRange::document ( ) const

Gets the document to which this range is bound.

Returns: a pointer to the document

Definition at line 326 of file katetextrange.cpp.

EmptyBehavior Kate::TextRange::emptyBehavior ( ) const

inline

Will this range invalidate itself if it becomes empty?

Returns: behavior on becoming empty

Definition at line 89 of file katetextrange.h.

const KTextEditor::MovingCursor& Kate::TextRange::end ( ) const

inline

Retrieve end cursor of this range, read-only.

Returns: end cursor

Definition at line 131 of file katetextrange.h.

const TextCursor& Kate::TextRange::endInternal ( ) const

inline

Nonvirtual version of end(), which is faster.

Returns: end cursor

Definition at line 137 of file katetextrange.h.

KTextEditor::MovingRangeFeedback* Kate::TextRange::feedback ( ) const

inline

Gets the active MovingRangeFeedback for this range.

Returns: a pointer to the active MovingRangeFeedback

Definition at line 195 of file katetextrange.h.

bool Kate::TextRange::hasAttribute ( ) const

inline

Returns: whether a nonzero attribute is set. This is faster than checking attribute(), because the reference-counting is omitted.

Definition at line 179 of file katetextrange.h.

KTextEditor::MovingRange::InsertBehaviors Kate::TextRange::insertBehaviors ( ) const

Get current insert behaviors.

Returns: current insert behaviors

Definition at line 89 of file katetextrange.cpp.

Kate::TextRange::operator const KTextEditor::Range ( ) const

inline

Convert this clever range into a dumb one.

Equal to toRange, allowing to use implicit conversion.

Returns: normal range

Definition at line 149 of file katetextrange.h.

void Kate::TextRange::setAttribute ( KTextEditor::Attribute::Ptr attribute )

Sets the currently active attribute for this range.

This will trigger update of the relevant view parts.

Parameters

attribute Attribute to assign to this range. If null, simply removes the previous Attribute.

remember the new attribute

notify buffer about attribute change, it will propagate the changes notify right view

Definition at line 264 of file katetextrange.cpp.

void Kate::TextRange::setAttributeOnlyForViews ( bool onlyForViews )

Set if this range's attribute is only visible in views, not for example prints.

Parameters

onlyForViews attribute only valid for views

just set the value, no need to trigger updates, printing is not interruptable

Definition at line 298 of file katetextrange.cpp.

void Kate::TextRange::setEmptyBehavior ( EmptyBehavior emptyBehavior )

Set if this range will invalidate itself if it becomes empty.

Parameters

emptyBehavior behavior on becoming empty

nothing to do?

remember value

invalidate range?

Definition at line 102 of file katetextrange.cpp.

void Kate::TextRange::setFeedback ( KTextEditor::MovingRangeFeedback * feedback )

Sets the currently active MovingRangeFeedback for this range.

This will trigger evaluation if feedback must be send again (for example if mouse is already inside range).

Parameters

attribute MovingRangeFeedback to assign to this range. If null, simply removes the previous MovingRangeFeedback.

nothing changes, nop

remember the new feedback object

notify buffer about feedback change, it will propagate the changes notify right view

Definition at line 278 of file katetextrange.cpp.

void Kate::TextRange::setInsertBehaviors ( InsertBehaviors insertBehaviors )

Set insert behaviors.

Parameters

insertBehaviors new insert behaviors

nothing to do?

modify cursors

notify world

Definition at line 68 of file katetextrange.cpp.

void Kate::TextRange::setRange ( const KTextEditor::Range & range )

Set the range of this range.

A TextRange is not allowed to be empty, as soon as start == end position, it will become automatically invalid!

Parameters

range new range for this clever range

notify buffer about attribute change, it will propagate the changes notify right view

Definition at line 122 of file katetextrange.cpp.

void Kate::TextRange::setRange	(	const KTextEditor::Cursor &	start,
		const KTextEditor::Cursor &	end
	)

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Set the range of this range A TextRange is not allowed to be empty, as soon as start == end position, it will become automatically invalid!

Parameters

start	new start for this clever range
end	new end for this clever range

Definition at line 113 of file katetextrange.h.

void Kate::TextRange::setView ( KTextEditor::View * view )

Sets the currently active view for this range.

This will trigger update of the relevant view parts, if the view changed. Set view before the attribute, that will avoid not needed redraws.

Parameters

attribute View to assign to this range. If null, simply removes the previous view.

nothing changes, nop

remember the new attribute

notify buffer about attribute change, it will propagate the changes notify all views (can be optimized later)

Definition at line 243 of file katetextrange.cpp.

void Kate::TextRange::setZDepth ( qreal zDepth )

Set the current Z-depth of this range.

Ranges with smaller Z-depth than others will win during rendering. This will trigger update of the relevant view parts, if the depth changed. Set depth before the attribute, that will avoid not needed redraws. Default is 0.0.

Parameters

zDepth new Z-depth of this range

nothing changes, nop

remember the new attribute

notify buffer about attribute change, it will propagate the changes

Definition at line 306 of file katetextrange.cpp.

const KTextEditor::MovingCursor& Kate::TextRange::start ( ) const

inline

Retrieve start cursor of this range, read-only.

Returns: start cursor

Definition at line 119 of file katetextrange.h.

const TextCursor& Kate::TextRange::startInternal ( ) const

inline

Non-virtual version of start(), which is faster.

Returns: start cursor

Definition at line 125 of file katetextrange.h.

const KTextEditor::Range Kate::TextRange::toRange ( ) const

inline

Convert this clever range into a dumb one.

Returns: normal range

Definition at line 143 of file katetextrange.h.

KTextEditor::View* Kate::TextRange::view ( ) const

inline

Gets the active view for this range.

Might be already invalid, internally only used for pointer comparisons.

Returns: a pointer to the active view

Definition at line 156 of file katetextrange.h.

qreal Kate::TextRange::zDepth ( ) const

inline

Gets the current Z-depth of this range.

Ranges with smaller Z-depth than others will win during rendering. Default is 0.0.

Returns: current Z-depth of this range

Definition at line 226 of file katetextrange.h.

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

Kate

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Kate

applications API Reference

Search