Cocos2d-x  v3.17
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Groups Pages
Widget Class Reference

Base class for all ui widgets. More...

Inherits ProtectedNode, and LayoutParameterProtocol.

Inherited by VideoPlayer, WebView, AbstractCheckButton, Button, EditBox, ImageView, Layout, LoadingBar, RadioButtonGroup, RichText, Slider, TabControl, Text, TextAtlas, TextBMFont, and TextField.

Public Types

enum  FocusDirection
 Widget focus direction.
 
enum  PositionType
 Widget position type for layout.
 
enum  SizeType
 Widget size type for layout.
 
enum  TouchEventType
 Touch event type.
 
enum  TextureResType
 Texture resource type. More...
 
enum  BrightStyle
 Widget bright style.
 
typedef std::function< void(Ref
*, Widget::TouchEventType)> 
ccWidgetTouchCallback
 Widget touch event callback.
 
typedef std::function< void(Ref *)> ccWidgetClickCallback
 Widget click event callback.
 
typedef std::function< void(Ref
*, int)> 
ccWidgetEventCallback
 Widget custom event callback. More...
 

Public Member Functions

 Widget (void)
 Default constructor. More...
 
 new ()
 Default constructor. More...
 
virtual ~Widget ()
 Default destructor. More...
 
virtual void setEnabled (bool enabled)
 Sets whether the widget is enabled. More...
 
local setEnabled ( local 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...
 
var setBright ( var bright)
 Sets whether the widget is bright. More...
 
local setBright ( local 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...
 
local setTouchEnabled ( local enabled)
 Sets whether the widget is touch enabled. More...
 
void setBrightStyle (BrightStyle style)
 To set the bright style of widget. More...
 
var setBrightStyle ( var style)
 To set the bright style of widget. More...
 
local setBrightStyle ( local 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...
 
var isHighlighted ()
 Determines if the widget is highlighted. More...
 
local isHighlighted ()
 Determines if the widget is highlighted. More...
 
void setHighlighted (bool highlight)
 Sets whether the widget is highlighted. More...
 
float getLeftInParent ()
 Gets the left boundary position of this widget in parent's coordination system. More...
 
var getLeftInParent ()
 Gets the left boundary position of this widget in parent's coordination system. More...
 
local 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...
 
var getLeftBoundary ()
 Gets the left boundary position of this widget in parent's coordination system. More...
 
local getLeftBoundary ()
 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...
 
var getBottomInParent ()
 Gets the bottom boundary position of this widget in parent's coordination system. More...
 
local 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...
 
var getBottomBoundary ()
 Gets the bottom boundary position of this widget in parent's coordination system. More...
 
local getBottomBoundary ()
 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...
 
var getRightInParent ()
 Gets the right boundary position of this widget in parent's coordination system. More...
 
local 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...
 
var getRightBoundary ()
 Gets the right boundary position of this widget in parent's coordination system. More...
 
local getRightBoundary ()
 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...
 
var getTopInParent ()
 Gets the top boundary position of this widget in parent's coordination system. More...
 
local 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...
 
var getTopBoundary ()
 Gets the top boundary position of this widget in parent's coordination system. More...
 
local getTopBoundary ()
 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...
 
local visit ( local renderer, local parentTransform, local parentFlags)
 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.
 
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...
 
var addClickEventListener ( var callback)
 Set a click event handler to the widget. More...
 
local addClickEventListener ( local 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...
 
var addCCSEventListener ( var 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 Vec2getPositionPercent ()
 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...
 
local setFlippedX ( local 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...
 
var setFlippedY ( var flippedY)
 Sets whether the widget should be flipped vertically or not. More...
 
local setFlippedY ( local 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 ()
local isFlipX ()
void setFlipX (bool flipX)
var setFlipX ( var flipX)
local setFlipX ( local flipX)
bool isFlipY ()
void setFlipY (bool flipY)
var setFlipY ( var flipY)
local setFlipY ( local flipY)
virtual void setScaleX (float scaleX) override
 Sets the scale (x) of the node. More...
 
var setScaleX ( var scaleX)
 Sets the scale (x) of the node. More...
 
local setScaleX ( local scaleX)
 Sets the scale (x) of the node. More...
 
virtual void setScaleY (float scaleY) override
 Sets the scale (y) of the node. More...
 
local setScaleY ( local scaleY)
 Sets the scale (y) of the node. More...
 
virtual void setScale (float scale) override
 Sets the scale (x,y,z) of the node. More...
 
local setScale ( local scale)
 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...
 
local setScale ( local scalex, local scaley)
 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...
 
var getScaleX ()
 Returns the scale factor on X axis of this node. More...
 
local getScaleX ()
 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...
 
local getScaleY ()
 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...
 
local getScale ()
 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...
 
var clippingParentAreaContainPoint ( var pt)
 Checks a point if in parent's area. More...
 
local clippingParentAreaContainPoint ( local 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 Vec2getTouchStartPos () const
 Gets the touch began point of widget when widget is selected. More...
 
local getTouchStartPos ()
 Gets the touch began point of widget when widget is selected. More...
 
const Vec2getTouchBeganPosition () const
 Gets the touch began point of widget when widget is selected. More...
 
var getTouchBeganPosition ()
 Gets the touch began point of widget when widget is selected. More...
 
local getTouchBeganPosition ()
 Gets the touch began point of widget when widget is selected. More...
 
virtual void setSize (const Size &size)
 Changes the size that is widget's size. More...
 
local setSize ( local 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...
 
var setContentSize ( var contentSize)
 Changes the size that is widget's size. More...
 
local setContentSize ( local contentSize)
 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...
 
local setSizePercent ( local percent)
 Changes the percent that is widget's percent size. More...
 
void setSizeType (SizeType type)
 Changes the size type of widget. More...
 
var setSizeType ( var type)
 Changes the size type of widget. More...
 
local setSizeType ( local type)
 Changes the size type of widget. More...
 
SizeType getSizeType () const
 Gets the size type of widget. More...
 
var getSizeType ()
 Gets the size type of widget. More...
 
local getSizeType ()
 Gets the size type of widget. More...
 
const Size & getSize () const
 Get the size of widget. More...
 
local getSize ()
 Get the size of widget. More...
 
const Size & getCustomSize () const
 Get the user defined widget size. More...
 
var getCustomSize ()
 Get the user defined widget size. More...
 
local getCustomSize ()
 Get the user defined widget size. More...
 
virtual const Size & getLayoutSize ()
 Get the content size of widget. More...
 
const Vec2getSizePercent ()
 Get size percent of widget. More...
 
virtual bool hitTest (const Vec2 &pt, const Camera *camera, Vec3 *p) const
 Checks a point is in widget's content space. More...
 
local hitTest ( local pt, local camera, local p)
 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...
 
var onTouchBegan ( var touch, var unusedEvent)
 A callback which will be called when touch began event is issued. More...
 
local onTouchBegan ( local touch, local 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...
 
local onTouchEnded ( local touch, local 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...
 
local onTouchCancelled ( local touch, local unusedEvent)
 A callback which will be called when touch cancelled event is issued. More...
 
void setLayoutParameter (LayoutParameter *parameter)
 Sets a LayoutParameter to widget. More...
 
var setLayoutParameter ( var parameter)
 Sets a LayoutParameter to widget. More...
 
local setLayoutParameter ( local parameter)
 Sets a LayoutParameter to widget. More...
 
LayoutParametergetLayoutParameter () const override
 Gets LayoutParameter of widget. More...
 
var getLayoutParameter ()
 Gets LayoutParameter of widget. More...
 
local getLayoutParameter ()
 Gets LayoutParameter of widget. More...
 
LayoutParametergetLayoutParameter (LayoutParameter::Type type)
 Gets LayoutParameter of widget. More...
 
local getLayoutParameter ( local 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 defined content size or not. More...
 
Vec2 getWorldPosition () const
 Gets position of widget in world space. More...
 
virtual NodegetVirtualRenderer ()
 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...
 
local getDescription ()
 Returns the string representation of widget class name. More...
 
Widgetclone ()
 Create a new widget copy of the original one. More...
 
var clone ()
 Create a new widget copy of the original one. More...
 
local 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...
 
var onEnter ()
 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...
 
var updateSizeAndPosition ()
 Update all children's contents size and position recursively. More...
 
local 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.
 
var updateSizeAndPosition ( var parentSize)
 Update all children's contents size and position recursively.
 
local updateSizeAndPosition ( local parentSize)
 Update all children's contents size and position recursively.
 
void setActionTag (int tag)
 Set the tag of action. More...
 
int getActionTag () const
 Get the action tag. More...
 
var getActionTag ()
 Get the action tag. More...
 
local getActionTag ()
 Get the action tag. More...
 
void setPropagateTouchEvents (bool isPropagate)
 Allow widget touch events to propagate to its parents. More...
 
var setPropagateTouchEvents ( var isPropagate)
 Allow widget touch events to propagate to its parents. More...
 
local setPropagateTouchEvents ( local 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...
 
var setSwallowTouches ( var swallow)
 Toggle widget swallow touch option. More...
 
local setSwallowTouches ( local swallow)
 Toggle widget swallow touch option. More...
 
bool isSwallowTouches () const
 Return whether the widget is swallowing touch or not. More...
 
var isSwallowTouches ()
 Return whether the widget is swallowing touch or not. More...
 
local isSwallowTouches ()
 Return whether the widget is swallowing touch or not. More...
 
bool isFocused () const
 Query whether widget is focused or not. More...
 
var isFocused ()
 Query whether widget is focused or not. More...
 
local isFocused ()
 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...
 
var setFocusEnabled ( var enable)
 Allow widget to accept focus. More...
 
local setFocusEnabled ( local enable)
 Allow widget to accept focus. More...
 
virtual WidgetfindNextFocusedWidget (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...
 
local findNextFocusedWidget ( local direction, local 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.
 
WidgetgetCurrentFocusedWidget (bool isWidget)
 Return a current focused widget in your UI scene. More...
 
local getCurrentFocusedWidget ( local isWidget)
 Return a current focused widget in your UI scene. More...
 
void setUnifySizeEnabled (bool enable)
 Toggle use unify size. More...
 
var setUnifySizeEnabled ( var enable)
 Toggle use unify size. More...
 
local setUnifySizeEnabled ( local enable)
 Toggle use unify size. More...
 
bool isUnifySizeEnabled () const
 Query whether unify size enable state. More...
 
var isUnifySizeEnabled ()
 Query whether unify size enable state. More...
 
local isUnifySizeEnabled ()
 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...
 
local getCallbackName ()
 Query callback name. More...
 
void setCallbackType (const std::string &callbackType)
 Set callback type. More...
 
var setCallbackType ( var callbackType)
 Set callback type. More...
 
local setCallbackType ( local callbackType)
 Set callback type. More...
 
const std::string & getCallbackType () const
 Query callback type. More...
 
var getCallbackType ()
 Query callback type. More...
 
local getCallbackType ()
 Query callback type. More...
 
void setLayoutComponentEnabled (bool enable)
 Toggle layout component enable. More...
 
var setLayoutComponentEnabled ( var enable)
 Toggle layout component enable. More...
 
local setLayoutComponentEnabled ( local enable)
 Toggle layout component enable. More...
 
bool isLayoutComponentEnabled () const
 Query whether layout component is enabled or not. More...
 
- Public Member Functions inherited from ProtectedNode
virtual void cleanup () override
 Stops all running actions and schedulers.
 
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
 Update the displayed opacity of node with it's parent opacity;. More...
 
var updateDisplayedOpacity ( var parentOpacity)
 Update the displayed opacity of node with it's parent opacity;. More...
 
local updateDisplayedOpacity ( local parentOpacity)
 Update the displayed opacity of node with it's parent opacity;. More...
 
virtual void updateDisplayedColor (const Color3B &parentColor) override
 Update node's displayed color with its parent color. More...
 
local updateDisplayedColor ( local parentColor)
 Update node's displayed color with its parent color. More...
 
virtual void setCameraMask (unsigned short mask, bool applyChildren=true) override
 Modify the camera mask for current node. More...
 
virtual void setGlobalZOrder (float globalZOrder) override
 Defines the order in which the nodes are renderer. More...
 
local setGlobalZOrder ( local globalZOrder)
 Defines the order in which the nodes are renderer. More...
 
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...
 
var addProtectedChild ( var child, var localZOrder, var 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 NodegetProtectedChildByTag (int tag)
 Gets a child from the container with its tag. More...
 
var getProtectedChildByTag ( var tag)
 Gets a child from the container with its tag. More...
 
local getProtectedChildByTag ( local 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...
 
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...
 
var isRunning ()
 Returns whether or not the node is "running". More...
 
local isRunning ()
 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...
 
virtual ScenegetScene () 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...
 
var setEventDispatcher ( var dispatcher)
 Set event dispatcher for scene. More...
 
local setEventDispatcher ( local dispatcher)
 Set event dispatcher for scene. More...
 
virtual EventDispatchergetEventDispatcher () const
 Get the event dispatcher of scene. More...
 
local getEventDispatcher ()
 Get the event dispatcher of scene. More...
 
virtual GLubyte getOpacity () const
 Return the node's opacity. More...
 
local getOpacity ()
 Return the node's opacity. More...
 
virtual GLubyte getDisplayedOpacity () const
 Return the node's display opacity. More...
 
local getDisplayedOpacity ()
 Return the node's display opacity. More...
 
virtual void setOpacity (GLubyte opacity)
 Change node opacity. More...
 
virtual bool isCascadeOpacityEnabled () const
 Whether cascadeOpacity is enabled or not. More...
 
var isCascadeOpacityEnabled ()
 Whether cascadeOpacity is enabled or not. More...
 
local isCascadeOpacityEnabled ()
 Whether cascadeOpacity is enabled or not. More...
 
virtual void setCascadeOpacityEnabled (bool cascadeOpacityEnabled)
 Change node's cascadeOpacity property. More...
 
local setCascadeOpacityEnabled ( local cascadeOpacityEnabled)
 Change node's cascadeOpacity property. More...
 
virtual const Color3BgetColor () const
 Query node's color value. More...
 
local getColor ()
 Query node's color value. More...
 
virtual const Color3BgetDisplayedColor () const
 Query node's displayed color. More...
 
local getDisplayedColor ()
 Query node's displayed color. More...
 
virtual void setColor (const Color3B &color)
 Change the color of node. More...
 
var setColor ( var color)
 Change the color of node. More...
 
local setColor ( local color)
 Change the color of node. More...
 
virtual bool isCascadeColorEnabled () const
 Query whether cascadeColor is enabled or not. More...
 
var isCascadeColorEnabled ()
 Query whether cascadeColor is enabled or not. More...
 
local isCascadeColorEnabled ()
 Query whether cascadeColor is enabled or not. More...
 
virtual void setCascadeColorEnabled (bool cascadeColorEnabled)
 If you want node's color affect the children node's color, then set it to true. More...
 
virtual void setOpacityModifyRGB (bool value)
 If you want the opacity affect the color property, then set to true. More...
 
local setOpacityModifyRGB ( local value)
 If you want the opacity affect the color property, then set to true. More...
 
virtual bool isOpacityModifyRGB () const
 If node opacity will modify the RGB color value, then you should override this method and return true. More...
 
void setOnEnterCallback (const std::function< void()> &callback)
 Set the callback of event onEnter. More...
 
const std::function< void()> & getOnEnterCallback () const
 Get the callback of event onEnter. More...
 
void setOnExitCallback (const std::function< void()> &callback)
 Set the callback of event onExit. More...
 
var setOnExitCallback ( var callback)
 Set the callback of event onExit. More...
 
local setOnExitCallback ( local callback)
 Set the callback of event onExit. More...
 
const std::function< void()> & getOnExitCallback () const
 Get the callback of event onExit. More...
 
local getOnExitCallback ()
 Get the callback of event onExit. More...
 
void setonEnterTransitionDidFinishCallback (const std::function< void()> &callback)
 Set the callback of event EnterTransitionDidFinish. More...
 
var setonEnterTransitionDidFinishCallback ( var callback)
 Set the callback of event EnterTransitionDidFinish. More...
 
local setonEnterTransitionDidFinishCallback ( local callback)
 Set the callback of event EnterTransitionDidFinish. More...
 
const std::function< void()> & getonEnterTransitionDidFinishCallback () const
 Get the callback of event EnterTransitionDidFinish. More...
 
void setonExitTransitionDidStartCallback (const std::function< void()> &callback)
 Set the callback of event ExitTransitionDidStart. More...
 
var setonExitTransitionDidStartCallback ( var callback)
 Set the callback of event ExitTransitionDidStart. More...
 
local setonExitTransitionDidStartCallback ( local callback)
 Set the callback of event ExitTransitionDidStart. More...
 
const std::function< void()> & getonExitTransitionDidStartCallback () const
 Get the callback of event ExitTransitionDidStart. More...
 
unsigned short getCameraMask () const
 get & set camera mask, the node is visible by the camera whose camera flag & node's camera mask is true
 
virtual void setLocalZOrder (std::int32_t localZOrder)
 LocalZOrder is the 'key' used to sort the node relative to its siblings. More...
 
virtual void setZOrder (std::int32_t localZOrder)
virtual void _setLocalZOrder (std::int32_t z)
local _setLocalZOrder ( local z)
void updateOrderOfArrival ()
 !!! ONLY FOR INTERNAL USE Sets the arrival order when this node has a same ZOrder with other children. More...
 
virtual std::int32_t getLocalZOrder () const
 Gets the local Z order of this node. More...
 
virtual std::int32_t getZOrder () const
var getZOrder ()
local getZOrder ()
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...
 
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 setPositionNormalized (const Vec2 &position)
 Sets the position (x,y) using values between 0 and 1. More...
 
virtual void setNormalizedPosition (const Vec2 &position)
local setNormalizedPosition ( local position)
virtual const Vec2getPosition () const
 Gets the position (x,y) of the node in its parent's coordinate system. More...
 
local getPosition ()
 Gets the position (x,y) of the node in its parent's coordinate system. More...
 
virtual const Vec2getPositionNormalized () const
 Returns the normalized position. More...
 
virtual const Vec2getNormalizedPosition () const
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...
 
var setPositionX ( var x)
 Gets/Sets x or y coordinate individually for position. More...
 
local setPositionX ( local 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...
 
local setPositionY ( local 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...
 
var getPositionY ()
 Gets the y coordinate of the node in its parent's coordinate system. More...
 
local getPositionY ()
 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...
 
local setPosition3D ( local 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...
 
local getPosition3D ()
 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...
 
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...
 
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...
 
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...
 
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 Vec2getAnchorPoint () const
 Returns the anchor point in percent. More...
 
virtual const Vec2getAnchorPointInPoints () 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...
 
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...
 
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...
 
local getRotationQuat ()
 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...
 
virtual void setRotationX (float 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...
 
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)
var setRotationY ( var 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 setGLServerState (int)
var setGLServerState ( var int)
int getGLServerState () const
virtual void setIgnoreAnchorPointForPosition (bool ignore)
 Sets whether the anchor point will be (0,0) when you position this node. More...
 
local setIgnoreAnchorPointForPosition ( local ignore)
 Sets whether the anchor point will be (0,0) when you position this node. More...
 
virtual void ignoreAnchorPointForPosition (bool ignore)
local ignoreAnchorPointForPosition ( local ignore)
virtual bool isIgnoreAnchorPointForPosition () const
 Gets whether the anchor point will be (0,0) when you position this node. 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 const std::string & getName () const
 Returns a string that is used to identify the node. More...
 
local getName ()
 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...
 
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 RefgetUserObject ()
 Returns a user assigned Object. More...
 
var getUserObject ()
 Returns a user assigned Object. More...
 
virtual const RefgetUserObject () const
virtual void setUserObject (Ref *userObject)
 Returns a user assigned Object. More...
 
local setUserObject ( local userObject)
 Returns a user assigned Object. More...
 
GLProgramgetGLProgram () 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...
 
GLProgramgetShaderProgram () const
var getShaderProgram ()
local getShaderProgram ()
virtual void setGLProgram (GLProgram *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)
GLProgramStategetGLProgramState () 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...
 
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 ActionManagergetActionManager ()
 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 ActionManagergetActionManager () const
virtual ActionrunAction (Action *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 .
 
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...
 
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...
 
void stopActionsByFlags (unsigned int flags)
 Removes all actions from the running action list by its flags. More...
 
ActiongetActionByTag (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...
 
ssize_t getNumberOfRunningActionsByTag (int tag) const
 Returns the numbers of actions that are running plus the ones that are schedule to run (actions in actionsToAdd and actions arrays) with a specific tag. More...
 
local getNumberOfRunningActionsByTag ( local tag)
 Returns the numbers of actions that are running plus the ones that are schedule to run (actions in actionsToAdd and actions arrays) with a specific tag. More...
 
ssize_t numberOfRunningActions () const
local numberOfRunningActions ()
virtual void setScheduler (Scheduler *scheduler)
 Sets a Scheduler object that is used to schedule all "updates" and timers. More...
 
virtual SchedulergetScheduler ()
 Gets a Scheduler object. More...
 
local getScheduler ()
 Gets a Scheduler object. More...
 
virtual const SchedulergetScheduler () const
local getScheduler ()
bool isScheduled (SEL_SCHEDULE selector) const
 Checks whether a selector is scheduled. More...
 
bool isScheduled (const std::string &key) const
 Checks whether a lambda function is scheduled. More...
 
void scheduleUpdate (void)
 Schedules the "update" method. More...
 
var scheduleUpdate ()
 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...
 
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...
 
var schedule ( var callback, var 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...
 
void unschedule (SEL_SCHEDULE 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...
 
var resume ()
 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...
 
var update ( var delta)
 Update method will be called automatically every frame if "scheduleUpdate" is called, and the node is "live". More...
 
local update ( local 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 Mat4getNodeToParentTransform () 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 Mat4 getNodeToParentTransform (Node *ancestor) const
 Returns the matrix that transform the node's (local) space coordinates into the parent's space coordinates. More...
 
var getNodeToParentTransform ( var ancestor)
 Returns the matrix that transform the node's (local) space coordinates into the parent's space coordinates. More...
 
local getNodeToParentTransform ( local ancestor)
 Returns the matrix that transform the node's (local) space coordinates into the parent's space coordinates. More...
 
virtual AffineTransform getNodeToParentAffineTransform (Node *ancestor) const
 Returns the affine transform matrix that transform the node's (local) space coordinates into the parent's space coordinates. More...
 
local getNodeToParentAffineTransform ( local ancestor)
 Returns the affine transform matrix that transform the node's (local) space coordinates into the parent's space coordinates. More...
 
virtual void setNodeToParentTransform (const Mat4 &transform)
 Sets the transformation matrix manually. More...
 
var setNodeToParentTransform ( var transform)
 Sets the transformation matrix manually. More...
 
local setNodeToParentTransform ( local transform)
 Sets the transformation matrix manually. More...
 
virtual AffineTransform nodeToParentTransform () const
virtual const Mat4getParentToNodeTransform () 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...
 
var getNodeToWorldTransform ()
 Returns the world affine transform matrix. More...
 
local getNodeToWorldTransform ()
 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...
 
var convertToWorldSpaceAR ( var nodePoint)
 Converts a local Vec2 to world space coordinates.The result is in Points. More...
 
local convertToWorldSpaceAR ( local nodePoint)
 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...
 
local convertTouchToNodeSpace ( local touch)
 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 (const Mat4 *additionalTransform)
 Sets an additional transform matrix to the node. More...
 
void setAdditionalTransform (const Mat4 &additionalTransform)
var setAdditionalTransform ( var additionalTransform)
local setAdditionalTransform ( local additionalTransform)
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...
 
local getComponent ( local name)
 Gets a component by its name. More...
 
virtual bool addComponent (Component *component)
 Adds a component. More...
 
local addComponent ( local component)
 Adds a component. More...
 
virtual bool removeComponent (const std::string &name)
 Removes a component by its name. More...
 
local removeComponent ( local name)
 Removes a component by its name. More...
 
virtual bool removeComponent (Component *component)
 Removes a component by its pointer. More...
 
local removeComponent ( local component)
 Removes a component by its pointer. More...
 
virtual void removeAllComponents ()
 Removes all components.
 
virtual void addChild (Node *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 NodegetChildByTag (int tag) const
 Gets a child from the container with its tag. More...
 
local getChildByTag ( local tag)
 Gets a child from the container with its tag. More...
 
template<typename T >
getChildByTag (int tag) const
 Gets a child from the container with its tag that can be cast to Type T. More...
 
virtual NodegetChildByName (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 >
getChildByName (const std::string &name) const
 Gets a child from the container with its name that can be cast to Type T. More...
 
template<typename T >
var getChildByName ( var name)
 Gets a child from the container with its name that can be cast to Type T. More...
 
template<typename T >
local getChildByName ( local name)
 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
var getChildren ()
local getChildren ()
virtual ssize_t getChildrenCount () const
 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 NodegetParent ()
 Returns a pointer to the parent node. More...
 
virtual const NodegetParent () const
local getParent ()
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...
 
local removeChild ( local child, local 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...
 
var removeChildByTag ( var tag, var 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...
 
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...
 
var reorderChild ( var child, var 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...
 
- Public Member Functions inherited from Ref
void retain ()
 Retains the ownership. More...
 
void release ()
 Releases the ownership immediately. More...
 
local release ()
 Releases the ownership immediately. More...
 
Refautorelease ()
 Releases the ownership sometime soon automatically. More...
 
unsigned int getReferenceCount () const
 Returns the Ref's current reference count. More...
 
local getReferenceCount ()
 Returns the Ref's current reference count. More...
 
virtual ~Ref ()
 Destructor. More...
 
- Public Member Functions inherited from LayoutParameterProtocol
virtual ~LayoutParameterProtocol ()
 Default destructor.
 

Static Public Member Functions

static Widgetcreate ()
 Create and return a empty Widget instance pointer.
 
local create ()
 Create and return a empty Widget instance pointer.
 
static WidgetgetCurrentFocusedWidget ()
 Return a current focused widget in your UI scene. More...
 
var getCurrentFocusedWidget ()
 Return a current focused widget in your UI scene. More...
 
local getCurrentFocusedWidget ()
 Return a current focused widget in your UI scene. More...
 
- Static Public Member Functions inherited from ProtectedNode
static ProtectedNodecreate (void)
 Creates a ProtectedNode with no argument. More...
 
- Static Public Member Functions inherited from Node
static Nodecreate ()
 Allocates and initializes a node. More...
 
var create ()
 Allocates and initializes a node. More...
 
local create ()
 Allocates and initializes a node. More...
 
static int getAttachedNodeCount ()
 Gets count of nodes those are attached to scene graph.
 
var getAttachedNodeCount ()
 Gets count of nodes those are attached to scene graph.
 
local getAttachedNodeCount ()
 Gets count of nodes those are attached to scene graph.
 
template<typename _T >
static void sortNodes (cocos2d::Vector< _T * > &nodes)
 Sorts helper function. 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
 
- Public Attributes inherited from Ref
unsigned int _ID
 object id, ScriptSupport need public _ID
 
local _ID
 object id, ScriptSupport need public _ID
 
int _luaID
 Lua reference id.
 
local _luaID
 Lua reference id.
 
void * _scriptObject
 scriptObject, support for swift
 
local _scriptObject
 scriptObject, support for swift
 
bool _rooted
 When true, it means that the object was already rooted.
 
local _rooted
 When true, it means that the object was already rooted.
 

Protected Member Functions

void propagateTouchEvent (TouchEventType event, Widget *sender, Touch *touch)
 Propagate touch events to its parents.
 
void onFocusChange (Widget *widgetLostFocus, Widget *widgetGetFocus)
 This method is called when a focus change event happens. More...
 
local onFocusChange ( local widgetLostFocus, local 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...
 

Additional Inherited Members

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

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*,
int)> ccWidgetEventCallback

Widget custom event callback.

It is mainly used together with Cocos Studio.

Widget custom event callback.

It is mainly used together with Cocos Studio.

Widget custom event callback.

It is mainly used together with Cocos Studio.

Constructor & Destructor Documentation

Widget ( void  )

Default constructor.

var ctor (   )

Default constructor.

local new (   )

Default constructor.

virtual ~Widget ( )
virtual

Default destructor.

Member Function Documentation

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
enabledSet to true to enable touch, false otherwise.
var setEnabled ( var  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
enabledSet to true to enable touch, false otherwise.
local setEnabled ( local  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
enabledSet to true to enable touch, false 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.
var isEnabled ( )

Determines if the widget is enabled or not.

Returns
true if the widget is enabled, false if the widget is disabled.
local isEnabled ( )

Determines if the widget is enabled or not.

Returns
true if the widget is enabled, false if the widget is disabled.
void setBright ( bool  bright)

Sets whether the widget is bright.

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

Parameters
brighttrue if the widget is bright, false if the widget is dark.
var setBright ( var  bright)

Sets whether the widget is bright.

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

Parameters
brighttrue if the widget is bright, false if the widget is dark.
local setBright ( local  bright)

Sets whether the widget is bright.

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

Parameters
brighttrue if the widget is bright, false if the widget is dark.
bool isBright ( ) const

Determines if the widget is bright.

Returns
true if the widget is bright, false if the widget is dark.
var isBright ( )

Determines if the widget is bright.

Returns
true if the widget is bright, false if the widget is dark.
local isBright ( )

Determines if the widget is bright.

Returns
true if the widget is bright, false if the widget is dark.
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
enabledTrue if the widget is touch enabled, false if the widget is touch disabled.
var setTouchEnabled ( var  enabled)
virtual

Sets whether the widget is touch enabled.

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

Parameters
enabledTrue if the widget is touch enabled, false if the widget is touch disabled.
local setTouchEnabled ( local  enabled)
virtual

Sets whether the widget is touch enabled.

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

Parameters
enabledTrue if the widget is touch enabled, false if the widget is touch disabled.
void setBrightStyle ( BrightStyle  style)

To set the bright style of widget.

See also
BrightStyle
Parameters
styleBrightStyle::NORMAL means the widget is in normal state, BrightStyle::HIGHLIGHT means the widget is in highlight state.
var setBrightStyle ( var  style)

To set the bright style of widget.

See also
BrightStyle
Parameters
styleBrightStyle::NORMAL means the widget is in normal state, BrightStyle::HIGHLIGHT means the widget is in highlight state.
local setBrightStyle ( local  style)

To set the bright style of widget.

See also
BrightStyle
Parameters
styleBrightStyle::NORMAL means the widget is in normal state, BrightStyle::HIGHLIGHT means the widget is in highlight state.
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.
var isTouchEnabled ( )

Determines if the widget is touch enabled.

Returns
true if the widget is touch enabled, false if the widget is touch disabled.
local isTouchEnabled ( )

Determines if the widget is touch enabled.

Returns
true if the widget is touch enabled, false if the widget is touch disabled.
bool isHighlighted ( ) const

Determines if the widget is highlighted.

Returns
true if the widget is highlighted, false if the widget is not highlighted.
var isHighlighted ( )

Determines if the widget is highlighted.

Returns
true if the widget is highlighted, false if the widget is not highlighted.
local isHighlighted ( )

Determines if the widget is highlighted.

Returns
true if the widget is highlighted, false if the widget is not highlighted.
void setHighlighted ( bool  highlight)

Sets whether the widget is highlighted.

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

Parameters
highlighttrue if the widget is highlighted, false if the widget is not highlighted.
var setHighlighted ( var  highlight)

Sets whether the widget is highlighted.

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

Parameters
highlighttrue if the widget is highlighted, false if the widget is not highlighted.
local setHighlighted ( local  highlight)

Sets whether the widget is highlighted.

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

Parameters
highlighttrue if the widget is highlighted, false if the widget is not highlighted.
float getLeftInParent ( )
inline

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

var getLeftInParent ( )
inline

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

local getLeftInParent ( )
inline

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

float getLeftBoundary ( ) const

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

Returns
The left boundary position of this widget.
var getLeftBoundary ( )

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

Returns
The left boundary position of this widget.
local getLeftBoundary ( )

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

Returns
The left boundary position of this widget.
float getBottomInParent ( )
inline

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

var getBottomInParent ( )
inline

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

local getBottomInParent ( )
inline

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

float getBottomBoundary ( ) const

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

Returns
The bottom boundary position of this widget.
var getBottomBoundary ( )

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

Returns
The bottom boundary position of this widget.
local getBottomBoundary ( )

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

Returns
The bottom boundary position of this widget.
float getRightInParent ( )
inline

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

var getRightInParent ( )
inline

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

local getRightInParent ( )
inline

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

float getRightBoundary ( ) const

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

Returns
The right boundary position of this widget.
var getRightBoundary ( )

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

Returns
The right boundary position of this widget.
local getRightBoundary ( )

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

Returns
The right boundary position of this widget.
float getTopInParent ( )
inline

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

var getTopInParent ( )
inline

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

local getTopInParent ( )
inline

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

float getTopBoundary ( ) const

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

Returns
The top boundary position of this widget.
var getTopBoundary ( )

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

Returns
The top boundary position of this widget.
local getTopBoundary ( )

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

Returns
The top boundary position of this widget.
virtual void visit ( cocos2d::Renderer *  renderer,
const Mat4 parentTransform,
uint32_t  parentFlags 
)
overridevirtual

Visits this node's children and draw them recursively.

Parameters
rendererA given renderer.
parentTransformA transform matrix.
parentFlagsRenderer flag.

Reimplemented from ProtectedNode.

Reimplemented in Layout.

local visit ( local  renderer,
local  parentTransform,
local  parentFlags 
)
overridevirtual

Visits this node's children and draw them recursively.

Parameters
rendererA given renderer.
parentTransformA transform matrix.
parentFlagsRenderer flag.

Reimplemented from ProtectedNode.

Reimplemented in Layout.

void addTouchEventListener ( const ccWidgetTouchCallback callback)

Set a callback to touch vent listener.

Parameters
callbackThe callback in ccWidgetEventCallback.
var addTouchEventListener ( var  callback)

Set a callback to touch vent listener.

Parameters
callbackThe callback in ccWidgetEventCallback.
local addTouchEventListener ( local  callback)

Set a callback to touch vent listener.

Parameters
callbackThe callback in ccWidgetEventCallback.
void addClickEventListener ( const ccWidgetClickCallback callback)

Set a click event handler to the widget.

Parameters
callbackThe callback in ccWidgetClickCallback.
var addClickEventListener ( var  callback)

Set a click event handler to the widget.

Parameters
callbackThe callback in ccWidgetClickCallback.
local addClickEventListener ( local  callback)

Set a click event handler to the widget.

Parameters
callbackThe callback in ccWidgetClickCallback.
virtual void addCCSEventListener ( const ccWidgetEventCallback callback)
virtual

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

Parameters
callbackThe callback in ccWidgetEventCallback.
var addCCSEventListener ( var  callback)
virtual

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

Parameters
callbackThe callback in ccWidgetEventCallback.
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
posThe position (x,y) of the widget in OpenGL coordinates

Reimplemented from Node.

Reimplemented in EditBox.

var setPosition ( var  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
posThe position (x,y) of the widget in OpenGL coordinates

Reimplemented from Node.

Reimplemented in EditBox.

local setPosition ( local  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
posThe 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
percentThe percent (x,y) of the widget in OpenGL coordinates
var setPositionPercent ( var  percent)

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

Parameters
percentThe percent (x,y) of the widget in OpenGL coordinates
local setPositionPercent ( local  percent)

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

Parameters
percentThe percent (x,y) of the widget in OpenGL coordinates
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
var 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
local 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
void setPositionType ( PositionType  type)

Changes the position type of the widget.

See also
PositionType
Parameters
typethe position type of widget
var setPositionType ( var  type)

Changes the position type of the widget.

See also
PositionType
Parameters
typethe position type of widget
local setPositionType ( local  type)

Changes the position type of the widget.

See also
PositionType
Parameters
typethe position type of widget
PositionType getPositionType ( ) const

Gets the position type of the widget.

See also
PositionType
Returns
type the position type of widget
var getPositionType ( )

Gets the position type of the widget.

See also
PositionType
Returns
type the position type of widget
local getPositionType ( )

Gets the position type of the widget.

See also
PositionType
Returns
type the position type of widget
virtual void setFlippedX ( bool  flippedX)
virtual

Sets whether the widget should be flipped horizontally or not.

Parameters
flippedXtrue if the widget should be flipped horizontally, false otherwise.
var setFlippedX ( var  flippedX)
virtual

Sets whether the widget should be flipped horizontally or not.

Parameters
flippedXtrue if the widget should be flipped horizontally, false otherwise.
local setFlippedX ( local  flippedX)
virtual

Sets whether the widget should be flipped horizontally or not.

Parameters
flippedXtrue if the widget should be flipped horizontally, false otherwise.
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 horizontally, false otherwise.
var isFlippedX ( )
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 horizontally, false otherwise.
local isFlippedX ( )
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 horizontally, false otherwise.
virtual void setFlippedY ( bool  flippedY)
virtual

Sets whether the widget should be flipped vertically or not.

Parameters
flippedYtrue if the widget should be flipped vertically, false otherwise.
var setFlippedY ( var  flippedY)
virtual

Sets whether the widget should be flipped vertically or not.

Parameters
flippedYtrue if the widget should be flipped vertically, false otherwise.
local setFlippedY ( local  flippedY)
virtual

Sets whether the widget should be flipped vertically or not.

Parameters
flippedYtrue if the widget should be flipped vertically, 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, false otherwise.
var isFlippedY ( )
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, false otherwise.
local isFlippedY ( )
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, false otherwise.
bool isFlipX ( )
inline
var isFlipX ( )
inline
local isFlipX ( )
inline
void setFlipX ( bool  flipX)
inline
var setFlipX ( var  flipX)
inline
local setFlipX ( local  flipX)
inline
bool isFlipY ( )
inline
var isFlipY ( )
inline
local isFlipY ( )
inline
void setFlipY ( bool  flipY)
inline
var setFlipY ( var  flipY)
inline
local setFlipY ( local  flipY)
inline
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
scaleXThe scale factor on X axis.
Warning
The physics body doesn't support this.

Reimplemented from Node.

var setScaleX ( var  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
scaleXThe scale factor on X axis.
Warning
The physics body doesn't support this.

Reimplemented from Node.

local setScaleX ( local  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
scaleXThe 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
scaleYThe scale factor on Y axis.
Warning
The physics body doesn't support this.

Reimplemented from Node.

var setScaleY ( var  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
scaleYThe scale factor on Y axis.
Warning
The physics body doesn't support this.

Reimplemented from Node.

local setScaleY ( local  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
scaleYThe scale factor on Y axis.
Warning
The physics body doesn't support this.

Reimplemented from Node.

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
scaleThe scale factor for both X and Y axis.
Warning
The physics body doesn't support this.

Reimplemented from Node.

var setScale ( var  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
scaleThe scale factor for both X and Y axis.
Warning
The physics body doesn't support this.

Reimplemented from Node.

local setScale ( local  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
scaleThe 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
scaleXThe scale factor on X axis.
scaleYThe scale factor on Y axis.
Warning
The physics body doesn't support this.

Reimplemented from Node.

var setScale ( var  scaleX,
var  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
scaleXThe scale factor on X axis.
scaleYThe scale factor on Y axis.
Warning
The physics body doesn't support this.

Reimplemented from Node.

local setScale ( local  scaleX,
local  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
scaleXThe scale factor on X axis.
scaleYThe scale factor on Y axis.
Warning
The physics body doesn't support this.

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.

var getScaleX ( )
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.

local getScaleX ( )
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.

var getScaleY ( )
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.

local getScaleY ( )
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.

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.

var getScale ( )
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.

local getScale ( )
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.

bool clippingParentAreaContainPoint ( const Vec2 pt)
inline

Checks a point if in parent's area.

Parameters
ptA point in Vec2.
var clippingParentAreaContainPoint ( var  pt)
inline

Checks a point if in parent's area.

Parameters
ptA point in Vec2.
local
clippingParentAreaContainPoint
( local  pt)
inline

Checks a point if in parent's area.

Parameters
ptA point in Vec2.
bool isClippingParentContainsPoint ( const Vec2 pt)

Checks a point if in parent's area.

Parameters
ptA point in Vec2.
Returns
true if the point is in parent's area, false otherwise.
var isClippingParentContainsPoint ( var  pt)

Checks a point if in parent's area.

Parameters
ptA point in Vec2.
Returns
true if the point is in parent's area, false otherwise.
local isClippingParentContainsPoint ( local  pt)

Checks a point if in parent's area.

Parameters
ptA point in Vec2.
Returns
true if the point is in parent's area, false otherwise.
const Vec2& getTouchStartPos ( ) const
inline

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

var getTouchStartPos ( )
inline

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

local getTouchStartPos ( )
inline

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

const Vec2& getTouchBeganPosition ( ) const

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

Returns
the touch began point.
var getTouchBeganPosition ( )

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

Returns
the touch began point.
local getTouchBeganPosition ( )

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

Returns
the touch began point.
virtual void setSize ( const Size &  size)
virtual

Changes the size that is widget's size.

var setSize ( var  size)
virtual

Changes the size that is widget's size.

local setSize ( local  size)
virtual

Changes the size that is widget's size.

virtual void setContentSize ( const Size &  contentSize)
overridevirtual

Changes the size that is widget's size.

Parameters
contentSizeA content size in Size.

Reimplemented from Node.

Reimplemented in EditBox.

var setContentSize ( var  contentSize)
overridevirtual

Changes the size that is widget's size.

Parameters
contentSizeA content size in Size.

Reimplemented from Node.

Reimplemented in EditBox.

local setContentSize ( local  contentSize)
overridevirtual

Changes the size that is widget's size.

Parameters
contentSizeA content size in Size.

Reimplemented from Node.

Reimplemented in EditBox.

virtual void setSizePercent ( const Vec2 percent)
virtual

Changes the percent that is widget's percent size.

Parameters
percentthat is widget's percent size
var setSizePercent ( var  percent)
virtual

Changes the percent that is widget's percent size.

Parameters
percentthat is widget's percent size
local setSizePercent ( local  percent)
virtual

Changes the percent that is widget's percent size.

Parameters
percentthat is widget's percent size
void setSizeType ( SizeType  type)

Changes the size type of widget.

See also
SizeType
Parameters
typethat is widget's size type
var setSizeType ( var  type)

Changes the size type of widget.

See also
SizeType
Parameters
typethat is widget's size type
local setSizeType ( local  type)

Changes the size type of widget.

See also
SizeType
Parameters
typethat is widget's size type
SizeType getSizeType ( ) const

Gets the size type of widget.

See also
SizeType
var getSizeType ( )

Gets the size type of widget.

See also
SizeType
local getSizeType ( )

Gets the size type of widget.

See also
SizeType
const Size& getSize ( ) const

Get the size of widget.

Returns
Widget content size.
var getSize ( )

Get the size of widget.

Returns
Widget content size.
local getSize ( )

Get the size of widget.

Returns
Widget content size.
const Size& getCustomSize ( ) const

Get the user defined widget size.

Returns
User defined size.
var getCustomSize ( )

Get the user defined widget size.

Returns
User defined size.
local getCustomSize ( )

Get the user defined widget size.

Returns
User defined size.
virtual const Size& getLayoutSize ( )
inlinevirtual

Get the content size of widget.

Warning
This API exists mainly for keeping back compatibility.
Returns
var getLayoutSize ( )
inlinevirtual

Get the content size of widget.

Warning
This API exists mainly for keeping back compatibility.
Returns
local getLayoutSize ( )
inlinevirtual

Get the content size of widget.

Warning
This API exists mainly for keeping back compatibility.
Returns
const Vec2& getSizePercent ( )

Get size percent of widget.

Returns
Percent size.
var getSizePercent ( )

Get size percent of widget.

Returns
Percent size.
local getSizePercent ( )

Get size percent of widget.

Returns
Percent size.
virtual bool hitTest ( const Vec2 pt,
const Camera camera,
Vec3 p 
) const
virtual

Checks a point is in widget's content space.

This function is used for determining touch area of widget.

Parameters
ptThe point in Vec2.
cameraThe camera look at widget, used to convert GL screen point to near/far plane.
pPoint to a Vec3 for store the intersect point, if don't need them set to nullptr.
Returns
true if the point is in widget's content space, false otherwise.

Reimplemented in TextField, and Slider.

var hitTest ( var  pt,
var  camera,
var  p 
)
virtual

Checks a point is in widget's content space.

This function is used for determining touch area of widget.

Parameters
ptThe point in Vec2.
cameraThe camera look at widget, used to convert GL screen point to near/far plane.
pPoint to a Vec3 for store the intersect point, if don't need them set to nullptr.
Returns
true if the point is in widget's content space, false otherwise.

Reimplemented in TextField, and Slider.

local hitTest ( local  pt,
local  camera,
local  p 
)
virtual

Checks a point is in widget's content space.

This function is used for determining touch area of widget.

Parameters
ptThe point in Vec2.
cameraThe camera look at widget, used to convert GL screen point to near/far plane.
pPoint to a Vec3 for store the intersect point, if don't need them set to nullptr.
Returns
true if the point is in widget's content space, false otherwise.

Reimplemented in TextField, and Slider.

virtual bool onTouchBegan ( Touch touch,
Event unusedEvent 
)
virtual

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

Parameters
touchThe touch info.
unusedEventThe touch event info.
Returns
True if user want to handle touches, false otherwise.

Reimplemented in TextField, ScrollView, and Slider.

var onTouchBegan ( var  touch,
var  unusedEvent 
)
virtual

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

Parameters
touchThe touch info.
unusedEventThe touch event info.
Returns
True if user want to handle touches, false otherwise.

Reimplemented in TextField, ScrollView, and Slider.

local onTouchBegan ( local  touch,
local  unusedEvent 
)
virtual

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

Parameters
touchThe touch info.
unusedEventThe touch event info.
Returns
True if user want to handle touches, false otherwise.

Reimplemented in TextField, ScrollView, and Slider.

virtual void onTouchMoved ( Touch touch,
Event unusedEvent 
)
virtual

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

Parameters
touchThe touch info.
unusedEventThe touch event info.

Reimplemented in ScrollView, and Slider.

var onTouchMoved ( var  touch,
var  unusedEvent 
)
virtual

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

Parameters
touchThe touch info.
unusedEventThe touch event info.

Reimplemented in ScrollView, and Slider.

local onTouchMoved ( local  touch,
local  unusedEvent 
)
virtual

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

Parameters
touchThe touch info.
unusedEventThe touch event info.

Reimplemented in ScrollView, and Slider.

virtual void onTouchEnded ( Touch touch,
Event unusedEvent 
)
virtual

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

Parameters
touchThe touch info.
unusedEventThe touch event info.

Reimplemented in ScrollView, Slider, and CheckBox.

var onTouchEnded ( var  touch,
var  unusedEvent 
)
virtual

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

Parameters
touchThe touch info.
unusedEventThe touch event info.

Reimplemented in ScrollView, Slider, and CheckBox.

local onTouchEnded ( local  touch,
local  unusedEvent 
)
virtual

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

Parameters
touchThe touch info.
unusedEventThe touch event info.

Reimplemented in ScrollView, Slider, and CheckBox.

virtual void onTouchCancelled ( Touch touch,
Event unusedEvent 
)
virtual

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

Parameters
touchThe touch info.
unusedEventThe touch event info.

Reimplemented in ScrollView, and Slider.

var onTouchCancelled ( var  touch,
var  unusedEvent 
)
virtual

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

Parameters
touchThe touch info.
unusedEventThe touch event info.

Reimplemented in ScrollView, and Slider.

local onTouchCancelled ( local  touch,
local  unusedEvent 
)
virtual

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

Parameters
touchThe touch info.
unusedEventThe touch event info.

Reimplemented in ScrollView, and Slider.

void setLayoutParameter ( LayoutParameter parameter)

Sets a LayoutParameter to widget.

See also
LayoutParameter
Parameters
parameterLayoutParameter pointer
var setLayoutParameter ( var  parameter)

Sets a LayoutParameter to widget.

See also
LayoutParameter
Parameters
parameterLayoutParameter pointer
local setLayoutParameter ( local  parameter)

Sets a LayoutParameter to widget.

See also
LayoutParameter
Parameters
parameterLayoutParameter pointer
LayoutParameter* getLayoutParameter ( ) const
overridevirtual

Gets LayoutParameter of widget.

See also
LayoutParameter
Returns
LayoutParameter

Implements LayoutParameterProtocol.

var getLayoutParameter ( )
overridevirtual

Gets LayoutParameter of widget.

See also
LayoutParameter
Returns
LayoutParameter

Implements LayoutParameterProtocol.

local getLayoutParameter ( )
overridevirtual

Gets LayoutParameter of widget.

See also
LayoutParameter
Returns
LayoutParameter

Implements LayoutParameterProtocol.

LayoutParameter* getLayoutParameter ( LayoutParameter::Type  type)

Gets LayoutParameter of widget.

See also
LayoutParameter
var getLayoutParameter ( var  type)

Gets LayoutParameter of widget.

See also
LayoutParameter
local getLayoutParameter ( local  type)

Gets LayoutParameter of widget.

See also
LayoutParameter
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
ignoreset member variable _ignoreSize to ignore

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

var ignoreContentAdaptWithSize ( var  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
ignoreset member variable _ignoreSize to ignore

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

local ignoreContentAdaptWithSize ( local  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
ignoreset member variable _ignoreSize to ignore

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

bool isIgnoreContentAdaptWithSize ( ) const

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

Returns
True means ignore user defined content size, false otherwise.
var isIgnoreContentAdaptWithSize ( )

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

Returns
True means ignore user defined content size, false otherwise.
local isIgnoreContentAdaptWithSize ( )

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

Returns
True means ignore user defined content size, false otherwise.
Vec2 getWorldPosition ( ) const

Gets position of widget in world space.

Returns
Position of widget in world space.
var getWorldPosition ( )

Gets position of widget in world space.

Returns
Position of widget in world space.
local getWorldPosition ( )

Gets position of widget in world space.

Returns
Position of widget in world space.
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, Slider, Button, Text, LoadingBar, ImageView, TextAtlas, AbstractCheckButton, and TextBMFont.

var 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, Slider, Button, Text, LoadingBar, ImageView, TextAtlas, AbstractCheckButton, and TextBMFont.

local 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, Slider, Button, Text, LoadingBar, ImageView, TextAtlas, AbstractCheckButton, and TextBMFont.

virtual Size getVirtualRendererSize ( ) const
virtual

Get the virtual renderer's size.

Returns
Widget virtual renderer size.

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

var getVirtualRendererSize ( )
virtual

Get the virtual renderer's size.

Returns
Widget virtual renderer size.

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

local getVirtualRendererSize ( )
virtual

Get the virtual renderer's size.

Returns
Widget virtual renderer size.

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

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, ScrollView, EditBox, RichText, ListView, Layout, RadioButtonGroup, PageView, Slider, Text, Button, LoadingBar, CheckBox, ImageView, TextAtlas, RadioButton, and TextBMFont.

var getDescription ( )
overridevirtual

Returns the string representation of widget class name.

Returns
get the class description.

Reimplemented from Node.

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

local getDescription ( )
overridevirtual

Returns the string representation of widget class name.

Returns
get the class description.

Reimplemented from Node.

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

Widget* clone ( )

Create a new widget copy of the original one.

Returns
A cloned widget copy of original.
var clone ( )

Create a new widget copy of the original one.

Returns
A cloned widget copy of original.
local clone ( )

Create a new widget copy of the original one.

Returns
A cloned widget copy of original.
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, ScrollView, EditBox, Layout, WebView, and VideoPlayer.

var 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, ScrollView, EditBox, Layout, WebView, and VideoPlayer.

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 ScrollView, EditBox, Layout, WebView, and VideoPlayer.

var 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 ScrollView, EditBox, Layout, WebView, and VideoPlayer.

void updateSizeAndPosition ( )

Update all children's contents size and position recursively.

See also
updateSizeAndPosition(const Size&)
var updateSizeAndPosition ( )

Update all children's contents size and position recursively.

See also
updateSizeAndPosition(const Size&)
local updateSizeAndPosition ( )

Update all children's contents size and position recursively.

See also
updateSizeAndPosition(const Size&)
void setActionTag ( int  tag)

Set the tag of action.

Parameters
tagA integer tag value.
var setActionTag ( var  tag)

Set the tag of action.

Parameters
tagA integer tag value.
local setActionTag ( local  tag)

Set the tag of action.

Parameters
tagA integer tag value.
int getActionTag ( ) const

Get the action tag.

Returns
Action tag.
var getActionTag ( )

Get the action tag.

Returns
Action tag.
local getActionTag ( )

Get the action tag.

Returns
Action tag.
void setPropagateTouchEvents ( bool  isPropagate)

Allow widget touch events to propagate to its parents.

Set false will disable propagation

Parameters
isPropagateTrue to allow propagation, false otherwise.
Since
v3.3
var setPropagateTouchEvents ( var  isPropagate)

Allow widget touch events to propagate to its parents.

Set false will disable propagation

Parameters
isPropagateTrue to allow propagation, false otherwise.
Since
v3.3
local setPropagateTouchEvents ( local  isPropagate)

Allow widget touch events to propagate to its parents.

Set false will disable propagation

Parameters
isPropagateTrue to allow propagation, false otherwise.
Since
v3.3
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
var isPropagateTouchEvents ( )

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
local isPropagateTouchEvents ( )

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
void setSwallowTouches ( bool  swallow)

Toggle widget swallow touch option.

Specify widget to swallow touches or not

Parameters
swallowTrue to swallow touch, false otherwise.
Since
v3.3
var setSwallowTouches ( var  swallow)

Toggle widget swallow touch option.

Specify widget to swallow touches or not

Parameters
swallowTrue to swallow touch, false otherwise.
Since
v3.3
local setSwallowTouches ( local  swallow)

Toggle widget swallow touch option.

Specify widget to swallow touches or not

Parameters
swallowTrue to swallow touch, false otherwise.
Since
v3.3
bool isSwallowTouches ( ) const

Return whether the widget is swallowing touch or not.

Returns
Whether touch is swallowed.
Since
v3.3
var isSwallowTouches ( )

Return whether the widget is swallowing touch or not.

Returns
Whether touch is swallowed.
Since
v3.3
local isSwallowTouches ( )

Return whether the widget is swallowing touch or not.

Returns
Whether touch is swallowed.
Since
v3.3
bool isFocused ( ) const

Query whether widget is focused or not.

Returns
whether the widget is focused or not
var isFocused ( )

Query whether widget is focused or not.

Returns
whether the widget is focused or not
local isFocused ( )

Query whether widget is focused or not.

Returns
whether the widget is focused or not
void setFocused ( bool  focus)

Toggle widget focus status.

Parameters
focuspass true to let the widget get focus or pass false to let the widget lose focus
var setFocused ( var  focus)

Toggle widget focus status.

Parameters
focuspass true to let the widget get focus or pass false to let the widget lose focus
local setFocused ( local  focus)

Toggle widget focus status.

Parameters
focuspass true to let the widget get focus or pass false to let the widget lose focus
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
var isFocusEnabled ( )

Query widget's focus enable state.

Returns
true represent the widget could accept focus, false represent the widget couldn't accept focus
local isFocusEnabled ( )

Query widget's focus enable state.

Returns
true represent the widget could accept focus, false represent the widget couldn't accept focus
void setFocusEnabled ( bool  enable)

Allow widget to accept focus.

Parameters
enablepass true/false to enable/disable the focus ability of a widget
var setFocusEnabled ( var  enable)

Allow widget to accept focus.

Parameters
enablepass true/false to enable/disable the focus ability of a widget
local setFocusEnabled ( local  enable)

Allow widget to accept focus.

Parameters
enablepass true/false to enable/disable the focus ability of a widget
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
directionthe direction to look for the next focused widget in a layout
currentthe current focused widget
Returns
the next focused widget in a layout

Reimplemented in ScrollView, and Layout.

var findNextFocusedWidget ( var  direction,
var  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
directionthe direction to look for the next focused widget in a layout
currentthe current focused widget
Returns
the next focused widget in a layout

Reimplemented in ScrollView, and Layout.

local findNextFocusedWidget ( local  direction,
local  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
directionthe direction to look for the next focused widget in a layout
currentthe current focused widget
Returns
the next focused widget in a layout

Reimplemented in ScrollView, and Layout.

Widget* getCurrentFocusedWidget ( bool  isWidget)

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
isWidgetif your set isWidget to true, it will return the _realFocusedWidget which is always a widget otherwise, it will return a widget or a layout.
var getCurrentFocusedWidget ( var  isWidget)

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
isWidgetif your set isWidget to true, it will return the _realFocusedWidget which is always a widget otherwise, it will return a widget or a layout.
local getCurrentFocusedWidget ( local  isWidget)

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
isWidgetif your set isWidget to true, it will return the _realFocusedWidget which is always a widget otherwise, it will return a widget or a layout.
static Widget*
getCurrentFocusedWidget
( )
static

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.

var getCurrentFocusedWidget ( )
static

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.

local getCurrentFocusedWidget ( )
static

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.

void setUnifySizeEnabled ( bool  enable)

Toggle use unify size.

Parameters
enableTrue to use unify size, false otherwise.
var setUnifySizeEnabled ( var  enable)

Toggle use unify size.

Parameters
enableTrue to use unify size, false otherwise.
local setUnifySizeEnabled ( local  enable)

Toggle use unify size.

Parameters
enableTrue to use unify size, false otherwise.
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
var isUnifySizeEnabled ( )

Query whether unify size enable state.

Returns
true represent the widget use Unify Size, false represent the widget couldn't use Unify Size
local isUnifySizeEnabled ( )

Query whether unify size enable state.

Returns
true represent the widget use Unify Size, false represent the widget couldn't use Unify Size
void setCallbackName ( const std::string &  callbackName)
inline

Set callback name.

Parameters
callbackNameA string representation of callback name.
var setCallbackName ( var  callbackName)
inline

Set callback name.

Parameters
callbackNameA string representation of callback name.
local setCallbackName ( local  callbackName)
inline

Set callback name.

Parameters
callbackNameA string representation of callback name.
const std::string& getCallbackName ( ) const
inline

Query callback name.

Returns
The callback name.
var getCallbackName ( )
inline

Query callback name.

Returns
The callback name.
local getCallbackName ( )
inline

Query callback name.

Returns
The callback name.
void setCallbackType ( const std::string &  callbackType)
inline

Set callback type.

Parameters
callbackTypeA string representation of callback type.
var setCallbackType ( var  callbackType)
inline

Set callback type.

Parameters
callbackTypeA string representation of callback type.
local setCallbackType ( local  callbackType)
inline

Set callback type.

Parameters
callbackTypeA string representation of callback type.
const std::string& getCallbackType ( ) const
inline

Query callback type.

Returns
Callback type string.
var getCallbackType ( )
inline

Query callback type.

Returns
Callback type string.
local getCallbackType ( )
inline

Query callback type.

Returns
Callback type string.
void setLayoutComponentEnabled ( bool  enable)

Toggle layout component enable.

Parameters
enableLayout Component of a widget
var setLayoutComponentEnabled ( var  enable)

Toggle layout component enable.

Parameters
enableLayout Component of a widget
local setLayoutComponentEnabled ( local  enable)

Toggle layout component enable.

Parameters
enableLayout Component of a widget
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.
var isLayoutComponentEnabled ( )

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.
local isLayoutComponentEnabled ( )

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.
void onFocusChange ( Widget widgetLostFocus,
Widget widgetGetFocus 
)
protected

This method is called when a focus change event happens.

Parameters
widgetLostFocusThe widget which lose its focus
widgetGetFocusThe widget which get its focus
var onFocusChange ( var  widgetLostFocus,
var  widgetGetFocus 
)
protected

This method is called when a focus change event happens.

Parameters
widgetLostFocusThe widget which lose its focus
widgetGetFocusThe widget which get its focus
local onFocusChange ( local  widgetLostFocus,
local  widgetGetFocus 
)
protected

This method is called when a focus change event happens.

Parameters
widgetLostFocusThe widget which lose its focus
widgetGetFocusThe widget which get its focus
void dispatchFocusEvent ( Widget widgetLoseFocus,
Widget widgetGetFocus 
)
protected

Dispatch a EventFocus through a EventDispatcher.

Parameters
widgetLoseFocusThe widget which lose its focus
widgetGetFocushe widget which get its focus
var dispatchFocusEvent ( var  widgetLoseFocus,
var  widgetGetFocus 
)
protected

Dispatch a EventFocus through a EventDispatcher.

Parameters
widgetLoseFocusThe widget which lose its focus
widgetGetFocushe widget which get its focus
local dispatchFocusEvent ( local  widgetLoseFocus,
local  widgetGetFocus 
)
protected

Dispatch a EventFocus through a EventDispatcher.

Parameters
widgetLoseFocusThe widget which lose its focus
widgetGetFocushe widget which get its focus

Member Data Documentation

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;

var 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;

local 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;


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