MultiLineEditbox class for the FalagardBase module. More...

Inheritance diagram for CEGUI::FalagardMultiLineEditbox:

Collaboration diagram for CEGUI::FalagardMultiLineEditbox:

Public Member Functions
	FalagardMultiLineEditbox (const String &type)
	Constructor.

Rect	getTextRenderArea (void) const
	Return a Rect object describing, in un-clipped pixels, the window relative area that the text should be rendered in to. More...

void	render ()
	Populate render cache. More...

Public Member Functions inherited from CEGUI::MultiLineEditboxWindowRenderer
	MultiLineEditboxWindowRenderer (const String &name)
	Constructor.

Public Member Functions inherited from CEGUI::WindowRenderer
	WindowRenderer (const String &name, const String &class_name="Window")
	Constructor. More...

virtual	~WindowRenderer ()
	Destructor.

const String &	getName () const
	Returns the factory type name of this window renderer.

Window *	getWindow () const
	Get the window this windowrenderer is attached to.

const String &	getClass () const
	Get the "minimum" Window class this renderer requires.

const WidgetLookFeel &	getLookNFeel () const
	Get the Look'N'Feel assigned to our window.

virtual Rect	getUnclippedInnerRect () const
	Get unclipped inner rectangle that our window should return from its member function with the same name.

virtual Rect	getPixelRect () const
	Get actual pixel rectangle our window is to return from its member function with the same name.

virtual void	performChildWindowLayout ()
	Method called to perform extended laying out of the window's attached child windows.

Static Public Attributes
static const utf8	TypeName [] = "Falagard/MultiLineEditbox"

static const String	UnselectedTextColourPropertyName
	Name of property to use to obtain unselected text rendering colour. More...

static const String	SelectedTextColourPropertyName
	Name of property to use to obtain selected text rendering colour.

static const String	ActiveSelectionColourPropertyName
	Name of property to use to obtain active selection rendering colour.

static const String	InactiveSelectionColourPropertyName
	Name of property to use to obtain inactive selection rendering colour.

Protected Member Functions
void	cacheEditboxBaseImagery ()
	Perform rendering of the widget control frame and other 'static' areas. This method should not render the actual text. Note that the text will be rendered to layer 4 and the selection brush to layer 3, other layers can be used for rendering imagery behind and infront of the text & selection.. More...

void	cacheCaratImagery (const Rect &textArea)
	Render the carat. More...

void	cacheTextLines (const Rect &dest_area)
	Render text lines.

colour	getUnselectedTextColour () const
	return the colour to be used for rendering Editbox text oustside of the selected region. More...

colour	getActiveSelectionColour () const
	return the colour to be used for rendering the selection highlight when the editbox is active. More...

colour	getInactiveSelectionColour () const
	return the colour to be used for rendering the selection highlight when the editbox is inactive. More...

colour	getSelectedTextColour () const
	return the colour to be used for rendering Editbox text falling within the selected region. More...

colour	getOptionalPropertyColour (const String &propertyName) const
	Return a colour object fetched from the named property if it exists, else a default colour (black). More...

Additional Inherited Members
Protected Types inherited from CEGUI::WindowRenderer
typedef std::vector< Property * >	PropertyList

Protected Attributes inherited from CEGUI::WindowRenderer
Window *	d_window
	Pointer to the window this windowrenderer is assigned to.

const String	d_name
	Name of the factory type used to create this window renderer.

const String	d_class
	Name of the widget class that is the "minimum" requirement.

PropertyList	d_properties
	The list of properties that this windowrenderer will be handling.

Detailed Description

MultiLineEditbox class for the FalagardBase module.

This class requires LookNFeel to be assigned. The LookNFeel should provide the following:

States:

Enabled - Rendering for when the editbox is in enabled and is in read-write mode.
ReadOnly - Rendering for when the editbox is in enabled and is in read-only mode.
Disabled - Rendering for when the editbox is disabled.

NamedAreas: TextArea - area where text, selection, and carat imagery will appear. TextAreaHScroll - TextArea when only horizontal scrollbar is visible. TextAreaVScroll - TextArea when only vertical scrollbar is visible. TextAreaHVScroll - TextArea when both horizontal and vertical scrollbar is visible.

PropertyDefinitions (optional, defaults will be black):

NormalTextColour - property that accesses a colour value to be used to render normal unselected text.
SelectedTextColour - property that accesses a colour value to be used to render selected text.
ActiveSelectionColour - property that accesses a colour value to be used to render active selection highlight.
InactiveSelectionColour - property that accesses a colour value to be used to render inactive selection highlight.

Imagery Sections:

Carat

Child Widgets: Scrollbar based widget with name suffix "__auto_vscrollbar__" Scrollbar based widget with name suffix "__auto_hscrollbar__"

Member Function Documentation

void CEGUI::FalagardMultiLineEditbox::cacheCaratImagery ( const Rect & textArea )

protected

Render the carat.

Returns: Nothing

References CEGUI::WindowRenderer::d_window, CEGUI::ImagerySection::getBoundingRect(), CEGUI::MultiLineEditbox::getCaratIndex(), CEGUI::Renderer::getCurrentZ(), CEGUI::Window::getFont(), CEGUI::MultiLineEditbox::getHorzScrollbar(), CEGUI::WidgetLookFeel::getImagerySection(), CEGUI::MultiLineEditbox::getLineNumberFromIndex(), CEGUI::Font::getLineSpacing(), CEGUI::WindowRenderer::getLookNFeel(), CEGUI::System::getRenderer(), CEGUI::Scrollbar::getScrollPosition(), CEGUI::System::getSingleton(), CEGUI::Rect::getSize(), CEGUI::Window::getText(), CEGUI::Font::getTextExtent(), CEGUI::MultiLineEditbox::getVertScrollbar(), CEGUI::Renderer::getZLayer(), CEGUI::Rect::offset(), CEGUI::ImagerySection::render(), CEGUI::Rect::setHeight(), CEGUI::Rect::setWidth(), and CEGUI::String::substr().

Referenced by render().

void CEGUI::FalagardMultiLineEditbox::cacheEditboxBaseImagery ( )

protected

Perform rendering of the widget control frame and other 'static' areas. This method should not render the actual text. Note that the text will be rendered to layer 4 and the selection brush to layer 3, other layers can be used for rendering imagery behind and infront of the text & selection..

Returns: Nothing.

References CEGUI::WindowRenderer::d_window, CEGUI::WindowRenderer::getLookNFeel(), CEGUI::WidgetLookFeel::getStateImagery(), CEGUI::Window::isDisabled(), CEGUI::MultiLineEditbox::isReadOnly(), and CEGUI::StateImagery::render().

Referenced by render().

colour CEGUI::FalagardMultiLineEditbox::getActiveSelectionColour ( ) const

protected

return the colour to be used for rendering the selection highlight when the editbox is active.

Returns: colour value describing the colour to be used.

References ActiveSelectionColourPropertyName, and getOptionalPropertyColour().

Referenced by cacheTextLines().

colour CEGUI::FalagardMultiLineEditbox::getInactiveSelectionColour ( ) const

protected

return the colour to be used for rendering the selection highlight when the editbox is inactive.

Returns: colour value describing the colour to be used.

References getOptionalPropertyColour(), and InactiveSelectionColourPropertyName.

Referenced by cacheTextLines().

colour CEGUI::FalagardMultiLineEditbox::getOptionalPropertyColour ( const String & propertyName ) const

protected

Return a colour object fetched from the named property if it exists, else a default colour (black).

Parameters

propertyName String object holding the name of the property to be accessed if it exists.

References CEGUI::WindowRenderer::d_window, CEGUI::PropertySet::getProperty(), and CEGUI::PropertySet::isPropertyPresent().

Referenced by getActiveSelectionColour(), getInactiveSelectionColour(), getSelectedTextColour(), and getUnselectedTextColour().

colour CEGUI::FalagardMultiLineEditbox::getSelectedTextColour ( ) const

protected

return the colour to be used for rendering Editbox text falling within the selected region.

Returns: colour value describing the colour to be used.

References getOptionalPropertyColour(), and SelectedTextColourPropertyName.

Referenced by cacheTextLines().

Rect CEGUI::FalagardMultiLineEditbox::getTextRenderArea ( void ) const

virtual

Return a Rect object describing, in un-clipped pixels, the window relative area that the text should be rendered in to.

Returns: Rect object describing the area of the Window to be used for rendering text.

Implements CEGUI::MultiLineEditboxWindowRenderer.

References CEGUI::WindowRenderer::d_window, CEGUI::NamedArea::getArea(), CEGUI::MultiLineEditbox::getHorzScrollbar(), CEGUI::WindowRenderer::getLookNFeel(), CEGUI::WidgetLookFeel::getNamedArea(), CEGUI::ComponentArea::getPixelRect(), CEGUI::MultiLineEditbox::getVertScrollbar(), CEGUI::WidgetLookFeel::isNamedAreaDefined(), and CEGUI::Window::isVisible().

Referenced by render().

colour CEGUI::FalagardMultiLineEditbox::getUnselectedTextColour ( ) const

protected

return the colour to be used for rendering Editbox text oustside of the selected region.

Returns: colour value describing the colour to be used.

References getOptionalPropertyColour(), and UnselectedTextColourPropertyName.

Referenced by cacheTextLines().

void CEGUI::FalagardMultiLineEditbox::render ( )

virtual

Populate render cache.

This method must be implemented by all window renderers and should perform the rendering operations needed for this widget. Normally using the Falagard API...

Implements CEGUI::WindowRenderer.

References cacheCaratImagery(), cacheEditboxBaseImagery(), cacheTextLines(), CEGUI::WindowRenderer::d_window, getTextRenderArea(), CEGUI::MultiLineEditbox::hasInputFocus(), and CEGUI::MultiLineEditbox::isReadOnly().

Member Data Documentation

const String CEGUI::FalagardMultiLineEditbox::UnselectedTextColourPropertyName

static

Name of property to use to obtain unselected text rendering colour.

type name for this widget.

Referenced by getUnselectedTextColour().

Public Member Functions

Static Public Attributes

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

Member Data Documentation