Kate::TextCursor Class Reference

#include <katetextcursor.h>

Inherits MovingCursor.

Public Member Functions
	TextCursor (TextBuffer &buffer, const KTextEditor::Cursor &position, InsertBehavior insertBehavior)
	~TextCursor ()
TextBlock *	block () const
int	column () const
int	columnInternal () const
KTextEditor::Document *	document () const
InsertBehavior	insertBehavior () const
Kate::TextRange *	kateRange () const
int	line () const
int	lineInBlock () const
int	lineInternal () const
KTextEditor::MovingRange *	range () const
void	setInsertBehavior (InsertBehavior insertBehavior)
void	setPosition (const TextCursor &position)
void	setPosition (const KTextEditor::Cursor &position)
void	setPosition (int line, int column)

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 43 of file katetextcursor.h.

Constructor & Destructor Documentation

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 29 of file katetextcursor.cpp.

Kate::TextCursor::~TextCursor

(

)

Destruct the text cursor.

Definition at line 53 of file katetextcursor.cpp.

Member Function Documentation

TextBlock* Kate::TextCursor::block ( ) const

inline

Get block this cursor belongs to, if any.

Returns

block this pointer is part of, else 0

Definition at line 165 of file katetextcursor.h.

int Kate::TextCursor::column ( ) const

inline

Retrieve the column on which this cursor is situated.

Returns

column number, where 0 is the first column.

Definition at line 141 of file katetextcursor.h.

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 147 of file katetextcursor.h.

KTextEditor::Document * Kate::TextCursor::document

(

)

const

Gets the document to which this cursor is bound.

Returns

a pointer to the document

Definition at line 142 of file katetextcursor.cpp.

InsertBehavior Kate::TextCursor::insertBehavior ( ) const

inline

Get current insert behavior.

Returns

current insert behavior

Definition at line 84 of file katetextcursor.h.

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 159 of file katetextcursor.h.

int Kate::TextCursor::line

(

)

const

Retrieve the line on which this cursor is situated.

Returns

line number, where 0 is the first line.

Definition at line 132 of file katetextcursor.cpp.

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 171 of file katetextcursor.h.

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.

Definition at line 127 of file katetextcursor.h.

KTextEditor::MovingRange * Kate::TextCursor::range

(

)

const

Get range this cursor belongs to, if any.

Returns

range this pointer is part of, else 0

Definition at line 147 of file katetextcursor.cpp.

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

inline

Set insert behavior.

Parameters

insertBehavior

new insert behavior

Definition at line 78 of file katetextcursor.h.

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 64 of file katetextcursor.cpp.

void Kate::TextCursor::setPosition

(

const KTextEditor::Cursor &

position

)

Set the current cursor position to position.

Parameters

position

new cursor position

Definition at line 127 of file katetextcursor.cpp.

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

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 cursor position to line and column.

Parameters

line	new cursor line
column	new cursor column

Definition at line 114 of file katetextcursor.h.

---

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

• katetextcursor.h
• katetextcursor.cpp