KateRenderer Class Reference

#include <katerenderer.h>

Public Types
enum	caretStyles { Insert , Replace }

Public Member Functions
	KateRenderer (KateDocument *doc, KateView *view=0)
	~KateRenderer ()
void	updateAttributes ()
bool	drawCaret () const
void	setDrawCaret (bool drawCaret)
KateRenderer::caretStyles	caretStyle () const
void	setCaretStyle (KateRenderer::caretStyles style)
bool	showTabs () const
void	setShowTabs (bool showTabs)
void	setTabWidth (int tabWidth)
bool	showIndentLines () const
void	setShowIndentLines (bool showLines)
void	setIndentWidth (int indentWidth)
bool	showSelections () const
void	setShowSelections (bool showSelections)
void	increaseFontSizes ()
void	decreaseFontSizes ()
const TQFont *	currentFont ()
const TQFontMetrics *	currentFontMetrics ()
bool	isPrinterFriendly () const
void	setPrinterFriendly (bool printerFriendly)
uint	spaceWidth ()
uint	textWidth (const KateTextLine::Ptr &, int cursorCol)
uint	textWidth (const KateTextLine::Ptr &textLine, uint startcol, uint maxwidth, bool *needWrap, int *endX=0)
uint	textWidth (const KateTextCursor &cursor)
uint	textWidth (KateTextCursor &cursor, int xPos, uint startCol=0)
uint	textPos (uint line, int xPos, uint startCol=0, bool nearest=true)
uint	textPos (const KateTextLine::Ptr &, int xPos, uint startCol=0, bool nearest=true)
uint	fontHeight ()
uint	documentHeight ()
bool	getSelectionBounds (uint line, uint lineLength, uint &start, uint &end)
void	paintTextLine (TQPainter &paint, const KateLineRange *range, int xStart, int xEnd, const KateTextCursor *cursor=0L, const KateBracketRange *bracketmark=0L)
bool	paintTextLineBackground (TQPainter &paint, int line, bool isCurrentLine, int xStart, int xEnd)
KateAttribute *	attribute (uint pos)
KateRendererConfig *	config ()
void	updateConfig ()

Detailed Description

Handles all of the work of rendering the text (used for the views and printing)

Definition at line 42 of file katerenderer.h.

Member Enumeration Documentation

caretStyles

enum KateRenderer::caretStyles

Style of Caret (Insert or Replace mode)

Definition at line 48 of file katerenderer.h.

Constructor & Destructor Documentation

KateRenderer()

KateRenderer::KateRenderer	(	KateDocument *	doc,
		KateView *	view = 0
	)

Constructor.

Parameters

doc	document to render
view	view which is output (0 for example for rendering to print)

Definition at line 37 of file katerenderer.cpp.

~KateRenderer()

KateRenderer::~KateRenderer

(

)

Destructor.

Definition at line 57 of file katerenderer.cpp.

Member Function Documentation

attribute()

KateAttribute * KateRenderer::attribute

(

uint

pos

)

This takes an in index, and returns all the attributes for it.

For example, if you have a ktextline, and want the KateAttribute for a given position, do:

attribute(myktextline->attribute(position));

Definition at line 69 of file katerenderer.cpp.

caretStyle()

KateRenderer::caretStyles KateRenderer::caretStyle ( ) const

inline

The style of the caret (text cursor) to be painted.

Returns

caretStyle

Definition at line 87 of file katerenderer.h.

config()

KateRendererConfig * KateRenderer::config ( )

inline

Configuration.

Definition at line 264 of file katerenderer.h.

currentFont()

const TQFont * KateRenderer::currentFont

(

)

Definition at line 933 of file katerenderer.cpp.

currentFontMetrics()

const TQFontMetrics * KateRenderer::currentFontMetrics

(

)

Definition at line 938 of file katerenderer.cpp.

decreaseFontSizes()

void KateRenderer::decreaseFontSizes

(

)

Definition at line 129 of file katerenderer.cpp.

documentHeight()

uint KateRenderer::documentHeight

(

)

Definition at line 984 of file katerenderer.cpp.

drawCaret()

bool KateRenderer::drawCaret ( ) const

inline

Determine whether the caret (text cursor) will be drawn.

Returns

should it be drawn?

Definition at line 75 of file katerenderer.h.

fontHeight()

uint KateRenderer::fontHeight

(

)

Definition at line 979 of file katerenderer.cpp.

getSelectionBounds()

bool KateRenderer::getSelectionBounds	(	uint	line,
		uint	lineLength,
		uint &	start,
		uint &	end
	)

Definition at line 989 of file katerenderer.cpp.

increaseFontSizes()

void KateRenderer::increaseFontSizes

(

)

Change to a different font (soon to be font set?)

Definition at line 121 of file katerenderer.cpp.

isPrinterFriendly()

bool KateRenderer::isPrinterFriendly

(

)

const

Returns

whether the renderer is configured to paint in a printer-friendly fashion.

Definition at line 139 of file katerenderer.cpp.

paintTextLine()

void KateRenderer::paintTextLine	(	TQPainter &	paint,
		const KateLineRange *	range,
		int	xStart,
		int	xEnd,
		const KateTextCursor *	cursor = 0L,
		const KateBracketRange *	bracketmark = 0L
	)

This is the ultimate function to perform painting of a text line.

(supports startcol/endcol, startx/endx)

The text line is painted from the upper limit of (0,0). To move that, apply a transform to your painter.

Definition at line 253 of file katerenderer.cpp.

paintTextLineBackground()

bool KateRenderer::paintTextLineBackground	(	TQPainter &	paint,
		int	line,
		bool	isCurrentLine,
		int	xStart,
		int	xEnd
	)

Paint the background of a line.

Split off from the main paintTextLine method to make it smaller. As it's being called only once per line it shouldn't noticably affect performance and it helps readability a LOT.

Returns

whether the selection has been painted or not

Definition at line 152 of file katerenderer.cpp.

setCaretStyle()

void KateRenderer::setCaretStyle

(

KateRenderer::caretStyles

style

)

Set the style of caret to be painted.

Parameters

style

style to set

Definition at line 82 of file katerenderer.cpp.

setDrawCaret()

void KateRenderer::setDrawCaret

(

bool

drawCaret

)

Set whether the caret (text cursor) will be drawn.

Parameters

drawCaret

should caret be drawn?

Definition at line 77 of file katerenderer.cpp.

setIndentWidth()

void KateRenderer::setIndentWidth

(

int

indentWidth

)

Sets the width of the tab.

Helps performance.

Parameters

indentWidth

new indent width

Definition at line 107 of file katerenderer.cpp.

setPrinterFriendly()

void KateRenderer::setPrinterFriendly

(

bool

printerFriendly

)

Configure this renderer to paint in a printer-friendly fashion.

Sets the other options appropriately if true.

Definition at line 144 of file katerenderer.cpp.

setShowIndentLines()

void KateRenderer::setShowIndentLines

(

bool

showLines

)

Set whether a guide should be painted to help identifying indent lines.

Parameters

showLines

show the indent lines?

Definition at line 102 of file katerenderer.cpp.

setShowSelections()

void KateRenderer::setShowSelections

(

bool

showSelections

)

Set whether the view's selections should be shown.

The default is true.

Parameters

showSelections

show the selections?

Definition at line 116 of file katerenderer.cpp.

setShowTabs()

void KateRenderer::setShowTabs

(

bool

showTabs

)

Set whether a mark should be painted to help identifying tabs.

Parameters

showTabs

show the tabs?

Definition at line 87 of file katerenderer.cpp.

setTabWidth()

void KateRenderer::setTabWidth

(

int

tabWidth

)

Sets the width of the tab.

Helps performance.

Parameters

tabWidth

new tab width

Definition at line 92 of file katerenderer.cpp.

showIndentLines()

bool KateRenderer::showIndentLines

(

)

const

Returns

whether indent lines should be shown

indent lines should be shown

Definition at line 97 of file katerenderer.cpp.

showSelections()

bool KateRenderer::showSelections ( ) const

inline

Show the view's selection?

Returns

show sels?

Definition at line 136 of file katerenderer.h.

showTabs()

bool KateRenderer::showTabs ( ) const

inline

Returns

whether tabs should be shown (ie. a small mark drawn to identify a tab)

tabs should be shown

Definition at line 100 of file katerenderer.h.

spaceWidth()

uint KateRenderer::spaceWidth

(

)

Text width & height calculation functions...

Definition at line 1039 of file katerenderer.cpp.

textPos() [1/2]

uint KateRenderer::textPos	(	const KateTextLine::Ptr &	textLine,
		int	xPos,
		uint	startCol = 0,
		bool	nearest = true
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 948 of file katerenderer.cpp.

textPos() [2/2]

uint KateRenderer::textPos	(	uint	line,
		int	xPos,
		uint	startCol = 0,
		bool	nearest = true
	)

Returns

the index of the character at the horixontal position xpos in line.

If nearest is true, the character starting nearest to xPos is returned. If nearest is false, the index of the character containing xPos is returned.

Definition at line 943 of file katerenderer.cpp.

textWidth() [1/4]

uint KateRenderer::textWidth

(

const KateTextCursor &

cursor

)

Definition at line 878 of file katerenderer.cpp.

textWidth() [2/4]

uint KateRenderer::textWidth	(	const KateTextLine::Ptr &	textLine,
		int	cursorCol
	)

Definition at line 739 of file katerenderer.cpp.

textWidth() [3/4]

uint KateRenderer::textWidth	(	const KateTextLine::Ptr &	textLine,
		uint	startcol,
		uint	maxwidth,
		bool *	needWrap,
		int *	endX = 0
	)

Definition at line 779 of file katerenderer.cpp.

textWidth() [4/4]

uint KateRenderer::textWidth	(	KateTextCursor &	cursor,
		int	xPos,
		uint	startCol = 0
	)

Definition at line 886 of file katerenderer.cpp.

updateAttributes()

void KateRenderer::updateAttributes

(

)

update the highlighting attributes (for example after an hl change or after hl config changed)

Definition at line 63 of file katerenderer.cpp.

updateConfig()

void KateRenderer::updateConfig

(

)

Definition at line 1030 of file katerenderer.cpp.

---

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

• katerenderer.h
• katerenderer.cpp