Widget Class Reference

Base class for all ui widgets. More...

#include <UIWidget.h>

Inheritance diagram for Widget:

Public Types
enum	FocusDirection { LEFT, RIGHT, UP, DOWN }
	Widget focus direction. More...
enum	PositionType { ABSOLUTE, PERCENT }
	Widget position type for layout. More...
enum	SizeType { ABSOLUTE, PERCENT }
	Widget size type for layout. More...
enum	TouchEventType { BEGAN, MOVED, ENDED, CANCELED }
	Touch event type. More...
enum	TextureResType { LOCAL = 0, PLIST = 1 }
	Texture resource type. More...
enum	BrightStyle { NONE = -1, NORMAL, HIGHLIGHT }
	Widget bright style. More...
typedef std::function< void(Ref *, Widget::TouchEventType)>	ccWidgetTouchCallback
	Widget touch event callback. More...
typedef std::function< void(Ref *)>	ccWidgetClickCallback
	Widget click event callback. More...
typedef std::function< void(Ref *, int)>	ccWidgetEventCallback
	Widget custom event callback. More...
Public Types inherited from Node
enum	{ FLAGS_TRANSFORM_DIRTY = (1 << 0), FLAGS_CONTENT_SIZE_DIRTY = (1 << 1), FLAGS_RENDER_AS_3D = (1 << 3), FLAGS_DIRTY_MASK = (FLAGS_TRANSFORM_DIRTY | FLAGS_CONTENT_SIZE_DIRTY) }

Public Member Functions
	Widget (void)
	Default constructor. More...
virtual	~Widget ()
	Default destructor. More...
virtual void	setEnabled (bool enabled)
	Sets whether the widget is enabled. More...
bool	isEnabled () const
	Determines if the widget is enabled or not. More...
void	setBright (bool bright)
	Sets whether the widget is bright. More...
bool	isBright () const
	Determines if the widget is bright. More...
virtual void	setTouchEnabled (bool enabled)
	Sets whether the widget is touch enabled. More...
void	setBrightStyle (BrightStyle style)
	To set the bright style of widget. More...
bool	isTouchEnabled () const
	Determines if the widget is touch enabled. More...
bool	isHighlighted () const
	Determines if the widget is highlighted. More...
void	setHighlighted (bool hilight)
	Sets whether the widget is hilighted. More...
float	getLeftInParent ()
	Gets the left boundary position of this widget in parent's coordination system. More...
float	getLeftBoundary () const
	Gets the left boundary position of this widget in parent's coordination system. More...
float	getBottomInParent ()
	Gets the bottom boundary position of this widget in parent's coordination system. More...
float	getBottomBoundary () const
	Gets the bottom boundary position of this widget in parent's coordination system. More...
float	getRightInParent ()
	Gets the right boundary position of this widget in parent's coordination system. More...
float	getRightBoundary () const
	Gets the right boundary position of this widget in parent's coordination system. More...
float	getTopInParent ()
	Gets the top boundary position of this widget in parent's coordination system. More...
float	getTopBoundary () const
	Gets the top boundary position of this widget in parent's coordination system. More...
virtual void	visit (cocos2d::Renderer *renderer, const Mat4 &parentTransform, uint32_t parentFlags) override
	Visits this node's children and draw them recursively. More...
void	addTouchEventListener (Ref *target, SEL_TouchEvent selector)
	Sets the touch event target/selector to the widget. More...
void	addTouchEventListener (const ccWidgetTouchCallback &callback)
	Set a callback to touch vent listener. More...
void	addClickEventListener (const ccWidgetClickCallback &callback)
	Set a click event handler to the widget. More...
virtual void	addCCSEventListener (const ccWidgetEventCallback &callback)
	Set a event handler to the widget in order to use cocostudio editor and framework. More...
virtual void	setPosition (const Vec2 &pos) override
	Changes the position (x,y) of the widget in OpenGL coordinates. More...
void	setPositionPercent (const Vec2 &percent)
	Set the percent(x,y) of the widget in OpenGL coordinates. More...
const Vec2 &	getPositionPercent ()
	Gets the percent (x,y) of the widget in OpenGL coordinates. More...
void	setPositionType (PositionType type)
	Changes the position type of the widget. More...
PositionType	getPositionType () const
	Gets the position type of the widget. More...
virtual void	setFlippedX (bool flippedX)
	Sets whether the widget should be flipped horizontally or not. More...
virtual bool	isFlippedX () const
	Returns the flag which indicates whether the widget is flipped horizontally or not. More...
virtual void	setFlippedY (bool flippedY)
	Sets whether the widget should be flipped vertically or not. More...
virtual bool	isFlippedY () const
	Return the flag which indicates whether the widget is flipped vertically or not. More...
bool	isFlipX ()
void	setFlipX (bool flipX)
bool	isFlipY ()
void	setFlipY (bool flipY)
virtual void	setScaleX (float scaleX) override
	Sets the scale (x) of the node. More...
virtual void	setScaleY (float scaleY) override
	Sets the scale (y) of the node. More...
virtual void	setScale (float scale) override
	Sets the scale (x,y,z) of the node. More...
virtual void	setScale (float scalex, float scaley) override
	Sets the scale (x,y) of the node. More...
virtual float	getScaleX () const override
	Returns the scale factor on X axis of this node. More...
virtual float	getScaleY () const override
	Returns the scale factor on Y axis of this node. More...
virtual float	getScale () const override
	Gets the scale factor of the node, when X and Y have the same scale factor. More...
bool	clippingParentAreaContainPoint (const Vec2 &pt)
	Checks a point if in parent's area. More...
bool	isClippingParentContainsPoint (const Vec2 &pt)
	Checks a point if in parent's area. More...
const Vec2 &	getTouchStartPos () const
	Gets the touch began point of widget when widget is selected. More...
const Vec2 &	getTouchBeganPosition () const
	Gets the touch began point of widget when widget is selected. More...
const Vec2 &	getTouchMovePos () const
const Vec2 &	getTouchMovePosition () const
const Vec2 &	getTouchEndPos () const
const Vec2 &	getTouchEndPosition () const
virtual void	setSize (const Size &size)
	Changes the size that is widget's size. More...
virtual void	setContentSize (const Size &contentSize) override
	Changes the size that is widget's size. More...
virtual void	setSizePercent (const Vec2 &percent)
	Changes the percent that is widget's percent size. More...
void	setSizeType (SizeType type)
	Changes the size type of widget. More...
SizeType	getSizeType () const
	Gets the size type of widget. More...
const Size &	getSize () const
	Get the size of widget. More...
const Size &	getCustomSize () const
	Get the user defined widget size. More...
virtual const Size &	getLayoutSize ()
	Get the content size of widget. More...
const Vec2 &	getSizePercent ()
	Get size percent of widget. More...
virtual bool	hitTest (const Vec2 &pt)
	Checks a point is in widget's content space. More...
virtual bool	onTouchBegan (Touch *touch, Event *unusedEvent)
	A callback which will be called when touch began event is issued. More...
virtual void	onTouchMoved (Touch *touch, Event *unusedEvent)
	A callback which will be called when touch moved event is issued. More...
virtual void	onTouchEnded (Touch *touch, Event *unusedEvent)
	A callback which will be called when touch ended event is issued. More...
virtual void	onTouchCancelled (Touch *touch, Event *unusedEvent)
	A callback which will be called when touch cancelled event is issued. More...
void	setLayoutParameter (LayoutParameter *parameter)
	Sets a LayoutParameter to widget. More...
LayoutParameter *	getLayoutParameter () const override
	Gets LayoutParameter of widget. More...
LayoutParameter *	getLayoutParameter (LayoutParameter::Type type)
	Gets LayoutParameter of widget. More...
virtual void	ignoreContentAdaptWithSize (bool ignore)
	Toggle whether ignore user defined content size for widget. More...
bool	isIgnoreContentAdaptWithSize () const
	Query whether the widget ignores user deinfed content size or not. More...
Vec2	getWorldPosition () const
	Gets position of widget in world space. More...
virtual Node *	getVirtualRenderer ()
	Gets the inner Renderer node of widget. More...
virtual Size	getVirtualRendererSize () const
	Get the virtual renderer's size. More...
virtual std::string	getDescription () const override
	Returns the string representation of widget class name. More...
Widget *	clone ()
	Create a new widget copy of the original one. More...
virtual void	onEnter () override
	Event callback that is invoked every time when Node enters the 'stage'. More...
virtual void	onExit () override
	Event callback that is invoked every time the Node leaves the 'stage'. More...
void	updateSizeAndPosition ()
	Update all children's contents size and position recursively. More...
void	updateSizeAndPosition (const Size &parentSize)
	Update all children's contents size and position recursively. More...
void	setActionTag (int tag)
	Set the tag of action. More...
int	getActionTag () const
	Get the action tag. More...
void	setPropagateTouchEvents (bool isPropagate)
	Allow widget touch events to propagate to its parents. More...
bool	isPropagateTouchEvents () const
	Return whether the widget is propagate touch events to its parents or not. More...
void	setSwallowTouches (bool swallow)
	Toggle widget swallow touch option. More...
bool	isSwallowTouches () const
	Return whether the widget is swallowing touch or not. More...
bool	isFocused () const
	Query whether widget is focused or not. More...
void	setFocused (bool focus)
	Toggle widget focus status. More...
bool	isFocusEnabled () const
	Query widget's focus enable state. More...
void	setFocusEnabled (bool enable)
	Allow widget to accept focus. More...
virtual Widget *	findNextFocusedWidget (FocusDirection direction, Widget *current)
	When a widget is in a layout, you could call this method to get the next focused widget within a specified direction. More...
void	requestFocus ()
	when a widget calls this method, it will get focus immediately. More...
Widget *	getCurrentFocusedWidget (bool isWidget)
	Return a current focused widget in your UI scene. More...
Widget *	getCurrentFocusedWidget () const
	Return a current focused widget in your UI scene. More...
void	setUnifySizeEnabled (bool enable)
	Toggle use unify size. More...
bool	isUnifySizeEnabled () const
	Query whether unify size enable state. More...
void	setCallbackName (const std::string &callbackName)
	Set callback name. More...
const std::string &	getCallbackName () const
	Query callback name. More...
void	setCallbackType (const std::string &callbackType)
	Set callback type. More...
const std::string &	getCallbackType () const
	Query callback type. More...
void	setLayoutComponentEnabled (bool enable)
	Toggle layout component enable. More...
bool	isLayoutComponentEnabled () const
	Query whether layout component is enabled or not. More...
virtual void	interceptTouchEvent (TouchEventType event, Widget *sender, Touch *touch)
void	propagateTouchEvent (TouchEventType event, Widget *sender, Touch *touch)
	Propagate touch events to its parents. More...
void	onFocusChange (Widget *widgetLostFocus, Widget *widgetGetFocus)
	This method is called when a focus change event happens. More...
void	dispatchFocusEvent (Widget *widgetLoseFocus, Widget *widgetGetFocus)
	Dispatch a EventFocus through a EventDispatcher. More...
Public Member Functions inherited from ProtectedNode
virtual void	cleanup () override
	Stops all running actions and schedulers. More...
var	cleanup ()
	Stops all running actions and schedulers. More...
local	cleanup ()
	Stops all running actions and schedulers. More...
virtual void	onEnterTransitionDidFinish () override
	Event callback that is invoked when the Node enters in the 'stage'. More...
virtual void	onExitTransitionDidStart () override
	Event callback that is called every time the Node leaves the 'stage'. More...
virtual void	updateDisplayedOpacity (GLubyte parentOpacity) override
var	updateDisplayedOpacity ( var parentOpacity)
local	updateDisplayedOpacity ( local parentOpacity)
virtual void	updateDisplayedColor (const Color3B &parentColor) override
var	updateDisplayedColor ( var parentColor)
local	updateDisplayedColor ( local parentColor)
virtual void	disableCascadeColor () override
var	disableCascadeColor ()
local	disableCascadeColor ()
virtual void	disableCascadeOpacity () override
local	disableCascadeOpacity ()
virtual void	setCameraMask (unsigned short mask, bool applyChildren=true) override
virtual	~ProtectedNode ()
virtual void	addProtectedChild (Node *child)
	Adds a child to the container with z-order as 0. More...
local	addProtectedChild ( local child)
	Adds a child to the container with z-order as 0. More...
virtual void	addProtectedChild (Node *child, int localZOrder)
	Adds a child to the container with a local z-order. More...
local	addProtectedChild ( local child, local localZOrder)
	Adds a child to the container with a local z-order. More...
virtual void	addProtectedChild (Node *child, int localZOrder, int tag)
	Adds a child to the container with z order and tag. More...
local	addProtectedChild ( local child, local localZOrder, local tag)
	Adds a child to the container with z order and tag. More...
virtual Node *	getProtectedChildByTag (int tag)
	Gets a child from the container with its tag. More...
virtual void	removeProtectedChild (Node *child, bool cleanup=true)
	Removes a child from the container. More...
local	removeProtectedChild ( local child, local true)
	Removes a child from the container. More...
virtual void	removeProtectedChildByTag (int tag, bool cleanup=true)
	Removes a child from the container by tag value. More...
var	removeProtectedChildByTag ( var tag, var true)
	Removes a child from the container by tag value. More...
local	removeProtectedChildByTag ( local tag, local true)
	Removes a child from the container by tag value. More...
virtual void	removeAllProtectedChildren ()
	Removes all children from the container with a cleanup. More...
var	removeAllProtectedChildren ()
	Removes all children from the container with a cleanup. More...
local	removeAllProtectedChildren ()
	Removes all children from the container with a cleanup. More...
virtual void	removeAllProtectedChildrenWithCleanup (bool cleanup)
	Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter. More...
var	removeAllChildren ( var cleanup)
	Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter. More...
local	removeAllChildren ( local cleanup)
	Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter. More...
virtual void	reorderProtectedChild (Node *child, int localZOrder)
	Reorders a child according to a new z value. More...
var	reorderProtectedChild ( var child, var localZOrder)
	Reorders a child according to a new z value. More...
local	reorderProtectedChild ( local child, local localZOrder)
	Reorders a child according to a new z value. More...
virtual void	sortAllProtectedChildren ()
	Sorts the children array once before drawing, instead of every time when a child is added or reordered. More...
Public Member Functions inherited from Node
virtual bool	isRunning () const
	Returns whether or not the node is "running". More...
void	scheduleUpdateWithPriorityLua (int handler, int priority)
	Schedules for lua script. More...
virtual void	draw (Renderer *renderer, const Mat4 &transform, uint32_t flags)
	Override this method to draw your own node. More...
local	draw ( local renderer, local transform, local flags)
	Override this method to draw your own node. More...
virtual void	draw () final
var	draw ()
local	draw ()
virtual void	visit () final
var	visit ()
local	visit ()
virtual Scene *	getScene () const
	Returns the Scene that contains the Node. More...
local	getScene ()
	Returns the Scene that contains the Node. More...
virtual Rect	getBoundingBox () const
	Returns an AABB (axis-aligned bounding-box) in its parent's coordinate system. More...
virtual Rect	boundingBox () const
local	boundingBox ()
virtual void	setEventDispatcher (EventDispatcher *dispatcher)
	Set event dispatcher for scene. More...
local	setEventDispatcher ( local dispatcher)
	Set event dispatcher for scene. More...
virtual EventDispatcher *	getEventDispatcher () const
	Get the event dispatcher of scene. More...
local	getEventDispatcher ()
	Get the event dispatcher of scene. More...
void	setPhysicsBody (PhysicsBody *body)
	Set the PhysicsBody that let the sprite effect with physics. More...
PhysicsBody *	getPhysicsBody () const
	Get the PhysicsBody the sprite have. More...
var	getPhysicsBody ()
	Get the PhysicsBody the sprite have. More...
local	getPhysicsBody ()
	Get the PhysicsBody the sprite have. More...
void	removeFromPhysicsWorld ()
	Remove this node from physics world. More...
var	removeFromPhysicsWorld ()
	Remove this node from physics world. More...
local	removeFromPhysicsWorld ()
	Remove this node from physics world. More...
void	updateTransformFromPhysics (const Mat4 &parentTransform, uint32_t parentFlags)
	Update the transform matrix from physics. More...
var	updateTransformFromPhysics ( var parentTransform, var parentFlags)
	Update the transform matrix from physics. More...
local	updateTransformFromPhysics ( local parentTransform, local parentFlags)
	Update the transform matrix from physics. More...
virtual void	updatePhysicsBodyTransform (const Mat4 &parentTransform, uint32_t parentFlags, float parentScaleX, float parentScaleY)
	Update physics body transform matrix. More...
var	updatePhysicsBodyTransform ( var parentTransform, var parentFlags, var parentScaleX, var parentScaleY)
	Update physics body transform matrix. More...
local	updatePhysicsBodyTransform ( local parentTransform, local parentFlags, local parentScaleX, local parentScaleY)
	Update physics body transform matrix. More...
virtual GLubyte	getOpacity () const
virtual GLubyte	getDisplayedOpacity () const
local	getDisplayedOpacity ()
virtual void	setOpacity (GLubyte opacity)
local	setOpacity ( local opacity)
virtual bool	isCascadeOpacityEnabled () const
var	isCascadeOpacityEnabled ()
local	isCascadeOpacityEnabled ()
virtual void	setCascadeOpacityEnabled (bool cascadeOpacityEnabled)
local	setCascadeOpacityEnabled ( local cascadeOpacityEnabled)
virtual const Color3B &	getColor () const
local	getColor ()
virtual const Color3B &	getDisplayedColor () const
local	getDisplayedColor ()
virtual void	setColor (const Color3B &color)
var	setColor ( var color)
local	setColor ( local color)
virtual bool	isCascadeColorEnabled () const
virtual void	setCascadeColorEnabled (bool cascadeColorEnabled)
local	setCascadeColorEnabled ( local cascadeColorEnabled)
virtual void	setOpacityModifyRGB (bool value)
var	setOpacityModifyRGB ( var value)
local	setOpacityModifyRGB ( local value)
virtual bool	isOpacityModifyRGB () const
void	setOnEnterCallback (const std::function< void()> &callback)
var	setOnEnterCallback ( var callback)
local	setOnEnterCallback ( local callback)
const std::function< void()> &	getOnEnterCallback () const
local	getOnEnterCallback ()
void	setOnExitCallback (const std::function< void()> &callback)
var	setOnExitCallback ( var callback)
local	setOnExitCallback ( local callback)
const std::function< void()> &	getOnExitCallback () const
local	getOnExitCallback ()
void	setonEnterTransitionDidFinishCallback (const std::function< void()> &callback)
var	setonEnterTransitionDidFinishCallback ( var callback)
local	setonEnterTransitionDidFinishCallback ( local callback)
const std::function< void()> &	getonEnterTransitionDidFinishCallback () const
local	getonEnterTransitionDidFinishCallback ()
void	setonExitTransitionDidStartCallback (const std::function< void()> &callback)
var	setonExitTransitionDidStartCallback ( var callback)
local	setonExitTransitionDidStartCallback ( local callback)
const std::function< void()> &	getonExitTransitionDidStartCallback () const
local	getonExitTransitionDidStartCallback ()
unsigned short	getCameraMask () const
	get & set camera mask, the node is visible by the camera whose camera flag & node's camera mask is true More...
virtual	~Node ()
virtual bool	init ()
var	init ()
local	init ()
virtual void	setLocalZOrder (int localZOrder)
	LocalZOrder is the 'key' used to sort the node relative to its siblings. More...
virtual void	setZOrder (int localZOrder)
virtual void	_setLocalZOrder (int z)
var	_setLocalZOrder ( var z)
local	_setLocalZOrder ( local z)
virtual int	getLocalZOrder () const
	Gets the local Z order of this node. More...
var	getLocalZOrder ()
	Gets the local Z order of this node. More...
local	getLocalZOrder ()
	Gets the local Z order of this node. More...
virtual int	getZOrder () const
virtual void	setGlobalZOrder (float globalZOrder)
	Defines the oder in which the nodes are renderer. More...
local	setGlobalZOrder ( local globalZOrder)
	Defines the oder in which the nodes are renderer. More...
virtual float	getGlobalZOrder () const
	Returns the Node's Global Z Order. More...
var	getGlobalZOrder ()
	Returns the Node's Global Z Order. More...
local	getGlobalZOrder ()
	Returns the Node's Global Z Order. More...
virtual void	setScaleZ (float scaleZ)
	Changes the scale factor on Z axis of this node. More...
var	setScaleZ ( var scaleZ)
	Changes the scale factor on Z axis of this node. More...
local	setScaleZ ( local scaleZ)
	Changes the scale factor on Z axis of this node. More...
virtual float	getScaleZ () const
	Returns the scale factor on Z axis of this node. More...
virtual void	setNormalizedPosition (const Vec2 &position)
	Sets the position (x,y) using values between 0 and 1. More...
var	setNormalizedPosition ( var position)
	Sets the position (x,y) using values between 0 and 1. More...
local	setNormalizedPosition ( local position)
	Sets the position (x,y) using values between 0 and 1. More...
virtual const Vec2 &	getPosition () const
	Gets the position (x,y) of the node in its parent's coordinate system. More...
virtual const Vec2 &	getNormalizedPosition () const
	Returns the normalized position. More...
local	getNormalizedPosition ()
	Returns the normalized position. More...
virtual void	setPosition (float x, float y)
	Sets the position (x,y) of the node in its parent's coordinate system. More...
local	setPosition ( local x, local y)
	Sets the position (x,y) of the node in its parent's coordinate system. More...
virtual void	getPosition (float *x, float *y) const
	Gets position in a more efficient way, returns two number instead of a Vec2 object. More...
virtual void	setPositionX (float x)
	Gets/Sets x or y coordinate individually for position. More...
virtual float	getPositionX (void) const
	Gets the x coordinate of the node in its parent's coordinate system. More...
virtual void	setPositionY (float y)
	Sets the y coordinate of the node in its parent's coordinate system. More...
virtual float	getPositionY (void) const
	Gets the y coordinate of the node in its parent's coordinate system. More...
virtual void	setPosition3D (const Vec3 &position)
	Sets the position (X, Y, and Z) in its parent's coordinate system. More...
virtual Vec3	getPosition3D () const
	Returns the position (X,Y,Z) in its parent's coordinate system. More...
virtual void	setPositionZ (float positionZ)
	Sets the 'z' coordinate in the position. More...
var	setVertexZ ( var positionZ)
	Sets the 'z' coordinate in the position. More...
local	setPositionZ ( local positionZ)
	Sets the 'z' coordinate in the position. More...
virtual void	setVertexZ (float vertexZ)
var	setVertexZ ( var vertexZ)
local	setVertexZ ( local vertexZ)
virtual float	getPositionZ () const
	Gets position Z coordinate of this node. More...
var	getVertexZ ()
	Gets position Z coordinate of this node. More...
local	getPositionZ ()
	Gets position Z coordinate of this node. More...
virtual float	getVertexZ () const
virtual void	setSkewX (float skewX)
	Changes the X skew angle of the node in degrees. More...
local	setSkewX ( local skewX)
	Changes the X skew angle of the node in degrees. More...
virtual float	getSkewX () const
	Returns the X skew angle of the node in degrees. More...
var	getSkewX ()
	Returns the X skew angle of the node in degrees. More...
local	getSkewX ()
	Returns the X skew angle of the node in degrees. More...
virtual void	setSkewY (float skewY)
	Changes the Y skew angle of the node in degrees. More...
var	setSkewY ( var skewY)
	Changes the Y skew angle of the node in degrees. More...
local	setSkewY ( local skewY)
	Changes the Y skew angle of the node in degrees. More...
virtual float	getSkewY () const
	Returns the Y skew angle of the node in degrees. More...
var	getSkewY ()
	Returns the Y skew angle of the node in degrees. More...
local	getSkewY ()
	Returns the Y skew angle of the node in degrees. More...
virtual void	setAnchorPoint (const Vec2 &anchorPoint)
	Sets the anchor point in percent. More...
local	setAnchorPoint ( local anchorPoint)
	Sets the anchor point in percent. More...
virtual const Vec2 &	getAnchorPoint () const
	Returns the anchor point in percent. More...
local	getAnchorPoint ()
	Returns the anchor point in percent. More...
virtual const Vec2 &	getAnchorPointInPoints () const
	Returns the anchorPoint in absolute pixels. More...
virtual const Size &	getContentSize () const
	Returns the untransformed size of the node. More...
virtual void	setVisible (bool visible)
	Sets whether the node is visible. More...
var	setVisible ( var visible)
	Sets whether the node is visible. More...
local	setVisible ( local visible)
	Sets whether the node is visible. More...
virtual bool	isVisible () const
	Determines if the node is visible. More...
virtual void	setRotation (float rotation)
	Sets the rotation (angle) of the node in degrees. More...
local	setRotation ( local rotation)
	Sets the rotation (angle) of the node in degrees. More...
virtual float	getRotation () const
	Returns the rotation of the node in degrees. More...
virtual void	setRotation3D (const Vec3 &rotation)
	Sets the rotation (X,Y,Z) in degrees. More...
local	setRotation3D ( local rotation)
	Sets the rotation (X,Y,Z) in degrees. More...
virtual Vec3	getRotation3D () const
	Returns the rotation (X,Y,Z) in degrees. More...
virtual void	setRotationQuat (const Quaternion &quat)
	Set rotation by quaternion. More...
local	setRotationQuat ( local quat)
	Set rotation by quaternion. More...
virtual Quaternion	getRotationQuat () const
	Return the rotation by quaternion, Note that when _rotationZ_X == _rotationZ_Y, the returned quaternion equals to RotationZ_X * RotationY * RotationX, it equals to RotationY * RotationX otherwise. More...
virtual void	setRotationSkewX (float rotationX)
	Sets the X rotation (angle) of the node in degrees which performs a horizontal rotational skew. More...
local	setRotationSkewX ( local rotationX)
	Sets the X rotation (angle) of the node in degrees which performs a horizontal rotational skew. More...
virtual void	setRotationX (float rotationX)
var	setRotationX ( var rotationX)
local	setRotationX ( local rotationX)
virtual float	getRotationSkewX () const
	Gets the X rotation (angle) of the node in degrees which performs a horizontal rotation skew. More...
var	getRotationX ()
	Gets the X rotation (angle) of the node in degrees which performs a horizontal rotation skew. More...
local	getRotationSkewX ()
	Gets the X rotation (angle) of the node in degrees which performs a horizontal rotation skew. More...
virtual float	getRotationX () const
var	getRotationX ()
local	getRotationX ()
virtual void	setRotationSkewY (float rotationY)
	Sets the Y rotation (angle) of the node in degrees which performs a vertical rotational skew. More...
local	setRotationSkewY ( local rotationY)
	Sets the Y rotation (angle) of the node in degrees which performs a vertical rotational skew. More...
virtual void	setRotationY (float rotationY)
local	setRotationY ( local rotationY)
virtual float	getRotationSkewY () const
	Gets the Y rotation (angle) of the node in degrees which performs a vertical rotational skew. More...
local	getRotationSkewY ()
	Gets the Y rotation (angle) of the node in degrees which performs a vertical rotational skew. More...
virtual float	getRotationY () const
void	setOrderOfArrival (int orderOfArrival)
	Sets the arrival order when this node has a same ZOrder with other children. More...
int	getOrderOfArrival () const
	Returns the arrival order, indicates which children is added previously. More...
void	setGLServerState (int serverState)
var	setGLServerState ( var serverState)
int	getGLServerState () const
virtual void	ignoreAnchorPointForPosition (bool ignore)
	Sets whether the anchor point will be (0,0) when you position this node. More...
virtual bool	isIgnoreAnchorPointForPosition () const
	Gets whether the anchor point will be (0,0) when you position this node. More...
virtual void	addChild (Node *child)
	Adds a child to the container with z-order as 0. More...
var	addChild ( var child)
	Adds a child to the container with z-order as 0. More...
local	addChild ( local child)
	Adds a child to the container with z-order as 0. More...
virtual void	addChild (Node *child, int localZOrder)
	Adds a child to the container with a local z-order. More...
local	addChild ( local child, local localZOrder)
	Adds a child to the container with a local z-order. More...
virtual void	addChild (Node *child, int localZOrder, int tag)
	Adds a child to the container with z order and tag. More...
local	addChild ( local child, local localZOrder, local tag)
	Adds a child to the container with z order and tag. More...
virtual void	addChild (Node *child, int localZOrder, const std::string &name)
	Adds a child to the container with z order and tag. More...
local	addChild ( local child, local localZOrder, local name)
	Adds a child to the container with z order and tag. More...
virtual Node *	getChildByTag (int tag) const
	Gets a child from the container with its tag. More...
var	getChildByTag ( var tag)
	Gets a child from the container with its tag. More...
local	getChildByTag ( local tag)
	Gets a child from the container with its tag. More...
virtual Node *	getChildByName (const std::string &name) const
	Gets a child from the container with its name. More...
local	getChildByName ( local name)
	Gets a child from the container with its name. More...
template<typename T >
T	getChildByName (const std::string &name) const
	Gets a child from the container with its name that can be cast to Type T. More...
virtual void	enumerateChildren (const std::string &name, std::function< bool(Node *node)> callback) const
	Search the children of the receiving node to perform processing for nodes which share a name. More...
virtual Vector< Node * > &	getChildren ()
	Returns the array of the node's children. More...
local	getChildren ()
	Returns the array of the node's children. More...
virtual const Vector< Node * > &	getChildren () const
local	getChildren ()
virtual ssize_t	getChildrenCount () const
	Returns the amount of children. More...
var	getChildrenCount ()
	Returns the amount of children. More...
local	getChildrenCount ()
	Returns the amount of children. More...
virtual void	setParent (Node *parent)
	Sets the parent node. More...
local	setParent ( local parent)
	Sets the parent node. More...
virtual Node *	getParent ()
	Returns a pointer to the parent node. More...
virtual const Node *	getParent () const
virtual void	removeFromParent ()
	Removes this node itself from its parent node with a cleanup. More...
virtual void	removeFromParentAndCleanup (bool cleanup)
	Removes this node itself from its parent node. More...
local	removeFromParent ( local cleanup)
	Removes this node itself from its parent node. More...
virtual void	removeChild (Node *child, bool cleanup=true)
	Removes a child from the container. More...
virtual void	removeChildByTag (int tag, bool cleanup=true)
	Removes a child from the container by tag value. More...
local	removeChildByTag ( local tag, local true)
	Removes a child from the container by tag value. More...
virtual void	removeChildByName (const std::string &name, bool cleanup=true)
	Removes a child from the container by tag value. More...
var	removeChildByName ( var name, var true)
	Removes a child from the container by tag value. More...
local	removeChildByName ( local name, local true)
	Removes a child from the container by tag value. More...
virtual void	removeAllChildren ()
	Removes all children from the container with a cleanup. More...
var	removeAllChildren ()
	Removes all children from the container with a cleanup. More...
local	removeAllChildren ()
	Removes all children from the container with a cleanup. More...
virtual void	removeAllChildrenWithCleanup (bool cleanup)
	Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter. More...
var	removeAllChildren ( var cleanup)
	Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter. More...
local	removeAllChildren ( local cleanup)
	Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter. More...
virtual void	reorderChild (Node *child, int localZOrder)
	Reorders a child according to a new z value. More...
local	reorderChild ( local child, local localZOrder)
	Reorders a child according to a new z value. More...
virtual void	sortAllChildren ()
	Sorts the children array once before drawing, instead of every time when a child is added or reordered. More...
virtual int	getTag () const
	Returns a tag that is used to identify the node easily. More...
virtual void	setTag (int tag)
	Changes the tag that is used to identify the node easily. More...
local	setTag ( local tag)
	Changes the tag that is used to identify the node easily. More...
virtual std::string	getName () const
	Returns a string that is used to identify the node. More...
virtual void	setName (const std::string &name)
	Changes the name that is used to identify the node easily. More...
var	setName ( var name)
	Changes the name that is used to identify the node easily. More...
local	setName ( local name)
	Changes the name that is used to identify the node easily. More...
virtual void *	getUserData ()
	Returns a custom user data pointer. More...
virtual const void *	getUserData () const
virtual void	setUserData (void *userData)
	Sets a custom user data pointer. More...
virtual Ref *	getUserObject ()
	Returns a user assigned Object. More...
virtual const Ref *	getUserObject () const
virtual void	setUserObject (Ref *userObject)
	Returns a user assigned Object. More...
local	setUserObject ( local userObject)
	Returns a user assigned Object. More...
GLProgram *	getGLProgram () const
	Return the GLProgram (shader) currently used for this node. More...
var	getGLProgram ()
	Return the GLProgram (shader) currently used for this node. More...
local	getGLProgram ()
	Return the GLProgram (shader) currently used for this node. More...
GLProgram *	getShaderProgram () const
var	getShaderProgram ()
local	getShaderProgram ()
virtual void	setGLProgram (GLProgram *glprogram)
	Sets the shader program for this node. More...
var	setGLProgram ( var glprogram)
	Sets the shader program for this node. More...
local	setGLProgram ( local glprogram)
	Sets the shader program for this node. More...
void	setShaderProgram (GLProgram *glprogram)
var	setShaderProgram ( var glprogram)
local	setShaderProgram ( local glprogram)
GLProgramState *	getGLProgramState () const
	Return the GLProgramState currently used for this node. More...
var	getGLProgramState ()
	Return the GLProgramState currently used for this node. More...
local	getGLProgramState ()
	Return the GLProgramState currently used for this node. More...
virtual void	setGLProgramState (GLProgramState *glProgramState)
	Set the GLProgramState for this node. More...
local	setGLProgramState ( local glProgramState)
	Set the GLProgramState for this node. More...
virtual void	setActionManager (ActionManager *actionManager)
	Sets the ActionManager object that is used by all actions. More...
var	setActionManager ( var actionManager)
	Sets the ActionManager object that is used by all actions. More...
local	setActionManager ( local actionManager)
	Sets the ActionManager object that is used by all actions. More...
virtual ActionManager *	getActionManager ()
	Gets the ActionManager object that is used by all actions. More...
local	getActionManager ()
	Gets the ActionManager object that is used by all actions. More...
virtual const ActionManager *	getActionManager () const
virtual Action *	runAction (Action *action)
	Executes an action, and returns the action that is executed. More...
var	runAction ( var action)
	Executes an action, and returns the action that is executed. More...
local	runAction ( local action)
	Executes an action, and returns the action that is executed. More...
void	stopAllActions ()
	Stops and removes all actions from the running action list . More...
void	stopAction (Action *action)
	Stops and removes an action from the running action list. More...
var	stopAction ( var action)
	Stops and removes an action from the running action list. More...
local	stopAction ( local action)
	Stops and removes an action from the running action list. More...
void	stopActionByTag (int tag)
	Removes an action from the running action list by its tag. More...
var	stopActionByTag ( var tag)
	Removes an action from the running action list by its tag. More...
local	stopActionByTag ( local tag)
	Removes an action from the running action list by its tag. More...
void	stopAllActionsByTag (int tag)
	Removes all actions from the running action list by its tag. More...
var	stopAllActionsByTag ( var tag)
	Removes all actions from the running action list by its tag. More...
local	stopAllActionsByTag ( local tag)
	Removes all actions from the running action list by its tag. More...
Action *	getActionByTag (int tag)
	Gets an action from the running action list by its tag. More...
ssize_t	getNumberOfRunningActions () const
	Returns the numbers of actions that are running plus the ones that are schedule to run (actions in actionsToAdd and actions arrays). More...
local	getNumberOfRunningActions ()
	Returns the numbers of actions that are running plus the ones that are schedule to run (actions in actionsToAdd and actions arrays). More...
ssize_t	numberOfRunningActions () const
var	numberOfRunningActions ()
local	numberOfRunningActions ()
virtual void	setScheduler (Scheduler *scheduler)
	Sets a Scheduler object that is used to schedule all "updates" and timers. More...
virtual Scheduler *	getScheduler ()
	Gets a Sheduler object. More...
local	getScheduler ()
	Gets a Sheduler object. More...
virtual const Scheduler *	getScheduler () const
bool	isScheduled (SEL_SCHEDULE selector)
	Checks whether a selector is scheduled. More...
bool	isScheduled (const std::string &key)
	Checks whether a lambda function is scheduled. More...
void	scheduleUpdate (void)
	Schedules the "update" method. More...
void	scheduleUpdateWithPriority (int priority)
	Schedules the "update" method with a custom priority. More...
var	scheduleUpdateWithPriority ( var priority)
	Schedules the "update" method with a custom priority. More...
void	unscheduleUpdate (void)
var	unscheduleUpdate ()
local	unscheduleUpdate ()
void	schedule (SEL_SCHEDULE selector, float interval, unsigned int repeat, float delay)
	Schedules a custom selector. More...
void	schedule (SEL_SCHEDULE selector, float interval)
	Schedules a custom selector with an interval time in seconds. More...
void	scheduleOnce (SEL_SCHEDULE selector, float delay)
	Schedules a selector that runs only once, with a delay of 0 or larger. More...
var	scheduleOnce ( var selector, var delay)
	Schedules a selector that runs only once, with a delay of 0 or larger. More...
void	scheduleOnce (const std::function< void(float)> &callback, float delay, const std::string &key)
	Schedules a lambda function that runs only once, with a delay of 0 or larger. More...
void	schedule (SEL_SCHEDULE selector)
	Schedules a custom selector, the scheduled selector will be ticked every frame. More...
void	schedule (const std::function< void(float)> &callback, const std::string &key)
	Schedules a lambda function. More...
void	schedule (const std::function< void(float)> &callback, float interval, const std::string &key)
	Schedules a lambda function. More...
void	schedule (const std::function< void(float)> &callback, float interval, unsigned int repeat, float delay, const std::string &key)
	Schedules a lambda function. More...
var	schedule ( var callback, var interval, var repeat, var delay, var key)
	Schedules a lambda function. More...
void	unschedule (SEL_SCHEDULE selector)
	Unschedules a custom selector. More...
var	unschedule ( var selector)
	Unschedules a custom selector. More...
void	unschedule (const std::string &key)
	Unschedules a lambda function. More...
void	unscheduleAllCallbacks ()
	Unschedule all scheduled selectors and lambda functions: custom selectors, and the 'update' selector and lambda functions. More...
void	unscheduleAllSelectors ()
var	unscheduleAllSelectors ()
local	unscheduleAllSelectors ()
virtual void	resume (void)
	Resumes all scheduled selectors, actions and event listeners. More...
local	resume ()
	Resumes all scheduled selectors, actions and event listeners. More...
virtual void	pause (void)
	Pauses all scheduled selectors, actions and event listeners. More...
local	pause ()
	Pauses all scheduled selectors, actions and event listeners. More...
void	resumeSchedulerAndActions ()
	Resumes all scheduled selectors, actions and event listeners. More...
void	pauseSchedulerAndActions ()
	Pauses all scheduled selectors, actions and event listeners. More...
var	pauseSchedulerAndActions ()
	Pauses all scheduled selectors, actions and event listeners. More...
local	pauseSchedulerAndActions ()
	Pauses all scheduled selectors, actions and event listeners. More...
virtual void	update (float delta)
	Update method will be called automatically every frame if "scheduleUpdate" is called, and the node is "live". More...
virtual void	updateTransform ()
	Calls children's updateTransform() method recursively. More...
virtual const Mat4 &	getNodeToParentTransform () const
	Returns the matrix that transform the node's (local) space coordinates into the parent's space coordinates. More...
virtual AffineTransform	getNodeToParentAffineTransform () const
local	getNodeToParentAffineTransform ()
virtual void	setNodeToParentTransform (const Mat4 &transform)
	Sets the transformation matrix manually. More...
virtual AffineTransform	nodeToParentTransform () const
virtual const Mat4 &	getParentToNodeTransform () const
	Returns the matrix that transform parent's space coordinates to the node's (local) space coordinates. More...
var	getParentToNodeTransform ()
	Returns the matrix that transform parent's space coordinates to the node's (local) space coordinates. More...
local	getParentToNodeTransform ()
	Returns the matrix that transform parent's space coordinates to the node's (local) space coordinates. More...
virtual AffineTransform	getParentToNodeAffineTransform () const
local	getParentToNodeAffineTransform ()
virtual AffineTransform	parentToNodeTransform () const
local	parentToNodeTransform ()
virtual Mat4	getNodeToWorldTransform () const
	Returns the world affine transform matrix. More...
virtual AffineTransform	getNodeToWorldAffineTransform () const
local	getNodeToWorldAffineTransform ()
virtual AffineTransform	nodeToWorldTransform () const
local	nodeToWorldTransform ()
virtual Mat4	getWorldToNodeTransform () const
	Returns the inverse world affine transform matrix. More...
var	getWorldToNodeTransform ()
	Returns the inverse world affine transform matrix. More...
local	getWorldToNodeTransform ()
	Returns the inverse world affine transform matrix. More...
virtual AffineTransform	getWorldToNodeAffineTransform () const
local	getWorldToNodeAffineTransform ()
virtual AffineTransform	worldToNodeTransform () const
local	worldToNodeTransform ()
Vec2	convertToNodeSpace (const Vec2 &worldPoint) const
	Converts a Vec2 to node (local) space coordinates. More...
var	convertToNodeSpace ( var worldPoint)
	Converts a Vec2 to node (local) space coordinates. More...
local	convertToNodeSpace ( local worldPoint)
	Converts a Vec2 to node (local) space coordinates. More...
Vec2	convertToWorldSpace (const Vec2 &nodePoint) const
	Converts a Vec2 to world space coordinates. More...
Vec2	convertToNodeSpaceAR (const Vec2 &worldPoint) const
	Converts a Vec2 to node (local) space coordinates. More...
Vec2	convertToWorldSpaceAR (const Vec2 &nodePoint) const
	Converts a local Vec2 to world space coordinates.The result is in Points. More...
Vec2	convertTouchToNodeSpace (Touch *touch) const
	convenience methods which take a Touch instead of Vec2. More...
Vec2	convertTouchToNodeSpaceAR (Touch *touch) const
	converts a Touch (world coordinates) into a local coordinate. More...
void	setAdditionalTransform (Mat4 *additionalTransform)
	Sets an additional transform matrix to the node. More...
void	setAdditionalTransform (const AffineTransform &additionalTransform)
var	setAdditionalTransform ( var additionalTransform)
local	setAdditionalTransform ( local additionalTransform)
Component *	getComponent (const std::string &name)
	Gets a component by its name. More...
var	getComponent ( var name)
	Gets a component by its name. More...
local	getComponent ( local name)
	Gets a component by its name. More...
virtual bool	addComponent (Component *component)
	Adds a component. More...
virtual bool	removeComponent (const std::string &name)
	Removes a component by its name. More...
virtual bool	removeComponent (Component *component)
	Removes a component by its pointer. More...
virtual void	removeAllComponents ()
	Removes all components. More...
var	removeAllComponents ()
	Removes all components. More...
local	removeAllComponents ()
	Removes all components. More...
Public Member Functions inherited from Ref
void	retain ()
	Retains the ownership. More...
void	release ()
	Releases the ownership immediately. More...
Ref *	autorelease ()
	Releases the ownership sometime soon automatically. More...
unsigned int	getReferenceCount () const
	Returns the Ref's current reference count. More...
virtual	~Ref ()
	Destructor. More...
Public Member Functions inherited from LayoutParameterProtocol
virtual	~LayoutParameterProtocol ()
	Default destructor. More...

Static Public Member Functions
static Widget *	create ()
	Create and return a empty Widget instance pointer. More...
static void	enableDpadNavigation (bool enable)
Static Public Member Functions inherited from ProtectedNode
static ProtectedNode *	create (void)
	Creates a ProtectedNode with no argument. More...
Static Public Member Functions inherited from Node
static Node *	create ()
	Allocates and initializes a node. More...
var	create ()
	Allocates and initializes a node. More...
local	create ()
	Allocates and initializes a node. More...

Public Attributes
std::function< void(Widget *, Widget *)>	onFocusChanged
	When a widget lose/get focus, this method will be called. More...
std::function< Widget *(FocusDirection)>	onNextFocusedWidget
	use this function to manually specify the next focused widget regards to each direction More...
CC_CONSTRUCTOR_ACCESS	__pad0__: virtual bool init() override
Public Attributes inherited from ProtectedNode
CC_CONSTRUCTOR_ACCESS	__pad0__: ProtectedNode()
Public Attributes inherited from Node
CC_CONSTRUCTOR_ACCESS	__pad0__: Node()

Protected Member Functions
GLProgramState *	getNormalGLProgramState () const
	Get a normal state GLProgramState. More...
GLProgramState *	getGrayGLProgramState () const
	Get a disabled state GLProgramState. More...
virtual void	onSizeChanged ()
virtual void	initRenderer ()
virtual void	onPressStateChangedToNormal ()
virtual void	onPressStateChangedToPressed ()
virtual void	onPressStateChangedToDisabled ()
void	pushDownEvent ()
void	moveEvent ()
virtual void	releaseUpEvent ()
virtual void	cancelUpEvent ()
virtual void	adaptRenderers ()
void	updateChildrenDisplayedRGBA ()
void	copyProperties (Widget *model)
virtual Widget *	createCloneInstance ()
virtual void	copySpecialProperties (Widget *model)
virtual void	copyClonedWidgetChildren (Widget *model)
Widget *	getWidgetParent ()
void	updateContentSizeWithTextureSize (const Size &size)
bool	isAncestorsEnabled ()
Widget *	getAncensterWidget (Node *node)
bool	isAncestorsVisible (Node *node)
void	cleanupWidget ()
LayoutComponent *	getOrCreateLayoutComponent ()
Protected Member Functions inherited from ProtectedNode
void	insertProtectedChild (Node *child, int z)
	helper that reorder a child More...
Protected Member Functions inherited from Node
void	childrenAlloc (void)
	lazy allocs More...
var	childrenAlloc ()
	lazy allocs More...
local	childrenAlloc ()
	lazy allocs More...
void	insertChild (Node *child, int z)
	helper that reorder a child More...
var	insertChild ( var child, var z)
	helper that reorder a child More...
local	insertChild ( local child, local z)
	helper that reorder a child More...
void	detachChild (Node *child, ssize_t index, bool doCleanup)
	Removes a child, call child->onExit(), do cleanup, remove it from children array. More...
local	detachChild ( local child, local index, local doCleanup)
	Removes a child, call child->onExit(), do cleanup, remove it from children array. More...
Vec2	convertToWindowSpace (const Vec2 &nodePoint) const
	Convert cocos2d coordinates to UI windows coordinate. More...
var	convertToWindowSpace ( var nodePoint)
	Convert cocos2d coordinates to UI windows coordinate. More...
local	convertToWindowSpace ( local nodePoint)
	Convert cocos2d coordinates to UI windows coordinate. More...
Mat4	transform (const Mat4 &parentTransform)
var	transform ( var parentTransform)
local	transform ( local parentTransform)
uint32_t	processParentFlags (const Mat4 &parentTransform, uint32_t parentFlags)
var	processParentFlags ( var parentTransform, var parentFlags)
local	processParentFlags ( local parentTransform, local parentFlags)
virtual void	updateCascadeOpacity ()
var	updateCascadeOpacity ()
local	updateCascadeOpacity ()
virtual void	updateCascadeColor ()
var	updateCascadeColor ()
local	updateCascadeColor ()
virtual void	updateColor ()
var	updateColor ()
local	updateColor ()
bool	doEnumerate (std::string name, std::function< bool(Node *)> callback) const
var	doEnumerate ( var name, var callback)
local	doEnumerate ( local name, local callback)
bool	doEnumerateRecursive (const Node *node, const std::string &name, std::function< bool(Node *)> callback) const
var	doEnumerateRecursive ( var node, var name, var callback)
local	doEnumerateRecursive ( local node, local name, local callback)
bool	isVisitableByVisitingCamera () const
void	updateRotationQuat ()
var	updateRotationQuat ()
local	updateRotationQuat ()
void	updateRotation3D ()
var	updateRotation3D ()
local	updateRotation3D ()
Protected Member Functions inherited from Ref
	Ref ()
	Constructor. More...
	Ref ()
	Constructor. More...

Protected Attributes
bool	_usingLayoutComponent
bool	_unifySize
bool	_enabled
bool	_bright
bool	_touchEnabled
bool	_highlight
bool	_affectByClipping
bool	_ignoreSize
bool	_propagateTouchEvents
BrightStyle	_brightStyle
SizeType	_sizeType
PositionType	_positionType
int	_actionTag
Size	_customSize
Vec2	_sizePercent
Vec2	_positionPercent
bool	_hitted
EventListenerTouchOneByOne *	_touchListener
Vec2	_touchBeganPosition
Vec2	_touchMovePosition
Vec2	_touchEndPosition
bool	_flippedX
bool	_flippedY
Map< int, LayoutParameter * >	_layoutParameterDictionary
LayoutParameter::Type	_layoutParameterType
bool	_focused
bool	_focusEnabled
Ref *	_touchEventListener
SEL_TouchEvent	_touchEventSelector
ccWidgetTouchCallback	_touchEventCallback
ccWidgetClickCallback	_clickEventListener
ccWidgetEventCallback	_ccEventCallback
std::string	_callbackType
std::string	_callbackName
Protected Attributes inherited from ProtectedNode
Vector< Node * >	_protectedChildren
	array of children nodes More...
bool	_reorderProtectedChildDirty
var	_reorderProtectedChildDirty
local	_reorderProtectedChildDirty
Protected Attributes inherited from Node
float	_rotationX
	rotation on the X-axis More...
float	_rotationY
	rotation on the Y-axis More...
var	_rotationY
	rotation on the Y-axis More...
local	_rotationY
	rotation on the Y-axis More...
float	_rotationZ_X
	rotation angle on Z-axis, component X More...
var	_rotationZ_X
	rotation angle on Z-axis, component X More...
local	_rotationZ_X
	rotation angle on Z-axis, component X More...
float	_rotationZ_Y
	rotation angle on Z-axis, component Y More...
var	_rotationZ_Y
	rotation angle on Z-axis, component Y More...
local	_rotationZ_Y
	rotation angle on Z-axis, component Y More...
Quaternion	_rotationQuat
var	_rotationQuat
local	_rotationQuat
float	_scaleX
	rotation using quaternion, if _rotationZ_X == _rotationZ_Y, _rotationQuat = RotationZ_X * RotationY * RotationX, else _rotationQuat = RotationY * RotationX More...
var	_scaleX
	rotation using quaternion, if _rotationZ_X == _rotationZ_Y, _rotationQuat = RotationZ_X * RotationY * RotationX, else _rotationQuat = RotationY * RotationX More...
local	_scaleX
	rotation using quaternion, if _rotationZ_X == _rotationZ_Y, _rotationQuat = RotationZ_X * RotationY * RotationX, else _rotationQuat = RotationY * RotationX More...
float	_scaleY
	scaling factor on y-axis More...
float	_scaleZ
	scaling factor on z-axis More...
var	_scaleZ
	scaling factor on z-axis More...
local	_scaleZ
	scaling factor on z-axis More...
Vec2	_position
	position of the node More...
var	_position
	position of the node More...
local	_position
	position of the node More...
float	_positionZ
	OpenGL real Z position. More...
var	_positionZ
	OpenGL real Z position. More...
local	_positionZ
	OpenGL real Z position. More...
Vec2	_normalizedPosition
var	_normalizedPosition
local	_normalizedPosition
bool	_usingNormalizedPosition
var	_usingNormalizedPosition
local	_usingNormalizedPosition
bool	_normalizedPositionDirty
var	_normalizedPositionDirty
local	_normalizedPositionDirty
float	_skewX
	skew angle on x-axis More...
var	_skewX
	skew angle on x-axis More...
local	_skewX
	skew angle on x-axis More...
float	_skewY
	skew angle on y-axis More...
var	_skewY
	skew angle on y-axis More...
local	_skewY
	skew angle on y-axis More...
Vec2	_anchorPointInPoints
	anchor point in points More...
var	_anchorPointInPoints
	anchor point in points More...
local	_anchorPointInPoints
	anchor point in points More...
Vec2	_anchorPoint
	anchor point normalized (NOT in points) More...
var	_anchorPoint
	anchor point normalized (NOT in points) More...
local	_anchorPoint
	anchor point normalized (NOT in points) More...
Size	_contentSize
	untransformed size of the node More...
bool	_contentSizeDirty
	whether or not the contentSize is dirty More...
var	_contentSizeDirty
	whether or not the contentSize is dirty More...
local	_contentSizeDirty
	whether or not the contentSize is dirty More...
Mat4	_modelViewTransform
	ModelView transform of the Node. More...
var	_modelViewTransform
	ModelView transform of the Node. More...
local	_modelViewTransform
	ModelView transform of the Node. More...
Mat4	_transform
	transform More...
var	_transform
	transform More...
local	_transform
	transform More...
bool	_transformDirty
	transform dirty flag More...
var	_transformDirty
	transform dirty flag More...
local	_transformDirty
	transform dirty flag More...
Mat4	_inverse
	inverse transform More...
bool	_inverseDirty
	inverse transform dirty flag More...
var	_inverseDirty
	inverse transform dirty flag More...
local	_inverseDirty
	inverse transform dirty flag More...
Mat4	_additionalTransform
	transform More...
var	_additionalTransform
	transform More...
local	_additionalTransform
	transform More...
bool	_useAdditionalTransform
	The flag to check whether the additional transform is dirty. More...
var	_useAdditionalTransform
	The flag to check whether the additional transform is dirty. More...
local	_useAdditionalTransform
	The flag to check whether the additional transform is dirty. More...
bool	_transformUpdated
	Whether or not the Transform object was updated since the last frame. More...
int	_localZOrder
	Local order (relative to its siblings) used to sort the node. More...
var	_localZOrder
	Local order (relative to its siblings) used to sort the node. More...
local	_localZOrder
	Local order (relative to its siblings) used to sort the node. More...
float	_globalZOrder
	Global order used to sort the node. More...
var	_globalZOrder
	Global order used to sort the node. More...
local	_globalZOrder
	Global order used to sort the node. More...
Vector< Node * >	_children
	array of children nodes More...
var	_children
	array of children nodes More...
local	_children
	array of children nodes More...
Node *	_parent
	weak reference to parent node More...
var	_parent
	weak reference to parent node More...
local	_parent
	weak reference to parent node More...
Director *	_director
var	_director
local	_director
int	_tag
	a tag. Can be any number you assigned just to identify this node More...
var	_tag
	a tag. Can be any number you assigned just to identify this node More...
local	_tag
	a tag. Can be any number you assigned just to identify this node More...
std::string	_name
	a string label, an user defined string to identify this node More...
var	_name
	a string label, an user defined string to identify this node More...
local	_name
	a string label, an user defined string to identify this node More...
size_t	_hashOfName
	hash value of _name, used for speed in getChildByName More...
var	_hashOfName
	hash value of _name, used for speed in getChildByName More...
local	_hashOfName
	hash value of _name, used for speed in getChildByName More...
void *	_userData
	A user assingned void pointer, Can be point to any cpp object. More...
var	_userData
	A user assingned void pointer, Can be point to any cpp object. More...
local	_userData
	A user assingned void pointer, Can be point to any cpp object. More...
Ref *	_userObject
	A user assigned Object. More...
var	_userObject
	A user assigned Object. More...
local	_userObject
	A user assigned Object. More...
GLProgramState *	_glProgramState
	OpenGL Program State. More...
var	_glProgramState
	OpenGL Program State. More...
local	_glProgramState
	OpenGL Program State. More...
int	_orderOfArrival
	used to preserve sequence while sorting children with the same localZOrder More...
var	_orderOfArrival
	used to preserve sequence while sorting children with the same localZOrder More...
local	_orderOfArrival
	used to preserve sequence while sorting children with the same localZOrder More...
Scheduler *	_scheduler
	scheduler used to schedule timers and updates More...
ActionManager *	_actionManager
	a pointer to ActionManager singleton, which is used to handle all the actions More...
EventDispatcher *	_eventDispatcher
	event dispatcher used to dispatch all kinds of events More...
var	_eventDispatcher
	event dispatcher used to dispatch all kinds of events More...
local	_eventDispatcher
	event dispatcher used to dispatch all kinds of events More...
bool	_running
	is running More...
var	_running
	is running More...
local	_running
	is running More...
bool	_visible
	is this node visible More...
var	_visible
	is this node visible More...
local	_visible
	is this node visible More...
bool	_ignoreAnchorPointForPosition
	true if the Anchor Vec2 will be (0,0) when you position the Node, false otherwise. More...
var	_ignoreAnchorPointForPosition
	true if the Anchor Vec2 will be (0,0) when you position the Node, false otherwise. More...
local	_ignoreAnchorPointForPosition
	true if the Anchor Vec2 will be (0,0) when you position the Node, false otherwise. More...
bool	_reorderChildDirty
	children order dirty flag More...
bool	_isTransitionFinished
	flag to indicate whether the transition was finished More...
var	_isTransitionFinished
	flag to indicate whether the transition was finished More...
local	_isTransitionFinished
	flag to indicate whether the transition was finished More...
ComponentContainer *	_componentContainer
	Dictionary of components. More...
var	_componentContainer
	Dictionary of components. More...
local	_componentContainer
	Dictionary of components. More...
PhysicsBody *	_physicsBody
	the physicsBody the node have More...
var	_physicsBody
	the physicsBody the node have More...
local	_physicsBody
	the physicsBody the node have More...
float	_physicsScaleStartX
	the scale x value when setPhysicsBody More...
var	_physicsScaleStartX
	the scale x value when setPhysicsBody More...
local	_physicsScaleStartX
	the scale x value when setPhysicsBody More...
float	_physicsScaleStartY
	the scale y value when setPhysicsBody More...
var	_physicsScaleStartY
	the scale y value when setPhysicsBody More...
local	_physicsScaleStartY
	the scale y value when setPhysicsBody More...
float	_physicsRotation
var	_physicsRotation
local	_physicsRotation
bool	_physicsTransformDirty
var	_physicsTransformDirty
local	_physicsTransformDirty
bool	_updateTransformFromPhysics
var	_updateTransformFromPhysics
local	_updateTransformFromPhysics
GLubyte	_displayedOpacity
var	_displayedOpacity
local	_displayedOpacity
GLubyte	_realOpacity
var	_realOpacity
local	_realOpacity
Color3B	_displayedColor
var	_displayedColor
local	_displayedColor
Color3B	_realColor
var	_realColor
local	_realColor
bool	_cascadeColorEnabled
var	_cascadeColorEnabled
local	_cascadeColorEnabled
bool	_cascadeOpacityEnabled
var	_cascadeOpacityEnabled
local	_cascadeOpacityEnabled
unsigned short	_cameraMask
var	_cameraMask
local	_cameraMask
std::function< void()>	_onEnterCallback
var	_onEnterCallback
local	_onEnterCallback
std::function< void()>	_onExitCallback
var	_onExitCallback
local	_onExitCallback
std::function< void()>	_onEnterTransitionDidFinishCallback
std::function< void()>	_onExitTransitionDidStartCallback
Protected Attributes inherited from Ref
unsigned int	_referenceCount
	count of references More...
local	_referenceCount
	count of references More...

Static Protected Attributes
static Widget *	_focusedWidget
	store the only one focued widget More...
Static Protected Attributes inherited from Node
static int	s_globalOrderOfArrival
var	s_globalOrderOfArrival
local	s_globalOrderOfArrival

Friends
class	PageView

Additional Inherited Members
Static Public Attributes inherited from Node
static const int	INVALID_TAG = -1
	Default tag used for all the nodes. More...
var	INVALID_TAG = -1
	Default tag used for all the nodes. More...
local	INVALID_TAG = -1
	Default tag used for all the nodes. More...

Detailed Description

Base class for all ui widgets.

This class inherent from ProtectedNode and LayoutParameterProtocol. If you want to implements your own ui widget, you should subclass it.

Member Typedef Documentation

typedef std::function<void(Ref*)> ccWidgetClickCallback

Widget click event callback.

typedef std::function<void(Ref*, int)> ccWidgetEventCallback

Widget custom event callback.

It is mainly used together with Cocos Studio.

typedef std::function<void(Ref*,Widget::TouchEventType)> ccWidgetTouchCallback

Widget touch event callback.

Constructor & Destructor Documentation

Widget

(

void

)

Default constructor.

virtual ~Widget ( )

virtual

Default destructor.

Member Function Documentation

virtual void adaptRenderers ( )

inlineprotectedvirtual

Reimplemented in TextField, EditBox, RichText, Text, Button, CheckBox, Slider, LoadingBar, TextAtlas, ImageView, and TextBMFont.

virtual void addCCSEventListener ( const ccWidgetEventCallback &  callback )

virtual

Set a event handler to the widget in order to use cocostudio editor and framework.

Parameters

callback

The callback in ccWidgetEventCallback.

void addClickEventListener

(

const ccWidgetClickCallback &

callback

)

Set a click event handler to the widget.

Parameters

callback

The callback in ccWidgetClickCallback.

void addTouchEventListener	(	Ref *	target,
		SEL_TouchEvent	selector
	)

Sets the touch event target/selector to the widget.

void addTouchEventListener

(

const ccWidgetTouchCallback &

callback

)

Set a callback to touch vent listener.

Parameters

callback

The callback in ccWidgetEventCallback.

virtual void cancelUpEvent ( )

protectedvirtual

void cleanupWidget ( )

protected

bool clippingParentAreaContainPoint ( const Vec2 &  pt )

inline

Checks a point if in parent's area.

Parameters

point

A point in Vec2.

Deprecated:

use isClippingParentContainsPoint instead.

Returns

true if the point is in parent's area, flase otherwise.

Widget* clone

(

)

Create a new widget copy of the original one.

Returns

A cloned widget copy of original.

virtual void copyClonedWidgetChildren ( Widget *  model )

protectedvirtual

Reimplemented in Layout, ScrollView, ListView, and PageView.

void copyProperties ( Widget *  model )

protected

virtual void copySpecialProperties ( Widget *  model )

protectedvirtual

Reimplemented in TextField, Layout, ScrollView, Button, Text, ListView, CheckBox, Slider, PageView, LoadingBar, TextAtlas, ImageView, and TextBMFont.

static Widget* create ( )

static

Create and return a empty Widget instance pointer.

virtual Widget* createCloneInstance ( )

protectedvirtual

Reimplemented in TextField, Layout, ScrollView, Button, Text, ListView, CheckBox, Slider, PageView, WebView, LoadingBar, VideoPlayer, TextAtlas, ImageView, and TextBMFont.

void dispatchFocusEvent	(	Widget *	widgetLoseFocus,
		Widget *	widgetGetFocus
	)

Dispatch a EventFocus through a EventDispatcher.

Parameters

widgetLoseFocus	The widget which lose its focus
widgetGetFocus	he widget whihc get its focus

Returns

void

static void enableDpadNavigation ( bool  enable )

static

virtual Widget* findNextFocusedWidget ( FocusDirection  direction, Widget *  current  )

virtual

When a widget is in a layout, you could call this method to get the next focused widget within a specified direction.

If the widget is not in a layout, it will return itself

Parameters

dir	the direction to look for the next focused widget in a layout
current	the current focused widget

Returns

the next focused widget in a layout

Reimplemented in ScrollView.

int getActionTag

(

)

const

Get the action tag.

Returns

Action tag.

Widget* getAncensterWidget ( Node *  node )

protected

float getBottomBoundary

(

)

const

Gets the bottom boundary position of this widget in parent's coordination system.

Returns

The bottom boundary position of this widget.

float getBottomInParent ( )

inline

Gets the bottom boundary position of this widget in parent's coordination system.

Deprecated:

use getBottomBoundary instead.

Returns

The bottom boundary position of this widget.

const std::string& getCallbackName ( ) const

inline

Query callback name.

Returns

The callback name.

const std::string& getCallbackType ( ) const

inline

Query callback type.

Returns

Callback type string.

Widget* getCurrentFocusedWidget ( bool  isWidget )

inline

Return a current focused widget in your UI scene.

No matter what widget object you call this method on , it will return you the exact one focused widget.

Parameters

isWidget

if your set isWidget to true, it will return the _realFocusedWidget which is always a widget otherwise, it will return a widget or a layout.

Deprecated:

use getCurrentFocusedWidget instead.

Widget* getCurrentFocusedWidget

(

)

const

Return a current focused widget in your UI scene.

No matter what widget object you call this method on , it will return you the exact one focused widget.

const Size& getCustomSize

(

)

const

Get the user defined widget size.

Returns

User defined size.

virtual std::string getDescription ( ) const

overridevirtual

Returns the string representation of widget class name.

Returns

get the class description.

Reimplemented from Node.

Reimplemented in TextField, EditBox, ScrollView, Layout, RichText, ListView, CheckBox, Slider, PageView, Button, Text, LoadingBar, TextAtlas, ImageView, and TextBMFont.

GLProgramState* getGrayGLProgramState ( ) const

protected

Get a disabled state GLProgramState.

Since

v3.4

LayoutParameter* getLayoutParameter ( ) const

overridevirtual

Gets LayoutParameter of widget.

See also

LayoutParameter

Parameters

type	Relative or Linear

Returns

LayoutParameter

Implements LayoutParameterProtocol.

LayoutParameter* getLayoutParameter

(

LayoutParameter::Type

type

)

Gets LayoutParameter of widget.

See also

LayoutParameter

Deprecated:

use getLayoutParameter() instead.

Parameters

type	Relative or Linear

Returns

LayoutParameter

virtual const Size& getLayoutSize ( )

inlinevirtual

Get the content size of widget.

Warning

This API exists mainly for keeping back compatibility.

Returns

float getLeftBoundary

(

)

const

Gets the left boundary position of this widget in parent's coordination system.

Returns

The left boundary position of this widget.

float getLeftInParent ( )

inline

Gets the left boundary position of this widget in parent's coordination system.

Deprecated:

use getLeftBoundary instead.

Returns

The left boundary position of this widget.

GLProgramState* getNormalGLProgramState ( ) const

protected

Get a normal state GLProgramState.

Since

v3.4

LayoutComponent* getOrCreateLayoutComponent ( )

protected

const Vec2& getPositionPercent

(

)

Gets the percent (x,y) of the widget in OpenGL coordinates.

See also

setPosition(const Vec2&)

Returns

The percent (x,y) of the widget in OpenGL coordinates

PositionType getPositionType

(

)

const

Gets the position type of the widget.

See also

PositionType

Returns

type the position type of widget

float getRightBoundary

(

)

const

Gets the right boundary position of this widget in parent's coordination system.

Returns

The right boundary position of this widget.

float getRightInParent ( )

inline

Gets the right boundary position of this widget in parent's coordination system.

Deprecated:

use getRightBoundary instead.

Returns

The right boundary position of this widget.

virtual float getScale ( ) const

overridevirtual

Gets the scale factor of the node, when X and Y have the same scale factor.

Warning

Assert when _scaleX != _scaleY

See also

setScale(float)

Returns

The scale factor of the node.

Reimplemented from Node.

virtual float getScaleX ( ) const

overridevirtual

Returns the scale factor on X axis of this node.

See also

setScaleX(float)

Returns

The scale factor on X axis.

Reimplemented from Node.

virtual float getScaleY ( ) const

overridevirtual

Returns the scale factor on Y axis of this node.

See also

setScaleY(float)

Returns

The scale factor on Y axis.

Reimplemented from Node.

const Size& getSize

(

)

const

Get the size of widget.

Returns

Widget content size.

const Vec2& getSizePercent

(

)

Get size percent of widget.

Returns

Percent size.

SizeType getSizeType

(

)

const

Gets the size type of widget.

See also

SizeType

Parameters

type	that is widget's size type

float getTopBoundary

(

)

const

Gets the top boundary position of this widget in parent's coordination system.

Returns

The top boundary position of this widget.

float getTopInParent ( )

inline

Gets the top boundary position of this widget in parent's coordination system.

Deprecated:

use getTopBoundary instead.

Returns

The top boundary position of this widget.

const Vec2& getTouchBeganPosition

(

)

const

Gets the touch began point of widget when widget is selected.

Returns

the touch began point.

const Vec2& getTouchEndPos ( ) const

inline

const Vec2& getTouchEndPosition

(

)

const

const Vec2& getTouchMovePos ( ) const

inline

const Vec2& getTouchMovePosition

(

)

const

const Vec2& getTouchStartPos ( ) const

inline

Gets the touch began point of widget when widget is selected.

Deprecated:

use getTouchBeganPosition instead.

Returns

the touch began point.

virtual Node* getVirtualRenderer ( )

virtual

Gets the inner Renderer node of widget.

For example, a button's Virtual Renderer is it's texture renderer.

Returns

Node pointer.

Reimplemented in TextField, CheckBox, Slider, Button, Text, LoadingBar, TextAtlas, ImageView, and TextBMFont.

virtual Size getVirtualRendererSize ( ) const

virtual

Get the virtual renderer's size.

Returns

Widget virtual renderer size.

Reimplemented in TextField, RichText, CheckBox, Slider, Button, LoadingBar, Text, TextAtlas, ImageView, and TextBMFont.

Widget* getWidgetParent ( )

protected

Vec2 getWorldPosition

(

)

const

Gets position of widget in world space.

Returns

Position of widget in world space.

virtual bool hitTest ( const Vec2 &  pt )

virtual

Checks a point is in widget's content space.

This function is used for determining touch area of widget.

Parameters

pt	The point in Vec2.

Returns

true if the point is in widget's content space, flase otherwise.

Reimplemented in TextField, and Slider.

virtual void ignoreContentAdaptWithSize ( bool  ignore )

virtual

Toggle whether ignore user defined content size for widget.

Set true will ignore user defined content size which means the widget size is always equal to the return value of getVirtualRendererSize.

Parameters

ignore,set

member variabl _ignoreSize to ignore

Reimplemented in RichText, Slider, Button, LoadingBar, and ImageView.

virtual void initRenderer ( )

protectedvirtual

Reimplemented in TextField, ScrollView, RichText, Text, Button, CheckBox, Slider, LoadingBar, TextAtlas, ImageView, and TextBMFont.

virtual void interceptTouchEvent ( TouchEventType  event, Widget *  sender, Touch *  touch  )

virtual

Reimplemented in ScrollView, ListView, and PageView.

bool isAncestorsEnabled ( )

protected

bool isAncestorsVisible ( Node *  node )

protected

bool isBright

(

)

const

Determines if the widget is bright.

Returns

true if the widget is bright, false if the widget is dark.

bool isClippingParentContainsPoint

(

const Vec2 &

pt

)

Checks a point if in parent's area.

Parameters

point

A point in Vec2.

Returns

true if the point is in parent's area, flase otherwise.

bool isEnabled

(

)

const

Determines if the widget is enabled or not.

Returns

true if the widget is enabled, false if the widget is disabled.

virtual bool isFlippedX ( ) const

inlinevirtual

Returns the flag which indicates whether the widget is flipped horizontally or not.

It not only flips the texture of the widget, but also the texture of the widget's children. Also, flipping relies on widget's anchor point. Internally, it just use setScaleX(-1) to flip the widget.

Returns

true if the widget is flipped horizaontally, false otherwise.

virtual bool isFlippedY ( ) const

inlinevirtual

Return the flag which indicates whether the widget is flipped vertically or not.

It not only flips the texture of the widget, but also the texture of the widget's children. Also, flipping relies on widget's anchor point. Internally, it just use setScaleY(-1) to flip the widget.

Returns

true if the widget is flipped vertically, flase otherwise.

bool isFlipX ( )

inline

Deprecated:

Use isFlippedX() instead

bool isFlipY ( )

inline

Deprecated:

Use isFlippedY() instead

bool isFocused

(

)

const

Query whether widget is focused or not.

Returns

whether the widget is focused or not

bool isFocusEnabled

(

)

const

Query widget's focus enable state.

Returns

true represent the widget could accept focus, false represent the widget couldn't accept focus

bool isHighlighted

(

)

const

Determines if the widget is highlighted.

Returns

true if the widget is highlighted, false if the widget is not hignlighted .

bool isIgnoreContentAdaptWithSize

(

)

const

Query whether the widget ignores user deinfed content size or not.

Returns

True means ignore user defined content size, false otherwise.

bool isLayoutComponentEnabled

(

)

const

Query whether layout component is enabled or not.

Returns

true represent the widget use Layout Component, false represent the widget couldn't use Layout Component.

bool isPropagateTouchEvents

(

)

const

Return whether the widget is propagate touch events to its parents or not.

Returns

whether touch event propagation is allowed or not.

Since

v3.3

bool isSwallowTouches

(

)

const

Return whether the widget is swallowing touch or not.

Returns

Whether touch is swallowed.

Since

v3.3

bool isTouchEnabled

(

)

const

Determines if the widget is touch enabled.

Returns

true if the widget is touch enabled, false if the widget is touch disabled.

bool isUnifySizeEnabled

(

)

const

Query whether unify size enable state.

Returns

true represent the widget use Unify Size, false represent the widget couldn't use Unify Size

void moveEvent ( )

protected

virtual void onEnter ( )

overridevirtual

Event callback that is invoked every time when Node enters the 'stage'.

If the Node enters the 'stage' with a transition, this event is called when the transition starts. During onEnter you can't access a "sister/brother" node. If you override onEnter, you shall call its parent's one, e.g., Node::onEnter().

Reimplemented from ProtectedNode.

Reimplemented in TextField, EditBox, ScrollView, Layout, and PageView.

virtual void onExit ( )

overridevirtual

Event callback that is invoked every time the Node leaves the 'stage'.

If the Node leaves the 'stage' with a transition, this event is called when the transition finishes. During onExit you can't access a sibling node. If you override onExit, you shall call its parent's one, e.g., Node::onExit().

Reimplemented from ProtectedNode.

Reimplemented in EditBox, and Layout.

void onFocusChange	(	Widget *	widgetLostFocus,
		Widget *	widgetGetFocus
	)

This method is called when a focus change event happens.

Parameters

widgetLostFocus	The widget which lose its focus
widgetGetFocus	The widget whihc get its focus

Returns

void

virtual void onPressStateChangedToDisabled ( )

protectedvirtual

Reimplemented in Text, Button, CheckBox, and Slider.

virtual void onPressStateChangedToNormal ( )

protectedvirtual

Reimplemented in Text, Button, CheckBox, and Slider.

virtual void onPressStateChangedToPressed ( )

protectedvirtual

Reimplemented in Text, Button, CheckBox, and Slider.

virtual void onSizeChanged ( )

protectedvirtual

Reimplemented in TextField, Layout, ScrollView, Text, Button, ListView, CheckBox, Slider, PageView, LoadingBar, TextAtlas, ImageView, and TextBMFont.

virtual bool onTouchBegan ( Touch *  touch, Event *  unusedEvent  )

virtual

A callback which will be called when touch began event is issued.

Parameters

touch	The touch info.
unusedEvent	The touch event info.

Returns

True if user want to handle touches, false otherwise.

Reimplemented in TextField, ScrollView, Slider, and PageView.

virtual void onTouchCancelled ( Touch *  touch, Event *  unusedEvent  )

virtual

A callback which will be called when touch cancelled event is issued.

Parameters

touch	The touch info.
unusedEvent	The touch event info.

Reimplemented in ScrollView, Slider, and PageView.

virtual void onTouchEnded ( Touch *  touch, Event *  unusedEvent  )

virtual

A callback which will be called when touch ended event is issued.

Parameters

touch	The touch info.
unusedEvent	The touch event info.

Reimplemented in ScrollView, Slider, and PageView.

virtual void onTouchMoved ( Touch *  touch, Event *  unusedEvent  )

virtual

A callback which will be called when touch moved event is issued.

Parameters

touch	The touch info.
unusedEvent	The touch event info.

Reimplemented in ScrollView, Slider, and PageView.

void propagateTouchEvent	(	TouchEventType	event,
		Widget *	sender,
		Touch *	touch
	)

Propagate touch events to its parents.

void pushDownEvent ( )

protected

virtual void releaseUpEvent ( )

protectedvirtual

Reimplemented in CheckBox.

void requestFocus

(

)

when a widget calls this method, it will get focus immediately.

void setActionTag

(

int

tag

)

Set the tag of action.

Parameters

tag	A integer tag value.

void setBright

(

bool

bright

)

Sets whether the widget is bright.

The default value is true, a widget is default to bright

Parameters

visible

true if the widget is bright, false if the widget is dark.

void setBrightStyle

(

BrightStyle

style

)

To set the bright style of widget.

See also

BrightStyle

Parameters

style

BrightStyle::NORMAL means the widget is in normal state, BrightStyle::HIGHLIGHT means the widget is in highlight state.

void setCallbackName ( const std::string &  callbackName )

inline

Set callback name.

Parameters

callbackName

A string representation of callback name.

void setCallbackType ( const std::string &  callbackType )

inline

Set callback type.

Parameters

callbackType

A string representation of callback type.

virtual void setContentSize ( const Size &  contentSize )

overridevirtual

Changes the size that is widget's size.

Parameters

contentSize

A content size in Size.

Reimplemented from Node.

Reimplemented in EditBox.

virtual void setEnabled ( bool  enabled )

virtual

Sets whether the widget is enabled.

true if the widget is enabled, widget may be touched , false if the widget is disabled, widget cannot be touched.

Note: If you want to change the widget's appearance to disabled state, you should also call setBright(false).

The default value is true, a widget is default to enable touch.

Parameters

enabled

Set to true to enable touch, false otherwise.

virtual void setFlippedX ( bool  flippedX )

virtual

Sets whether the widget should be flipped horizontally or not.

Parameters

bFlippedX

true if the widget should be flipped horizaontally, false otherwise.

virtual void setFlippedY ( bool  flippedY )

virtual

Sets whether the widget should be flipped vertically or not.

Parameters

bFlippedY

true if the widget should be flipped vertically, flase otherwise.

void setFlipX ( bool  flipX )

inline

Deprecated:

Use setFlippedX() instead

void setFlipY ( bool  flipY )

inline

Deprecated:

Use setFlippedY() instead

void setFocused

(

bool

focus

)

Toggle widget focus status.

Parameters

focus

pass true to let the widget get focus or pass false to let the widget lose focus

Returns

void

void setFocusEnabled

(

bool

enable

)

Allow widget to accept focus.

Parameters

enable

pass true/false to enable/disable the focus ability of a widget

Returns

void

void setHighlighted

(

bool

hilight

)

Sets whether the widget is hilighted.

The default value is false, a widget is default to not hilighted

Parameters

hilight

true if the widget is hilighted, false if the widget is not hilighted.

void setLayoutComponentEnabled

(

bool

enable

)

Toggle layout component enable.

Parameters

enable

Layout Component of a widget

Returns

void

void setLayoutParameter

(

LayoutParameter *

parameter

)

Sets a LayoutParameter to widget.

See also

LayoutParameter

Parameters

LayoutParameter	pointer
type	Relative or Linear

virtual void setPosition ( const Vec2 &  pos )

overridevirtual

Changes the position (x,y) of the widget in OpenGL coordinates.

Usually we use p(x,y) to compose a Vec2 object. The original point (0,0) is at the left-bottom corner of screen.

Parameters

position

The position (x,y) of the widget in OpenGL coordinates

Reimplemented from Node.

Reimplemented in EditBox.

void setPositionPercent

(

const Vec2 &

percent

)

Set the percent(x,y) of the widget in OpenGL coordinates.

Parameters

percent

The percent (x,y) of the widget in OpenGL coordinates

void setPositionType

(

PositionType

type

)

Changes the position type of the widget.

See also

PositionType

Parameters

type	the position type of widget

void setPropagateTouchEvents

(

bool

isPropagate

)

Allow widget touch events to propagate to its parents.

Set false will disable propagation

Parameters

isPropagate

True to allow propagation, false otherwise.

Since

v3.3

virtual void setScale ( float  scale )

overridevirtual

Sets the scale (x,y,z) of the node.

It is a scaling factor that multiplies the width, height and depth of the node and its children.

Parameters

scale

The scale factor for both X and Y axis.

Warning

The physics body doesn't support this.

Reimplemented from Node.

virtual void setScale ( float  scaleX, float  scaleY  )

overridevirtual

Sets the scale (x,y) of the node.

It is a scaling factor that multiplies the width and height of the node and its children.

Parameters

scaleX	The scale factor on X axis.
scaleY	The scale factor on Y axis.

Warning

The physics body doesn't support this.

Reimplemented from Node.

virtual void setScaleX ( float  scaleX )

overridevirtual

Sets the scale (x) of the node.

It is a scaling factor that multiplies the width of the node and its children.

Parameters

scaleX

The scale factor on X axis.

Warning

The physics body doesn't support this.

Reimplemented from Node.

virtual void setScaleY ( float  scaleY )

overridevirtual

Sets the scale (y) of the node.

It is a scaling factor that multiplies the height of the node and its children.

Parameters

scaleY

The scale factor on Y axis.

Warning

The physics body doesn't support this.

Reimplemented from Node.

virtual void setSize ( const Size &  size )

virtual

Changes the size that is widget's size.

Deprecated:

use setContentSize instead.

Parameters

size	that is widget's size

virtual void setSizePercent ( const Vec2 &  percent )

virtual

Changes the percent that is widget's percent size.

Parameters

percent

that is widget's percent size

void setSizeType

(

SizeType

type

)

Changes the size type of widget.

See also

SizeType

Parameters

type	that is widget's size type

void setSwallowTouches

(

bool

swallow

)

Toggle widget swallow touch option.

Specify widget to swallow touches or not

Parameters

swallow

True to swallow touch, false otherwise.

Since

v3.3

virtual void setTouchEnabled ( bool  enabled )

virtual

Sets whether the widget is touch enabled.

The default value is false, a widget is default to touch disabled

Parameters

visible

true if the widget is touch enabled, false if the widget is touch disabled.

void setUnifySizeEnabled

(

bool

enable

)

Toggle use unify size.

Parameters

enable

True to use unify size, false otherwise.

Returns

void

void updateChildrenDisplayedRGBA ( )

protected

void updateContentSizeWithTextureSize ( const Size &  size )

protected

void updateSizeAndPosition

(

)

Update all children's contents size and position recursively.

See also

updateSizeAndPosition(const Size&)

void updateSizeAndPosition

(

const Size &

parentSize

)

Update all children's contents size and position recursively.

virtual void visit ( cocos2d::Renderer *  renderer, const Mat4 &  parentTransform, uint32_t  parentFlags  )

overridevirtual

Visits this node's children and draw them recursively.

Parameters

renderer	A given renderer.
parentTransform	A transform matrix.
parentFlags	Renderer flag.

Reimplemented from ProtectedNode.

Reimplemented in EditBox, and Layout.

Friends And Related Function Documentation

friend class PageView

friend

Member Data Documentation

CC_CONSTRUCTOR_ACCESS __pad0__

int _actionTag

protected

bool _affectByClipping

protected

bool _bright

protected

BrightStyle _brightStyle

protected

std::string _callbackName

protected

std::string _callbackType

protected

ccWidgetEventCallback _ccEventCallback

protected

ccWidgetClickCallback _clickEventListener

protected

Size _customSize

protected

bool _enabled

protected

bool _flippedX

protected

bool _flippedY

protected

bool _focused

protected

Widget* _focusedWidget

staticprotected

store the only one focued widget

bool _focusEnabled

protected

bool _highlight

protected

bool _hitted

protected

bool _ignoreSize

protected

Map<int,LayoutParameter*> _layoutParameterDictionary

protected

LayoutParameter::Type _layoutParameterType

protected

Vec2 _positionPercent

protected

PositionType _positionType

protected

bool _propagateTouchEvents

protected

Vec2 _sizePercent

protected

SizeType _sizeType

protected

Vec2 _touchBeganPosition

protected

bool _touchEnabled

protected

Vec2 _touchEndPosition

protected

ccWidgetTouchCallback _touchEventCallback

protected

Ref* _touchEventListener

protected

SEL_TouchEvent _touchEventSelector

protected

EventListenerTouchOneByOne* _touchListener

protected

Vec2 _touchMovePosition

protected

bool _unifySize

protected

bool _usingLayoutComponent

protected

std::function<void(Widget*,Widget*)> onFocusChanged

When a widget lose/get focus, this method will be called.

Be Caution when you provide your own version, you must call widget->setFocused(true/false) to change the focus state of the current focused widget;

std::function<Widget*(FocusDirection)> onNextFocusedWidget

use this function to manually specify the next focused widget regards to each direction

---

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

• /Users/minggo/SourceCode/cocos2d-x/cocos/ui/UIWidget.h