Kate::TextCursor Class Reference

#include <katetextcursor.h>

Inheritance diagram for Kate::TextCursor:

Public Member Functions
	TextCursor (TextBuffer &buffer, const KTextEditor::Cursor position, InsertBehavior insertBehavior)
	~TextCursor () override
int	column () const override
int	columnInternal () const
KTextEditor::Document *	document () const override
InsertBehavior	insertBehavior () const override
Kate::TextRange *	kateRange () const
int	line () const override
int	lineInBlock () const
int	lineInternal () const
KTextEditor::MovingRange *	range () const override
void	setInsertBehavior (InsertBehavior insertBehavior) override
void	setPosition (const TextCursor &position)
void	setPosition (int line, int column)
void	setPosition (KTextEditor::Cursor position) override
Public Member Functions inherited from KTextEditor::MovingCursor
	MovingCursor (const MovingCursor &)=delete
virtual	~MovingCursor ()
bool	atEndOfDocument () const
bool	atEndOfLine () const
bool	atStartOfDocument () const
bool	atStartOfLine () const
bool	gotoNextLine ()
bool	gotoPreviousLine ()
bool	isValid () const
bool	isValidTextPosition () const
bool	move (int chars, WrapBehavior wrapBehavior=Wrap)
	operator Cursor () const
MovingCursor &	operator= (const MovingCursor &)=delete
void	setColumn (int column)
void	setLine (int line)
void	setPosition (int line, int column)
const Cursor	toCursor () const

Additional Inherited Members
Public Types inherited from KTextEditor::MovingCursor
enum	InsertBehavior { StayOnInsert = 0x0 , MoveOnInsert = 0x1 }
enum	WrapBehavior { Wrap = 0x0 , NoWrap = 0x1 }
Protected Member Functions inherited from KTextEditor::MovingCursor
	MovingCursor ()

Detailed Description

Class representing a 'clever' text cursor.

It will automagically move if the text inside the buffer it belongs to is modified. By intention no subclass of KTextEditor::Cursor, must be converted manually.

Definition at line 28 of file katetextcursor.h.

Constructor & Destructor Documentation

TextCursor()

Kate::TextCursor::TextCursor	(	TextBuffer &	buffer,
		const KTextEditor::Cursor	position,
		InsertBehavior	insertBehavior )

Construct a text cursor.

Parameters

buffer	text buffer this cursor belongs to
position	wanted cursor position, if not valid for given buffer, will lead to invalid cursor
insertBehavior	behavior of this cursor on insert of text at its position

Definition at line 18 of file katetextcursor.cpp.

~TextCursor()

Kate::TextCursor::~TextCursor ( )

override

Destruct the text cursor.

Definition at line 35 of file katetextcursor.cpp.

Member Function Documentation

column()

int Kate::TextCursor::column ( ) const

inlineoverridevirtual

Retrieve the column on which this cursor is situated.

Returns

column number, where 0 is the first column.

Implements KTextEditor::MovingCursor.

Definition at line 136 of file katetextcursor.h.

columnInternal()

int Kate::TextCursor::columnInternal ( ) const

inline

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

Returns

column number, where 0 is the first column.

Definition at line 145 of file katetextcursor.h.

document()

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

overridevirtual

Gets the document to which this cursor is bound.

Returns

a pointer to the document

Implements KTextEditor::MovingCursor.

Definition at line 118 of file katetextcursor.cpp.

insertBehavior()

InsertBehavior Kate::TextCursor::insertBehavior ( ) const

inlineoverridevirtual

Get current insert behavior.

Returns

current insert behavior

Implements KTextEditor::MovingCursor.

Definition at line 75 of file katetextcursor.h.

kateRange()

Kate::TextRange * Kate::TextCursor::kateRange ( ) const

inline

Get range this cursor belongs to, if any.

Returns

range this pointer is part of, else 0

Definition at line 160 of file katetextcursor.h.

line()

int Kate::TextCursor::line ( ) const

inlineoverridevirtual

Retrieve the line on which this cursor is situated.

Returns

line number, where 0 is the first line.

Implements KTextEditor::MovingCursor.

Definition at line 114 of file katetextcursor.h.

lineInBlock()

int Kate::TextCursor::lineInBlock ( ) const

inline

Get offset into block this cursor belongs to, if any.

Returns

offset into block this pointer is part of, else -1

Definition at line 169 of file katetextcursor.h.

lineInternal()

int Kate::TextCursor::lineInternal ( ) const

inline

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

Inlined for fast access (especially in KateTextBuffer::rangesForLine

Returns

line number, where 0 is the first line or -1 if invalid.

Definition at line 124 of file katetextcursor.h.

range()

KTextEditor::MovingRange * Kate::TextCursor::range ( ) const

overridevirtual

Get range this cursor belongs to, if any.

Returns

range this pointer is part of, else 0

Implements KTextEditor::MovingCursor.

Definition at line 123 of file katetextcursor.cpp.

setInsertBehavior()

void Kate::TextCursor::setInsertBehavior ( InsertBehavior insertBehavior )

inlineoverridevirtual

Set insert behavior.

Parameters

insertBehavior

new insert behavior

Implements KTextEditor::MovingCursor.

Definition at line 66 of file katetextcursor.h.

setPosition() [1/3]

void Kate::TextCursor::setPosition

(

const TextCursor &

position

)

Fast way to set the current cursor position to position.

Parameters

position

new cursor position

Definition at line 48 of file katetextcursor.cpp.

setPosition() [2/3]

void Kate::TextCursor::setPosition	(	int	line,
		int	column )

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Set the cursor position to line and column.

Parameters

line	new cursor line
column	new cursor column

Definition at line 133 of file katetextcursor.cpp.

setPosition() [3/3]

void Kate::TextCursor::setPosition ( KTextEditor::Cursor position )

overridevirtual

Set the current cursor position to position.

Parameters

position

new cursor position

Implements KTextEditor::MovingCursor.

Definition at line 128 of file katetextcursor.cpp.

---

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

• katetextcursor.h
• katetextcursor.cpp