Kate::TextRange

Kate::TextRange Class Reference

#include <katetextrange.h>

Inheritance diagram for Kate::TextRange:

Public Member Functions

 TextRange (TextBuffer &buffer, const KTextEditor::Range &range, InsertBehaviors insertBehavior, EmptyBehavior emptyBehavior=AllowEmpty)
 
 ~TextRange () override
 
KTextEditor::Attribute::Ptr attribute () const override
 
bool attributeOnlyForViews () const override
 
KTextEditor::Documentdocument () const override
 
EmptyBehavior emptyBehavior () const override
 
const KTextEditor::MovingCursorend () const override
 
const TextCursorendInternal () const
 
KTextEditor::MovingRangeFeedbackfeedback () const override
 
bool hasAttribute () const
 
InsertBehaviors insertBehaviors () const override
 
 operator KTextEditor::Range () const
 
void setAttribute (KTextEditor::Attribute::Ptr attribute) override
 
void setAttributeOnlyForViews (bool onlyForViews) override
 
void setEmptyBehavior (EmptyBehavior emptyBehavior) override
 
void setFeedback (KTextEditor::MovingRangeFeedback *feedback) override
 
void setInsertBehaviors (InsertBehaviors insertBehaviors) override
 
void setRange (const KTextEditor::Range &range) override
 
void setRange (const KTextEditor::Cursor &start, const KTextEditor::Cursor &end)
 
void setView (KTextEditor::View *view) override
 
void setZDepth (qreal zDepth) override
 
const KTextEditor::MovingCursorstart () const override
 
const TextCursorstartInternal () const
 
const KTextEditor::Range toRange () const
 
KTextEditor::Viewview () const override
 
qreal zDepth () const override
 
- Public Member Functions inherited from KTextEditor::MovingRange
virtual ~MovingRange ()
 
bool isEmpty () const
 
 operator Range () const
 
void setRange (const Cursor &start, const Cursor &end)
 
const Range toRange () const
 
bool contains (const Range &range) const
 
bool contains (const Cursor &cursor) const
 
bool containsLine (int line) const
 
bool containsColumn (int column) const
 
bool overlaps (const Range &range) const
 
bool overlapsLine (int line) const
 
bool overlapsColumn (int column) const
 
bool onSingleLine () const
 
int numberOfLines () const Q_DECL_NOEXCEPT
 

Additional Inherited Members

- Public Types inherited from KTextEditor::MovingRange
enum  EmptyBehavior { AllowEmpty = 0x0, InvalidateIfEmpty = 0x1 }
 
enum  InsertBehavior { DoNotExpand = 0x0, ExpandLeft = 0x1, ExpandRight = 0x2 }
 
typedef QFlags< InsertBehaviorInsertBehaviors
 
- Protected Member Functions inherited from KTextEditor::MovingRange
 MovingRange ()
 

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
bufferparent text buffer
rangeThe initial text range assumed by the new range.
insertBehaviorDefine whether the range should expand when text is inserted adjacent to the range.
emptyBehaviorDefine whether the range should invalidate itself on becoming empty.

Definition at line 29 of file katetextrange.cpp.

Kate::TextRange::~TextRange ( )
override

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
inlineoverridevirtual

Gets the active Attribute for this range.

Returns
a pointer to the active attribute

Implements KTextEditor::MovingRange.

Definition at line 201 of file katetextrange.h.

bool Kate::TextRange::attributeOnlyForViews ( ) const
inlineoverridevirtual

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

Returns
range visible only for views

Implements KTextEditor::MovingRange.

Definition at line 248 of file katetextrange.h.

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

Gets the document to which this range is bound.

Returns
a pointer to the document

Implements KTextEditor::MovingRange.

Definition at line 355 of file katetextrange.cpp.

EmptyBehavior Kate::TextRange::emptyBehavior ( ) const
inlineoverridevirtual

Will this range invalidate itself if it becomes empty?

Returns
behavior on becoming empty

Implements KTextEditor::MovingRange.

Definition at line 90 of file katetextrange.h.

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

Retrieve end cursor of this range, read-only.

Returns
end cursor

Implements KTextEditor::MovingRange.

Definition at line 144 of file katetextrange.h.

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

Nonvirtual version of end(), which is faster.

Returns
end cursor

Definition at line 153 of file katetextrange.h.

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

Gets the active MovingRangeFeedback for this range.

Returns
a pointer to the active MovingRangeFeedback

Implements KTextEditor::MovingRange.

Definition at line 229 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 210 of file katetextrange.h.

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

Get current insert behaviors.

Returns
current insert behaviors

Implements KTextEditor::MovingRange.

Definition at line 92 of file katetextrange.cpp.

Kate::TextRange::operator 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 171 of file katetextrange.h.

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

Sets the currently active attribute for this range.

This will trigger update of the relevant view parts.

Parameters
attributeAttribute 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

Implements KTextEditor::MovingRange.

Definition at line 290 of file katetextrange.cpp.

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

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

Parameters
onlyForViewsattribute only valid for views

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

Implements KTextEditor::MovingRange.

Definition at line 325 of file katetextrange.cpp.

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

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

Parameters
emptyBehaviorbehavior on becoming empty

nothing to do?

remember value

invalidate range?

Implements KTextEditor::MovingRange.

Definition at line 107 of file katetextrange.cpp.

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

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
feedbackMovingRangeFeedback 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

Implements KTextEditor::MovingRange.

Definition at line 304 of file katetextrange.cpp.

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

Set insert behaviors.

Parameters
insertBehaviorsnew insert behaviors

nothing to do?

modify cursors

notify world

Implements KTextEditor::MovingRange.

Definition at line 69 of file katetextrange.cpp.

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

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
rangenew range for this clever range

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

Implements KTextEditor::MovingRange.

Definition at line 129 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
startnew start for this clever range
endnew end for this clever range

Definition at line 117 of file katetextrange.h.

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

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
viewView 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)

Implements KTextEditor::MovingRange.

Definition at line 267 of file katetextrange.cpp.

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

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
zDepthnew Z-depth of this range

nothing changes, nop

remember the new attribute

notify buffer about attribute change, it will propagate the changes

Implements KTextEditor::MovingRange.

Definition at line 333 of file katetextrange.cpp.

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

Retrieve start cursor of this range, read-only.

Returns
start cursor

Implements KTextEditor::MovingRange.

Definition at line 126 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 135 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 162 of file katetextrange.h.

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

Gets the active view for this range.

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

Returns
a pointer to the active view

Implements KTextEditor::MovingRange.

Definition at line 181 of file katetextrange.h.

qreal Kate::TextRange::zDepth ( ) const
inlineoverridevirtual

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

Implements KTextEditor::MovingRange.

Definition at line 266 of file katetextrange.h.


The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Sat Aug 8 2020 22:56:20 by doxygen 1.8.11 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.