#include <CzUITextView.h>

Inheritance diagram for CzUITextView:

Public Member Functions
void	setArea (CzIVec2 &size)
CzIVec2	getArea () const
void	setZoom (float scale)
float	getZoom () const
void	setMinZoom (float scale)
float	getMinZoom () const
void	setMaxZoom (float scale)
float	getMaxZoom () const
bool	setProperty (unsigned int property_name, const CzXomlProperty &data, bool delta)
	Sets the named property of the UITextView.
bool	setProperty (unsigned int property_name, const CzString &data, bool delta)
	Sets the named property of the actor.
bool	getProperty (unsigned int property_name, CzXomlProperty &prop)
	Gets the named property of the actor.
	CzUITextView ()
virtual bool	InitView (bool native_res, float min_scale, float max_scale)
bool	Update (float dt)
	Updates this actors logic.
bool	UpdateVisual ()
	Updates the actors visual.
void	NotifyBeginTouch (int index, int x, int y, bool allow_bubble)
	OnBeginTouch event handler.
void	NotifyEndTouch (int index, int x, int y, bool allow_bubble)
	OnEndTouch event handler.
int	LoadFromXoml (IzXomlResource parent, bool load_children, CzXmlNode node)
	Creates an instance of this class from XML.
bool	UpdateFromAnimation (CzAnimInstance *animation)
	Updates actor property from supplied animation.
Static Public Member Functions
static void	InitClass ()
	Initialises the class.
static void	ReleaseClass ()
static bool	_setMinZoom (IzXomlResource *target, const CzXomlProperty &prop, bool add)
static CzXomlProperty	_getMinZoom (IzXomlResource *target)
static bool	_setMaxZoom (IzXomlResource *target, const CzXomlProperty &prop, bool add)
static CzXomlProperty	_getMaxZoom (IzXomlResource *target)
static bool	_setZoom (IzXomlResource *target, const CzXomlProperty &prop, bool add)
static CzXomlProperty	_getZoom (IzXomlResource *target)
static bool	_setArea (IzXomlResource *target, const CzXomlProperty &prop, bool add)
static CzXomlProperty	_getArea (IzXomlResource *target)
Protected Member Functions
bool	UpdateBinding (unsigned int property_name, CzXomlVariable *var)
	Updates an actor property from the supplied XOML variable.
Protected Attributes
CzIVec2	Area
	The area that the etxt should fit into.
float	Zoom
	Current zoom.
float	MinZoom
	The minimum zoom point.
float	MaxZoom
	The maximum zoom point.
float	PrevZoom
CzVec2	Midpoint
bool	ZoomValid
float	PreviousDist
float	CompoundScale
CzVec2	CompoundPosition
float	SavedCompoundScale
CzVec2	SavedCompoundPosition
CzVec2	PanVelocity
int	TouchIndices [2]
int	NumTouches
Static Protected Attributes
static CzXomlClassDef *	TextViewClassDef = NULL

Constructor & Destructor Documentation

CzUITextView::CzUITextView ( )

Member Function Documentation

CzXomlProperty CzUITextView::_getArea ( IzXomlResource * target ) [static]

CzXomlProperty CzUITextView::_getMaxZoom ( IzXomlResource * target ) [static]

CzXomlProperty CzUITextView::_getMinZoom ( IzXomlResource * target ) [static]

CzXomlProperty CzUITextView::_getZoom ( IzXomlResource * target ) [static]

bool CzUITextView::_setArea	(	IzXomlResource *	target,
		const CzXomlProperty &	prop,
		bool	add
	)		`[static]`

bool CzUITextView::_setMaxZoom	(	IzXomlResource *	target,
		const CzXomlProperty &	prop,
		bool	add
	)		`[static]`

bool CzUITextView::_setMinZoom	(	IzXomlResource *	target,
		const CzXomlProperty &	prop,
		bool	add
	)		`[static]`

bool CzUITextView::_setZoom	(	IzXomlResource *	target,
		const CzXomlProperty &	prop,
		bool	add
	)		`[static]`

CzIVec2 CzUITextView::getArea ( ) const [inline]

float CzUITextView::getMaxZoom ( ) const [inline]

float CzUITextView::getMinZoom ( ) const [inline]

bool CzUITextView::getProperty	(	unsigned int	property_name,
		CzXomlProperty &	prop
	)		`[virtual]`

Gets the named property of the actor.

Returns the named property of the actor. The properties value is returned in a CzXomlProperty which is a structure that contains a union of all possible property types. Note that as CzUITextView is derived from CzUILabel, all CzUILabel properties will also be checked against.

Parameters:

	property_name	Name of the property.
[out]	prop	The property data that.

Returns:: true if it succeeds, false if property does not exist.

Reimplemented from CzUILabel.

float CzUITextView::getZoom ( ) const [inline]

void CzUITextView::InitClass ( ) [static]

Initialises the class.

Sets up the classes avaiiable properties. Used by the XOML system to find, set amd get class properties.

Reimplemented from CzUILabel.

bool CzUITextView::InitView	(	bool	native_res,
		float	min_scale,
		float	max_scale
	)		`[virtual]`

int CzUITextView::LoadFromXoml	(	IzXomlResource *	parent,
		bool	load_children,
		CzXmlNode *	node
	)		`[virtual]`

Creates an instance of this class from XML.

LoadFromXoml is the main method used by all classes that can be instantiated from XOML mark-up. This method creates an instance of this class from the supplied XML node structure specified by node. if parent is not NULL then the created instance will utilise the supplied parent to determine where it should live within the app. For example, if the parent is a scene then the actor will be placed in that scene. if the parent is another actor then this actor will be placed into the scene of the supplied actor and linked as a child to the parent actor. If load_chlldren is true then any child nodes contained within the actor will also be loaded. Note that as CzUITextView is derived from CzUILabel, CzUILabel::LoadFromXoml() will also be called to load CzUILabel specific properties.

Parameters:

[in]	parent	If non-null, the parent.
	load_children	true to load child nodes.
[in]	node	If non-null, the XOML markup node that defines this object

Returns:: negative value for error. if 0 then processing of further XOML will stop.

Reimplemented from CzUILabel.

void CzUITextView::NotifyBeginTouch	(	int	index,
		int	x,
		int	y,
		bool	allow_bubble
	)		`[virtual]`

OnBeginTouch event handler.

The OnBeginTouch event handler is called whenever the user begins to touch the actor. Actors can process up to 5 simultaneous touch events OnBeginTouch to OnBeginTouch5. if event bubbling is enabled then the event will also be passed up to the parent.

This version of this method enables actors to utilise a selected state

Parameters:

index	Index of the touch.
x	The touched x coordinate.
y	The touched y coordinate.
allow_bubble	true to allow event bubbling, false to deny event bubbling.

Reimplemented from CzUIBase.

void CzUITextView::NotifyEndTouch	(	int	index,
		int	x,
		int	y,
		bool	allow_bubble
	)		`[virtual]`

OnEndTouch event handler.

The OnEndTouch event handler is called whenever the user stops touching the actor. This can occur for a number fo reasons including:

if the user lifts their finger off the actor
If the user moves their finger too from the actor (loses focus)
if the user scrolls the container (list boc for example)
The scene is switched

Actors can process up to 5 simultaneous touch events OnEndTouch to OnEndTouch5. if event bubbling is enabled then the event will also be passed up to the parent.

This version of this method enables actors to utilise a selected state

Parameters:

index	Index of the touch.
x	The touched x coordinate.
y	The touched y coordinate.
allow_bubble	true to allow event bubbling, false to deny event bubbling.

Reimplemented from CzUIBase.

void CzUITextView::ReleaseClass ( ) [static]

Reimplemented from CzUILabel.

void CzUITextView::setArea ( CzIVec2 & size )

void CzUITextView::setMaxZoom ( float scale ) [inline]

void CzUITextView::setMinZoom ( float scale ) [inline]

bool CzUITextView::setProperty	(	unsigned int	property_name,
		const CzXomlProperty &	data,
		bool	delta
	)		`[virtual]`

Sets the named property of the UITextView.

Sets the named property of this UITextView. The properties value supplied will be converted. If delta is set to true then the existing value of the property will be added to instead of replaced.

Parameters:

	property_name	Name of the property as a string hash (faster searching).
[in]	data	The property data.
	delta	true if property should be added to instead of replaced.

Returns:: true if it succeeds, false if property does not exist.

Reimplemented from CzUILabel.

bool CzUITextView::setProperty	(	unsigned int	property_name,
		const CzString &	data,
		bool	delta
	)		`[virtual]`

Sets the named property of the actor.

Sets the named property of this actor. The properties value (data) is supplied as a string and will be converted. If delta is set to true then the existing value of the property will be added to instead of replaced. Note that as CzUITextView is derived from CzUILabel, all CzUILabel properties will also be checked against.

Parameters:

	property_name	Name of the property as a string hash (faster searching).
[in]	data	The property data.
	delta	true to property should be added to instead of replaced.

Returns:: true if it succeeds, false if property does not exist.

Reimplemented from CzUILabel.

void CzUITextView::setZoom ( float scale )

bool CzUITextView::Update ( float dt ) [virtual]

Updates this actors logic.

Updates the UI actors logic, including:

Processing event actions
Processing any attached modifiers
Updating dragging state
Updating physics
Updating the attached timeline
Updating any show / hide timelines
Updating the scroller
Checking for an updating layout if dirty

This method should be overriden by derived actors to provide the UI actor specific logic.

Note that dt is used to scale actor internals that rely on time. This value enables the actor run in an environment where time (the frame rate of the device) can vary allowing animation to keep up without slowing down or speeding up when the frame rate varies.

Note that if an actor returns false then it will automatically be removed from the scene.

Parameters:

dt	The number of seconds since the app was last updated

Returns:: true if it succeeds, false if it fails.

Reimplemented from CzUILabel.

bool CzUITextView::UpdateBinding	(	unsigned int	property_name,
		CzXomlVariable *	var
	)		`[protected, virtual]`

Updates an actor property from the supplied XOML variable.

Updates a single property from the value of the bound XOML variable. Note that as CzUITextView is derived from CzUILabel, all CzUILabel properties will also be checked against.

Parameters:

	property_name	Name of the property.
[in,out]	var	If non-null, the variable.

Returns:: true if it succeeds, false if property does not exist.

Reimplemented from CzUILabel.

bool CzUITextView::UpdateFromAnimation ( CzAnimInstance * animation ) [virtual]

Updates actor property from supplied animation.

Updates the actors property that is specified by the supplied animation. When a timeline animation targets the property of an actor this method will be called by the animation to move the animations frame data into its target property. Note that as CzUITextView is derived from CzUILabel, all CzUILabel properties will also be checked against.

Parameters:

[in] animation If non-null, the animation.