Kate::TextRange

Search for usage in LXR

Kate::TextRange Class Referencefinal

#include <katetextrange.h>

Inheritance diagram for Kate::TextRange:

Public Member Functions

 TextRange (TextBuffer &buffer, 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::Cursor &start, const KTextEditor::Cursor &end)
 
void setRange (const KTextEditor::Range &range) override
 
void setView (KTextEditor::View *view) override
 
void setZDepth (qreal zDepth) override
 
const KTextEditor::MovingCursorstart () const override
 
const TextCursorstartInternal () const
 
KTextEditor::LineRange toLineRange () 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)
 
LineRange toLineRange () const Q_DECL_NOEXCEPT
 
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 36 of file katetextrange.h.

Constructor & Destructor Documentation

◆ TextRange()

Kate::TextRange::TextRange ( TextBuffer buffer,
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 16 of file katetextrange.cpp.

◆ ~TextRange()

Kate::TextRange::~TextRange ( )
override

Destruct the text block.

Definition at line 34 of file katetextrange.cpp.

Member Function Documentation

◆ attribute()

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.

◆ attributeOnlyForViews()

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.

◆ document()

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 299 of file katetextrange.cpp.

◆ emptyBehavior()

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 80 of file katetextrange.h.

◆ end()

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 134 of file katetextrange.h.

◆ endInternal()

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

Nonvirtual version of end(), which is faster.

Returns
end cursor

Definition at line 143 of file katetextrange.h.

◆ feedback()

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.

◆ hasAttribute()

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.

◆ insertBehaviors()

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

Get current insert behaviors.

Returns
current insert behaviors

Implements KTextEditor::MovingRange.

Definition at line 70 of file katetextrange.cpp.

◆ operator KTextEditor::Range()

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.

◆ setAttribute()

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.

Implements KTextEditor::MovingRange.

Definition at line 247 of file katetextrange.cpp.

◆ setAttributeOnlyForViews()

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

Implements KTextEditor::MovingRange.

Definition at line 277 of file katetextrange.cpp.

◆ setEmptyBehavior()

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

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

Parameters
emptyBehaviorbehavior on becoming empty

Implements KTextEditor::MovingRange.

Definition at line 85 of file katetextrange.cpp.

◆ setFeedback()

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.

Implements KTextEditor::MovingRange.

Definition at line 262 of file katetextrange.cpp.

◆ setInsertBehaviors()

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

Set insert behaviors.

Parameters
insertBehaviorsnew insert behaviors

Implements KTextEditor::MovingRange.

Definition at line 53 of file katetextrange.cpp.

◆ setRange() [1/2]

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 107 of file katetextrange.h.

◆ setRange() [2/2]

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

Implements KTextEditor::MovingRange.

Definition at line 101 of file katetextrange.cpp.

◆ setView()

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.

Implements KTextEditor::MovingRange.

Definition at line 230 of file katetextrange.cpp.

◆ setZDepth()

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

Implements KTextEditor::MovingRange.

Definition at line 283 of file katetextrange.cpp.

◆ start()

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 116 of file katetextrange.h.

◆ startInternal()

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.

◆ toLineRange()

KTextEditor::LineRange Kate::TextRange::toLineRange ( ) const
inline

Hides parent's impl of toLineRange() and uses non-virtual functions internally.

Definition at line 151 of file katetextrange.h.

◆ toRange()

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

Convert this clever range into a dumb one.

Returns
normal range

Definition at line 160 of file katetextrange.h.

◆ view()

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.

◆ zDepth()

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-2023 The KDE developers.
Generated on Fri Dec 1 2023 03:52:25 by doxygen 1.8.17 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.