ListView Class Reference

ListView is a view group that displays a list of scrollable items. More...

Inherits ScrollView.

Inherited by PageView.

Public Types
enum	Gravity
	Gravity for docking elements in ListView.
enum	EventType
	ListView element item click event.
enum	MagneticType
	ListView supports magnetic scroll. More...
typedef std::function< void(Ref *, EventType)>	ccListViewCallback
	ListView item click callback.
Public Types inherited from ScrollView
enum	Direction
	ScrollView scroll direction type.
enum	EventType
	Scrollview scroll event type.
typedef std::function< void(Ref *, EventType)>	ccScrollViewCallback
	A callback which would be called when a ScrollView is scrolling.
Public Types inherited from Layout
enum	Type
	Layout type, default is ABSOLUTE.
enum	ClippingType
	Clipping Type, default is STENCIL.
enum	BackGroundColorType
	Background color type, default is NONE.
Public Types inherited from Widget
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
	ListView ()
	Default constructor. More...
	new ()
	Default constructor. More...
virtual	~ListView ()
	Default destructor. More...
void	setItemModel (Widget *model)
	Set an item model for listview. More...
var	setItemModel ( var model)
	Set an item model for listview. More...
local	setItemModel ( local model)
	Set an item model for listview. More...
void	pushBackDefaultItem ()
	Insert a default item(create by a cloned model) at the end of the listview.
void	insertDefaultItem (ssize_t index)
	Insert a default item(create by cloning model) into listview at a give index. More...
void	pushBackCustomItem (Widget *item)
	Insert a custom item into the end of ListView. More...
local	pushBackCustomItem ( local item)
	Insert a custom item into the end of ListView. More...
void	insertCustomItem (Widget *item, ssize_t index)
	Insert a custom widget into ListView at a given index. More...
var	insertCustomItem ( var item, var index)
	Insert a custom widget into ListView at a given index. More...
local	insertCustomItem ( local item, local index)
	Insert a custom widget into ListView at a given index. More...
void	removeLastItem ()
	Removes the last item of ListView.
local	removeLastItem ()
	Removes the last item of ListView.
void	removeItem (ssize_t index)
	Remove an item at given index. More...
var	removeItem ( var index)
	Remove an item at given index. More...
local	removeItem ( local index)
	Remove an item at given index. More...
void	removeAllItems ()
	Remove all items in current ListView.
local	removeAllItems ()
	Remove all items in current ListView.
Widget *	getItem (ssize_t index) const
	Return an item at a given index. More...
var	getItem ( var index)
	Return an item at a given index. More...
local	getItem ( local index)
	Return an item at a given index. More...
Vector< Widget * > &	getItems ()
	Return all items in a ListView. More...
var	getItems ()
	Return all items in a ListView. More...
local	getItems ()
	Return all items in a ListView. More...
ssize_t	getIndex (Widget *item) const
	Return the index of specified widget. More...
var	getIndex ( var item)
	Return the index of specified widget. More...
local	getIndex ( local item)
	Return the index of specified widget. More...
void	setGravity (Gravity gravity)
	Set the gravity of ListView. More...
void	setMagneticType (MagneticType magneticType)
	Set magnetic type of ListView. More...
MagneticType	getMagneticType () const
	Get magnetic type of ListView.
local	getMagneticType ()
	Get magnetic type of ListView.
void	setMagneticAllowedOutOfBoundary (bool magneticAllowedOutOfBoundary)
	Set magnetic allowed out of boundary.
var	setMagneticAllowedOutOfBoundary ( var magneticAllowedOutOfBoundary)
	Set magnetic allowed out of boundary.
local	setMagneticAllowedOutOfBoundary ( local magneticAllowedOutOfBoundary)
	Set magnetic allowed out of boundary.
bool	getMagneticAllowedOutOfBoundary () const
	Query whether the magnetic out of boundary is allowed.
void	setItemsMargin (float margin)
	Set the margin between each item in ListView. More...
var	setItemsMargin ( var margin)
	Set the margin between each item in ListView. More...
local	setItemsMargin ( local margin)
	Set the margin between each item in ListView. More...
float	getItemsMargin () const
	Query margin between each item in ListView. More...
var	getItemsMargin ()
	Query margin between each item in ListView. More...
local	getItemsMargin ()
	Query margin between each item in ListView. More...
void	setPadding (float l, float t, float r, float b)
	Change padding with left, top, right, and bottom padding. More...
var	setPadding ( var l, var t, var r, var b)
	Change padding with left, top, right, and bottom padding. More...
local	setPadding ( local l, local t, local r, local b)
	Change padding with left, top, right, and bottom padding. More...
void	setLeftPadding (float l)
	Change padding with left padding. More...
local	setLeftPadding ( local l)
	Change padding with left padding. More...
void	setTopPadding (float t)
	Change padding with top padding. More...
var	setTopPadding ( var t)
	Change padding with top padding. More...
local	setTopPadding ( local t)
	Change padding with top padding. More...
void	setRightPadding (float r)
	Change padding with right padding. More...
var	setRightPadding ( var r)
	Change padding with right padding. More...
local	setRightPadding ( local r)
	Change padding with right padding. More...
void	setBottomPadding (float b)
	Change padding with bottom padding. More...
var	setBottomPadding ( var b)
	Change padding with bottom padding. More...
local	setBottomPadding ( local b)
	Change padding with bottom padding. More...
float	getLeftPadding () const
	Get the left padding in ListView. More...
float	getTopPadding () const
	Get the top padding in ListView. More...
var	getTopPadding ()
	Get the top padding in ListView. More...
local	getTopPadding ()
	Get the top padding in ListView. More...
float	getRightPadding () const
	Get the right padding in ListView. More...
var	getRightPadding ()
	Get the right padding in ListView. More...
local	getRightPadding ()
	Get the right padding in ListView. More...
float	getBottomPadding () const
	Get the bottom padding in ListView. More...
var	getBottomPadding ()
	Get the bottom padding in ListView. More...
local	getBottomPadding ()
	Get the bottom padding in ListView. More...
void	setScrollDuration (float time)
	Set the time in seconds to scroll between items. More...
float	getScrollDuration () const
	Get the time in seconds to scroll between items. More...
virtual void	requestDoLayout () override
	request to refresh widget layout
var	requestDoLayout ()
	request to refresh widget layout
local	requestDoLayout ()
	request to refresh widget layout
virtual void	addChild (Node *child) override
	Adds a child to the container with z-order as 0. More...
local	addChild ( local child)
	Adds a child to the container with z-order as 0. More...
virtual void	addChild (Node *child, int localZOrder) override
	Adds a child to the container with a local z-order. More...
virtual void	addChild (Node *child, int zOrder, int tag) override
	Adds a child to the container with z order and tag. More...
local	addChild ( local child, local zOrder, local tag)
	Adds a child to the container with z order and tag. More...
virtual void	addChild (Node *child, int zOrder, const std::string &name) override
	Adds a child to the container with z order and tag. More...
local	addChild ( local child, local zOrder, local name)
	Adds a child to the container with z order and tag. More...
virtual void	removeAllChildren () override
	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) override
	Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter. More...
local	removeAllChildrenWithCleanup ( local cleanup)
	Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter. More...
virtual void	removeChild (Node *child, bool cleanup=true) override
	Removes a child from the container. More...
local	removeChild ( local child, local true)
	Removes a child from the container. More...
Widget *	getClosestItemToPosition (const Vec2 &targetPosition, const Vec2 &itemAnchorPoint) const
	Query the closest item to a specific position in inner container. More...
local	getClosestItemToPosition ( local targetPosition, local itemAnchorPoint)
	Query the closest item to a specific position in inner container. More...
Widget *	getClosestItemToPositionInCurrentView (const Vec2 &positionRatioInView, const Vec2 &itemAnchorPoint) const
	Query the closest item to a specific position in current view. More...
Widget *	getCenterItemInCurrentView () const
	Query the center item. More...
Widget *	getLeftmostItemInCurrentView () const
	Query the leftmost item in horizontal list. More...
var	getLeftmostItemInCurrentView ()
	Query the leftmost item in horizontal list. More...
local	getLeftmostItemInCurrentView ()
	Query the leftmost item in horizontal list. More...
Widget *	getRightmostItemInCurrentView () const
	Query the rightmost item in horizontal list. More...
var	getRightmostItemInCurrentView ()
	Query the rightmost item in horizontal list. More...
local	getRightmostItemInCurrentView ()
	Query the rightmost item in horizontal list. More...
Widget *	getTopmostItemInCurrentView () const
	Query the topmost item in horizontal list. More...
var	getTopmostItemInCurrentView ()
	Query the topmost item in horizontal list. More...
local	getTopmostItemInCurrentView ()
	Query the topmost item in horizontal list. More...
Widget *	getBottommostItemInCurrentView () const
	Query the bottommost item in horizontal list. More...
var	getBottommostItemInCurrentView ()
	Query the bottommost item in horizontal list. More...
local	getBottommostItemInCurrentView ()
	Query the bottommost item in horizontal list. More...
virtual void	jumpToBottom () override
	Override functions.
var	jumpToBottom ()
	Override functions.
local	jumpToBottom ()
	Override functions.
virtual void	jumpToTop () override
	Move inner container to top boundary of scrollview.
var	jumpToTop ()
	Move inner container to top boundary of scrollview.
local	jumpToTop ()
	Move inner container to top boundary of scrollview.
virtual void	jumpToLeft () override
	Move inner container to left boundary of scrollview.
local	jumpToLeft ()
	Move inner container to left boundary of scrollview.
virtual void	jumpToRight () override
	Move inner container to right boundary of scrollview.
var	jumpToRight ()
	Move inner container to right boundary of scrollview.
local	jumpToRight ()
	Move inner container to right boundary of scrollview.
virtual void	jumpToTopLeft () override
	Move inner container to top and left boundary of scrollview.
var	jumpToTopLeft ()
	Move inner container to top and left boundary of scrollview.
local	jumpToTopLeft ()
	Move inner container to top and left boundary of scrollview.
virtual void	jumpToTopRight () override
	Move inner container to top and right boundary of scrollview.
var	jumpToTopRight ()
	Move inner container to top and right boundary of scrollview.
local	jumpToTopRight ()
	Move inner container to top and right boundary of scrollview.
virtual void	jumpToBottomLeft () override
	Move inner container to bottom and left boundary of scrollview.
local	jumpToBottomLeft ()
	Move inner container to bottom and left boundary of scrollview.
virtual void	jumpToBottomRight () override
	Move inner container to bottom and right boundary of scrollview.
var	jumpToBottomRight ()
	Move inner container to bottom and right boundary of scrollview.
local	jumpToBottomRight ()
	Move inner container to bottom and right boundary of scrollview.
virtual void	jumpToPercentVertical (float percent) override
	Move inner container to vertical percent position of scrollview. More...
local	jumpToPercentVertical ( local percent)
	Move inner container to vertical percent position of scrollview. More...
virtual void	jumpToPercentHorizontal (float percent) override
	Move inner container to horizontal percent position of scrollview. More...
var	jumpToPercentHorizontal ( var percent)
	Move inner container to horizontal percent position of scrollview. More...
local	jumpToPercentHorizontal ( local percent)
	Move inner container to horizontal percent position of scrollview. More...
virtual void	jumpToPercentBothDirection (const Vec2 &percent) override
	Move inner container to both direction percent position of scrollview. More...
var	jumpToPercentBothDirection ( var percent)
	Move inner container to both direction percent position of scrollview. More...
local	jumpToPercentBothDirection ( local percent)
	Move inner container to both direction percent position of scrollview. More...
void	jumpToItem (ssize_t itemIndex, const Vec2 &positionRatioInView, const Vec2 &itemAnchorPoint)
	Jump to specific item. More...
void	scrollToItem (ssize_t itemIndex, const Vec2 &positionRatioInView, const Vec2 &itemAnchorPoint)
	Scroll to specific item. More...
ssize_t	getCurSelectedIndex () const
	Query current selected widget's index. More...
var	getCurSelectedIndex ()
	Query current selected widget's index. More...
local	getCurSelectedIndex ()
	Query current selected widget's index. More...
void	setCurSelectedIndex (int itemIndex)
	Set current selected widget's index and call TouchEventType::ENDED event. More...
void	addEventListenerListView (Ref *target, SEL_ListViewEvent selector)
	Add an event click callback to ListView, then one item of Listview is clicked, the callback will be called. More...
var	addEventListenerListView ( var target, var selector)
	Add an event click callback to ListView, then one item of Listview is clicked, the callback will be called. More...
local	addEventListenerListView ( local target, local selector)
	Add an event click callback to ListView, then one item of Listview is clicked, the callback will be called. More...
void	addEventListener (const ccListViewCallback &callback)
	Add an event click callback to ListView, then one item of Listview is clicked, the callback will be called. More...
virtual void	setDirection (Direction dir) override
	Changes scroll direction of scrollview. More...
virtual std::string	getDescription () const override
	Return the "class name" of widget.
local	getDescription ()
	Return the "class name" of widget.
void	requestRefreshView ()
	Refresh view and layout of ListView manually. More...
var	requestRefreshView ()
	Refresh view and layout of ListView manually. More...
local	requestRefreshView ()
	Refresh view and layout of ListView manually. More...
void	refreshView ()
	Refresh content view of ListView. More...
Public Member Functions inherited from ScrollView
	ScrollView ()
	Default constructor. More...
	ctor ()
	Default constructor. More...
	new ()
	Default constructor. More...
virtual	~ScrollView ()
	Default destructor. More...
Direction	getDirection () const
	Query scroll direction of scrollview. More...
Layout *	getInnerContainer () const
	Get inner container of scrollview. More...
virtual void	stopScroll ()
	Immediately stops inner container scroll (auto scrolling is not affected).
virtual void	stopAutoScroll ()
	Immediately stops inner container scroll initiated by any of the "scrollTo*" member functions.
var	stopAutoScroll ()
	Immediately stops inner container scroll initiated by any of the "scrollTo*" member functions.
local	stopAutoScroll ()
	Immediately stops inner container scroll initiated by any of the "scrollTo*" member functions.
virtual void	stopOverallScroll ()
	Immediately stops inner container scroll if any.
local	stopOverallScroll ()
	Immediately stops inner container scroll if any.
virtual void	scrollToBottom (float timeInSec, bool attenuated)
	Scroll inner container to bottom boundary of scrollview. More...
var	scrollToBottom ( var timeInSec, var attenuated)
	Scroll inner container to bottom boundary of scrollview. More...
local	scrollToBottom ( local timeInSec, local attenuated)
	Scroll inner container to bottom boundary of scrollview. More...
virtual void	scrollToTop (float timeInSec, bool attenuated)
	Scroll inner container to top boundary of scrollview. More...
virtual void	scrollToLeft (float timeInSec, bool attenuated)
	Scroll inner container to left boundary of scrollview. More...
virtual void	scrollToRight (float timeInSec, bool attenuated)
	Scroll inner container to right boundary of scrollview. More...
var	scrollToRight ( var timeInSec, var attenuated)
	Scroll inner container to right boundary of scrollview. More...
local	scrollToRight ( local timeInSec, local attenuated)
	Scroll inner container to right boundary of scrollview. More...
virtual void	scrollToTopLeft (float timeInSec, bool attenuated)
	Scroll inner container to top and left boundary of scrollview. More...
var	scrollToTopLeft ( var timeInSec, var attenuated)
	Scroll inner container to top and left boundary of scrollview. More...
local	scrollToTopLeft ( local timeInSec, local attenuated)
	Scroll inner container to top and left boundary of scrollview. More...
virtual void	scrollToTopRight (float timeInSec, bool attenuated)
	Scroll inner container to top and right boundary of scrollview. More...
var	scrollToTopRight ( var timeInSec, var attenuated)
	Scroll inner container to top and right boundary of scrollview. More...
local	scrollToTopRight ( local timeInSec, local attenuated)
	Scroll inner container to top and right boundary of scrollview. More...
virtual void	scrollToBottomLeft (float timeInSec, bool attenuated)
	Scroll inner container to bottom and left boundary of scrollview. More...
var	scrollToBottomLeft ( var timeInSec, var attenuated)
	Scroll inner container to bottom and left boundary of scrollview. More...
local	scrollToBottomLeft ( local timeInSec, local attenuated)
	Scroll inner container to bottom and left boundary of scrollview. More...
virtual void	scrollToBottomRight (float timeInSec, bool attenuated)
	Scroll inner container to bottom and right boundary of scrollview. More...
virtual void	scrollToPercentVertical (float percent, float timeInSec, bool attenuated)
	Scroll inner container to vertical percent position of scrollview. More...
local	scrollToPercentVertical ( local percent, local timeInSec, local attenuated)
	Scroll inner container to vertical percent position of scrollview. More...
virtual void	scrollToPercentHorizontal (float percent, float timeInSec, bool attenuated)
	Scroll inner container to horizontal percent position of scrollview. More...
virtual void	scrollToPercentBothDirection (const Vec2 &percent, float timeInSec, bool attenuated)
	Scroll inner container to both direction percent position of scrollview. More...
float	getScrolledPercentVertical () const
float	getScrolledPercentHorizontal () const
Vec2	getScrolledPercentBothDirection () const
void	setInnerContainerSize (const Size &size)
	Change inner container size of scrollview. More...
const Size &	getInnerContainerSize () const
	Get inner container size of scrollview. More...
var	getInnerContainerSize ()
	Get inner container size of scrollview. More...
local	getInnerContainerSize ()
	Get inner container size of scrollview. More...
void	setInnerContainerPosition (const Vec2 &pos)
	Set inner container position. More...
var	setInnerContainerPosition ( var pos)
	Set inner container position. More...
local	setInnerContainerPosition ( local pos)
	Set inner container position. More...
const Vec2 &	getInnerContainerPosition () const
	Get inner container position. More...
void	addEventListenerScrollView (Ref *target, SEL_ScrollViewEvent selector)
	Add callback function which will be called when scrollview event triggered. More...
var	addEventListenerScrollView ( var target, var selector)
	Add callback function which will be called when scrollview event triggered. More...
local	addEventListenerScrollView ( local target, local selector)
	Add callback function which will be called when scrollview event triggered. More...
virtual Vector< Node * > &	getChildren () override
	Returns the array of the node's children. More...
local	getChildren ()
	Returns the array of the node's children. More...
virtual ssize_t	getChildrenCount () const override
	Returns the amount of children. More...
local	getChildrenCount ()
	Returns the amount of children. More...
virtual Node *	getChildByTag (int tag) const override
	Gets a child from the container with its tag. More...
var	getChildByTag ( var tag)
	Gets a child from the container with its tag. More...
local	getChildByTag ( local tag)
	Gets a child from the container with its tag. More...
virtual Node *	getChildByName (const std::string &name) const override
	Gets a child from the container with its name. More...
var	getChildByName ( var name)
	Gets a child from the container with its name. More...
local	getChildByName ( local name)
	Gets a child from the container with its name. More...
virtual bool	onTouchBegan (Touch *touch, Event *unusedEvent) override
	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) override
	A callback which will be called when touch moved event is issued. More...
local	onTouchMoved ( local touch, local unusedEvent)
	A callback which will be called when touch moved event is issued. More...
virtual void	onTouchEnded (Touch *touch, Event *unusedEvent) override
	A callback which will be called when touch ended event is issued. More...
var	onTouchEnded ( var touch, var 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) override
	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...
virtual void	update (float dt) override
	Update method will be called automatically every frame if "scheduleUpdate" is called, and the node is "live". More...
var	update ( var dt)
	Update method will be called automatically every frame if "scheduleUpdate" is called, and the node is "live". More...
local	update ( local dt)
	Update method will be called automatically every frame if "scheduleUpdate" is called, and the node is "live". More...
void	setBounceEnabled (bool enabled)
	Toggle bounce enabled when scroll to the edge. More...
var	setBounceEnabled ( var enabled)
	Toggle bounce enabled when scroll to the edge. More...
local	setBounceEnabled ( local enabled)
	Toggle bounce enabled when scroll to the edge. More...
bool	isBounceEnabled () const
	Query bounce state. More...
var	isBounceEnabled ()
	Query bounce state. More...
local	isBounceEnabled ()
	Query bounce state. More...
void	setInertiaScrollEnabled (bool enabled)
	Toggle whether enable scroll inertia while scrolling. More...
var	setInertiaScrollEnabled ( var enabled)
	Toggle whether enable scroll inertia while scrolling. More...
local	setInertiaScrollEnabled ( local enabled)
	Toggle whether enable scroll inertia while scrolling. More...
bool	isInertiaScrollEnabled () const
	Query inertia scroll state. More...
void	setScrollBarEnabled (bool enabled)
	Toggle scroll bar enabled. More...
var	setScrollBarEnabled ( var enabled)
	Toggle scroll bar enabled. More...
local	setScrollBarEnabled ( local enabled)
	Toggle scroll bar enabled. More...
bool	isScrollBarEnabled () const
	Query scroll bar state. More...
void	setScrollBarPositionFromCorner (const Vec2 &positionFromCorner)
	Set the scroll bar positions from the left-bottom corner (horizontal) and right-top corner (vertical). More...
void	setScrollBarPositionFromCornerForVertical (const Vec2 &positionFromCorner)
	Set the vertical scroll bar position from right-top corner. More...
Vec2	getScrollBarPositionFromCornerForVertical () const
	Get the vertical scroll bar's position from right-top corner. More...
void	setScrollBarPositionFromCornerForHorizontal (const Vec2 &positionFromCorner)
	Set the horizontal scroll bar position from left-bottom corner. More...
var	setScrollBarPositionFromCornerForHorizontal ( var positionFromCorner)
	Set the horizontal scroll bar position from left-bottom corner. More...
local	setScrollBarPositionFromCornerForHorizontal ( local positionFromCorner)
	Set the horizontal scroll bar position from left-bottom corner. More...
Vec2	getScrollBarPositionFromCornerForHorizontal () const
	Get the horizontal scroll bar's position from right-top corner. More...
void	setScrollBarWidth (float width)
	Set the scroll bar's width. More...
float	getScrollBarWidth () const
	Get the scroll bar's width. More...
var	getScrollBarWidth ()
	Get the scroll bar's width. More...
local	getScrollBarWidth ()
	Get the scroll bar's width. More...
void	setScrollBarColor (const Color3B &color)
	Set the scroll bar's color. More...
var	setScrollBarColor ( var color)
	Set the scroll bar's color. More...
local	setScrollBarColor ( local color)
	Set the scroll bar's color. More...
const Color3B &	getScrollBarColor () const
	Get the scroll bar's color. More...
var	getScrollBarColor ()
	Get the scroll bar's color. More...
local	getScrollBarColor ()
	Get the scroll bar's color. More...
void	setScrollBarOpacity (GLubyte opacity)
	Set the scroll bar's opacity. More...
var	setScrollBarOpacity ( var opacity)
	Set the scroll bar's opacity. More...
local	setScrollBarOpacity ( local opacity)
	Set the scroll bar's opacity. More...
GLubyte	getScrollBarOpacity () const
	Get the scroll bar's opacity. More...
var	getScrollBarOpacity ()
	Get the scroll bar's opacity. More...
local	getScrollBarOpacity ()
	Get the scroll bar's opacity. More...
void	setScrollBarAutoHideEnabled (bool autoHideEnabled)
	Set scroll bar auto hide state. More...
var	setScrollBarAutoHideEnabled ( var autoHideEnabled)
	Set scroll bar auto hide state. More...
local	setScrollBarAutoHideEnabled ( local autoHideEnabled)
	Set scroll bar auto hide state. More...
bool	isScrollBarAutoHideEnabled () const
	Query scroll bar auto hide state. More...
void	setScrollBarAutoHideTime (float autoHideTime)
	Set scroll bar auto hide time. More...
var	setScrollBarAutoHideTime ( var autoHideTime)
	Set scroll bar auto hide time. More...
local	setScrollBarAutoHideTime ( local autoHideTime)
	Set scroll bar auto hide time. More...
float	getScrollBarAutoHideTime () const
	Get the scroll bar's auto hide time. More...
void	setTouchTotalTimeThreshold (float touchTotalTimeThreshold)
	Set the touch total time threshold. More...
var	setTouchTotalTimeThreshold ( var touchTotalTimeThreshold)
	Set the touch total time threshold. More...
local	setTouchTotalTimeThreshold ( local touchTotalTimeThreshold)
	Set the touch total time threshold. More...
float	getTouchTotalTimeThreshold () const
	Get the touch total time threshold. More...
var	getTouchTotalTimeThreshold ()
	Get the touch total time threshold. More...
local	getTouchTotalTimeThreshold ()
	Get the touch total time threshold. More...
virtual void	setLayoutType (Type type) override
	Set layout type for scrollview. More...
var	setLayoutType ( var type)
	Set layout type for scrollview. More...
local	setLayoutType ( local type)
	Set layout type for scrollview. More...
virtual Type	getLayoutType () const override
	Get the layout type for scrollview. More...
var	getLayoutType ()
	Get the layout type for scrollview. More...
local	getLayoutType ()
	Get the layout type for scrollview. 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...
var	onExit ()
	Event callback that is invoked every time the Node leaves the 'stage'. More...
virtual Widget *	findNextFocusedWidget (FocusDirection direction, Widget *current) override
	When a widget is in a layout, you could call this method to get the next focused widget within a specified direction. More...
bool	isScrolling () const
bool	isAutoScrolling () const
Public Member Functions inherited from Layout
	Layout ()
	Default constructor. More...
	ctor ()
	Default constructor. More...
	new ()
	Default constructor. More...
virtual	~Layout ()
	Default destructor. More...
void	setBackGroundImage (const std::string &fileName, TextureResType texType=TextureResType::LOCAL)
	Sets a background image for layout. More...
var	setBackGroundImage ( var fileName, var LOCAL)
	Sets a background image for layout. More...
local	setBackGroundImage ( local fileName, local LOCAL)
	Sets a background image for layout. More...
void	setBackGroundImageCapInsets (const Rect &capInsets)
	Sets a background image capinsets for layout, it only affects the scale9 enabled background image. More...
var	setBackGroundImageCapInsets ( var capInsets)
	Sets a background image capinsets for layout, it only affects the scale9 enabled background image. More...
local	setBackGroundImageCapInsets ( local capInsets)
	Sets a background image capinsets for layout, it only affects the scale9 enabled background image. More...
const Rect &	getBackGroundImageCapInsets () const
	Query background image's capInsets size. More...
var	getBackGroundImageCapInsets ()
	Query background image's capInsets size. More...
local	getBackGroundImageCapInsets ()
	Query background image's capInsets size. More...
void	setBackGroundColorType (BackGroundColorType type)
	Sets Color Type for layout's background. More...
BackGroundColorType	getBackGroundColorType () const
	Query the layout's background color type. More...
var	getBackGroundColorType ()
	Query the layout's background color type. More...
local	getBackGroundColorType ()
	Query the layout's background color type. More...
void	setBackGroundImageScale9Enabled (bool enabled)
	Enable background image scale9 rendering. More...
bool	isBackGroundImageScale9Enabled () const
	Query background image scale9 enable status. More...
void	setBackGroundColor (const Color3B &color)
	Set background color for layout The color only applies to layout when it's color type is BackGroundColorType::SOLIDE. More...
var	setBackGroundColor ( var color)
	Set background color for layout The color only applies to layout when it's color type is BackGroundColorType::SOLIDE. More...
local	setBackGroundColor ( local color)
	Set background color for layout The color only applies to layout when it's color type is BackGroundColorType::SOLIDE. More...
const Color3B &	getBackGroundColor () const
	Query the layout's background color. More...
var	getBackGroundColor ()
	Query the layout's background color. More...
local	getBackGroundColor ()
	Query the layout's background color. More...
void	setBackGroundColor (const Color3B &startColor, const Color3B &endColor)
	Set start and end background color for layout. More...
const Color3B &	getBackGroundStartColor () const
	Get the gradient background start color. More...
var	getBackGroundStartColor ()
	Get the gradient background start color. More...
local	getBackGroundStartColor ()
	Get the gradient background start color. More...
const Color3B &	getBackGroundEndColor () const
	Get the gradient background end color. More...
local	getBackGroundEndColor ()
	Get the gradient background end color. More...
void	setBackGroundColorOpacity (GLubyte opacity)
	Sets background color opacity of layout. More...
var	setBackGroundColorOpacity ( var opacity)
	Sets background color opacity of layout. More...
local	setBackGroundColorOpacity ( local opacity)
	Sets background color opacity of layout. More...
GLubyte	getBackGroundColorOpacity () const
	Get the layout's background color opacity. More...
var	getBackGroundColorOpacity ()
	Get the layout's background color opacity. More...
local	getBackGroundColorOpacity ()
	Get the layout's background color opacity. More...
void	setBackGroundColorVector (const Vec2 &vector)
	Sets background color vector for layout. More...
var	setBackGroundColorVector ( var vector)
	Sets background color vector for layout. More...
local	setBackGroundColorVector ( local vector)
	Sets background color vector for layout. More...
const Vec2 &	getBackGroundColorVector () const
	Get the layout's background color vector. More...
var	getBackGroundColorVector ()
	Get the layout's background color vector. More...
local	getBackGroundColorVector ()
	Get the layout's background color vector. More...
void	setBackGroundImageColor (const Color3B &color)
	Set layout's background image color. More...
var	setBackGroundImageColor ( var color)
	Set layout's background image color. More...
local	setBackGroundImageColor ( local color)
	Set layout's background image color. More...
void	setBackGroundImageOpacity (GLubyte opacity)
	Set opacity of background image. More...
var	setBackGroundImageOpacity ( var opacity)
	Set opacity of background image. More...
local	setBackGroundImageOpacity ( local opacity)
	Set opacity of background image. More...
const Color3B &	getBackGroundImageColor () const
	Get color of layout's background image. More...
var	getBackGroundImageColor ()
	Get color of layout's background image. More...
local	getBackGroundImageColor ()
	Get color of layout's background image. More...
GLubyte	getBackGroundImageOpacity () const
	Get the opacity of layout's background image. More...
var	getBackGroundImageOpacity ()
	Get the opacity of layout's background image. More...
local	getBackGroundImageOpacity ()
	Get the opacity of layout's background image. More...
void	removeBackGroundImage ()
	Remove the background image of layout.
var	removeBackGroundImage ()
	Remove the background image of layout.
local	removeBackGroundImage ()
	Remove the background image of layout.
const Size &	getBackGroundImageTextureSize () const
	Gets background image texture size. More...
var	getBackGroundImageTextureSize ()
	Gets background image texture size. More...
local	getBackGroundImageTextureSize ()
	Gets background image texture size. More...
virtual void	setClippingEnabled (bool enabled)
	Toggle layout clipping. More...
var	setClippingEnabled ( var enabled)
	Toggle layout clipping. More...
local	setClippingEnabled ( local enabled)
	Toggle layout clipping. More...
void	setClippingType (ClippingType type)
	Change the clipping type of layout. More...
ClippingType	getClippingType () const
virtual bool	isClippingEnabled () const
	Gets if layout is clipping enabled. More...
local	isClippingEnabled ()
	Gets if layout is clipping enabled. More...
virtual void	visit (Renderer *renderer, const Mat4 &parentTransform, uint32_t parentFlags) override
	Visits this node's children and draw them recursively. More...
virtual void	forceDoLayout ()
	force refresh widget layout
var	forceDoLayout ()
	force refresh widget layout
local	forceDoLayout ()
	force refresh widget layout
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...
void	setLoopFocus (bool loop)
	If a layout is loop focused which means that the focus movement will be inside the layout. More...
var	setLoopFocus ( var loop)
	If a layout is loop focused which means that the focus movement will be inside the layout. More...
local	setLoopFocus ( local loop)
	If a layout is loop focused which means that the focus movement will be inside the layout. More...
bool	isLoopFocus () const
var	isLoopFocus ()
local	isLoopFocus ()
void	setPassFocusToChild (bool pass)
bool	isPassFocusToChild () const
virtual void	setCameraMask (unsigned short mask, bool applyChildren=true) override
	Override function. More...
var	setCameraMask ( var mask, var true)
	Override function. More...
local	setCameraMask ( local mask, local true)
	Override function. More...
Public Member Functions inherited from Widget
	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...
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 Vec2 &	getPositionPercent ()
	Gets the percent (x,y) of the widget in OpenGL coordinates. More...
void	setPositionType (PositionType type)
	Changes the position type of the widget. More...
PositionType	getPositionType () const
	Gets the position type of the widget. More...
virtual void	setFlippedX (bool flippedX)
	Sets whether the widget should be flipped horizontally or not. More...
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 Vec2 &	getTouchStartPos () 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 Vec2 &	getTouchBeganPosition () 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 Vec2 &	getSizePercent ()
	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...
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...
LayoutParameter *	getLayoutParameter () const override
	Gets LayoutParameter of widget. More...
var	getLayoutParameter ()
	Gets LayoutParameter of widget. More...
local	getLayoutParameter ()
	Gets LayoutParameter of widget. More...
LayoutParameter *	getLayoutParameter (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 Node *	getVirtualRenderer ()
	Gets the inner Renderer node of widget. More...
virtual Size	getVirtualRendererSize () const
	Get the virtual renderer's size. More...
Widget *	clone ()
	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...
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...
void	requestFocus ()
	when a widget calls this method, it will get focus immediately.
Widget *	getCurrentFocusedWidget (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	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 Node *	getProtectedChildByTag (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 Scene *	getScene () const
	Returns the Scene that contains the Node. More...
local	getScene ()
	Returns the Scene that contains the Node. More...
virtual Rect	getBoundingBox () const
	Returns an AABB (axis-aligned bounding-box) in its parent's coordinate system. More...
virtual Rect	boundingBox () const
local	boundingBox ()
virtual void	setEventDispatcher (EventDispatcher *dispatcher)
	Set event dispatcher for scene. More...
var	setEventDispatcher ( var dispatcher)
	Set event dispatcher for scene. More...
local	setEventDispatcher ( local dispatcher)
	Set event dispatcher for scene. More...
virtual EventDispatcher *	getEventDispatcher () const
	Get the event dispatcher of scene. More...
local	getEventDispatcher ()
	Get the event dispatcher of scene. More...
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 Color3B &	getColor () const
	Query node's color value. More...
local	getColor ()
	Query node's color value. More...
virtual const Color3B &	getDisplayedColor () 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 Vec2 &	getPosition () 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 Vec2 &	getPositionNormalized () const
	Returns the normalized position. More...
virtual const Vec2 &	getNormalizedPosition () 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 Vec2 &	getAnchorPoint () const
	Returns the anchor point in percent. More...
virtual const Vec2 &	getAnchorPointInPoints () const
	Returns the anchorPoint in absolute pixels. More...
virtual const Size &	getContentSize () const
	Returns the untransformed size of the node. More...
virtual void	setVisible (bool visible)
	Sets whether the node is visible. More...
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 Ref *	getUserObject ()
	Returns a user assigned Object. More...
var	getUserObject ()
	Returns a user assigned Object. More...
virtual const Ref *	getUserObject () const
virtual void	setUserObject (Ref *userObject)
	Returns a user assigned Object. More...
local	setUserObject ( local userObject)
	Returns a user assigned Object. More...
GLProgram *	getGLProgram () const
	Return the GLProgram (shader) currently used for this node. More...
var	getGLProgram ()
	Return the GLProgram (shader) currently used for this node. More...
local	getGLProgram ()
	Return the GLProgram (shader) currently used for this node. More...
GLProgram *	getShaderProgram () const
var	getShaderProgram ()
local	getShaderProgram ()
virtual void	setGLProgram (GLProgram *glprogram)
	Sets the shader program for this node. More...
local	setGLProgram ( local glprogram)
	Sets the shader program for this node. More...
void	setShaderProgram (GLProgram *glprogram)
var	setShaderProgram ( var glprogram)
local	setShaderProgram ( local glprogram)
GLProgramState *	getGLProgramState () const
	Return the GLProgramState currently used for this node. More...
var	getGLProgramState ()
	Return the GLProgramState currently used for this node. More...
local	getGLProgramState ()
	Return the GLProgramState currently used for this node. More...
virtual void	setGLProgramState (GLProgramState *glProgramState)
	Set the GLProgramState for this node. More...
virtual void	setActionManager (ActionManager *actionManager)
	Sets the ActionManager object that is used by all actions. More...
var	setActionManager ( var actionManager)
	Sets the ActionManager object that is used by all actions. More...
local	setActionManager ( local actionManager)
	Sets the ActionManager object that is used by all actions. More...
virtual ActionManager *	getActionManager ()
	Gets the ActionManager object that is used by all actions. More...
local	getActionManager ()
	Gets the ActionManager object that is used by all actions. More...
virtual const ActionManager *	getActionManager () const
virtual Action *	runAction (Action *action)
	Executes an action, and returns the action that is executed. More...
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...
Action *	getActionByTag (int tag)
	Gets an action from the running action list by its tag. More...
ssize_t	getNumberOfRunningActions () const
	Returns the numbers of actions that are running plus the ones that are schedule to run (actions in actionsToAdd and actions arrays). More...
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 Scheduler *	getScheduler ()
	Gets a Scheduler object. More...
local	getScheduler ()
	Gets a Scheduler object. More...
virtual const Scheduler *	getScheduler () 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	updateTransform ()
	Calls children's updateTransform() method recursively. More...
virtual const Mat4 &	getNodeToParentTransform () const
	Returns the matrix that transform the node's (local) space coordinates into the parent's space coordinates. More...
virtual AffineTransform	getNodeToParentAffineTransform () const
local	getNodeToParentAffineTransform ()
virtual 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 Mat4 &	getParentToNodeTransform () const
	Returns the matrix that transform parent's space coordinates to the node's (local) space coordinates. More...
var	getParentToNodeTransform ()
	Returns the matrix that transform parent's space coordinates to the node's (local) space coordinates. More...
local	getParentToNodeTransform ()
	Returns the matrix that transform parent's space coordinates to the node's (local) space coordinates. More...
virtual AffineTransform	getParentToNodeAffineTransform () const
local	getParentToNodeAffineTransform ()
virtual AffineTransform	parentToNodeTransform () const
local	parentToNodeTransform ()
virtual Mat4	getNodeToWorldTransform () const
	Returns the world affine transform matrix. More...
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.
template<typename T >
T	getChildByTag (int tag) const
	Gets a child from the container with its tag that can be cast to Type T. More...
template<typename T >
T	getChildByName (const std::string &name) const
	Gets a child from the container with its name that can be cast to Type T. More...
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 void	setParent (Node *parent)
	Sets the parent node. More...
local	setParent ( local parent)
	Sets the parent node. More...
virtual Node *	getParent ()
	Returns a pointer to the parent node. More...
virtual const Node *	getParent () const
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	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	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...
Ref *	autorelease ()
	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 ListView *	create ()
	Create an empty ListView. More...
var	create ()
	Create an empty ListView. More...
local	create ()
	Create an empty ListView. More...
Static Public Member Functions inherited from ScrollView
static ScrollView *	create ()
	Create an empty ScrollView. More...
var	create ()
	Create an empty ScrollView. More...
local	create ()
	Create an empty ScrollView. More...
Static Public Member Functions inherited from Layout
static Layout *	create ()
	Create a empty layout.
var	create ()
	Create a empty layout.
local	create ()
	Create a empty layout.
Static Public Member Functions inherited from Widget
static Widget *	create ()
	Create and return a empty Widget instance pointer.
local	create ()
	Create and return a empty Widget instance pointer.
static Widget *	getCurrentFocusedWidget ()
	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 ProtectedNode *	create (void)
	Creates a ProtectedNode with no argument. More...
Static Public Member Functions inherited from Node
static Node *	create ()
	Allocates and initializes a node. More...
var	create ()
	Allocates and initializes a node. More...
local	create ()
	Allocates and initializes a node. More...
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...

Additional Inherited Members
Public Attributes inherited from Layout
std::function< int(FocusDirection, Widget *)>	onPassFocusToChild
	To specify a user-defined functor to decide which child widget of the layout should get focused. More...
Public Attributes inherited from Widget
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.
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.
Protected Member Functions inherited from Widget
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...

Detailed Description

ListView is a view group that displays a list of scrollable items.

The list items are inserted to the list by using addChild or insertDefaultItem.

Warning

The list item in ListView doesn't support cell reuse at the moment, if you have a large amount of data need to be displayed, use TableView instead. ListView is a subclass of ScrollView, so it shares many features of ScrollView.

Constructor & Destructor Documentation

ListView

(

)

Default constructor.

var ctor

(

)

Default constructor.

local new

(

)

Default constructor.

virtual ~ListView ( )

virtual

Default destructor.

Member Function Documentation

static ListView* create ( )

static

Create an empty ListView.

Returns

A ListView instance.

var create ( )

static

Create an empty ListView.

Returns

A ListView instance.

local create ( )

static

Create an empty ListView.

Returns

A ListView instance.

void setItemModel

(

Widget *

model

)

Set an item model for listview.

When calling pushBackDefaultItem, the model will be used as a blueprint and new model copy will be inserted into ListView.

Parameters

model

Model in Widget*.

var setItemModel

(

var

model

)

Set an item model for listview.

When calling pushBackDefaultItem, the model will be used as a blueprint and new model copy will be inserted into ListView.

Parameters

model

Model in Widget*.

local setItemModel

(

local

model

)

Set an item model for listview.

When calling pushBackDefaultItem, the model will be used as a blueprint and new model copy will be inserted into ListView.

Parameters

model

Model in Widget*.

void insertDefaultItem

(

ssize_t

index

)

Insert a default item(create by cloning model) into listview at a give index.

Parameters

index

An index in ssize_t.

var insertDefaultItem

(

var

index

)

Insert a default item(create by cloning model) into listview at a give index.

Parameters

index

An index in ssize_t.

local insertDefaultItem

(

local

index

)

Insert a default item(create by cloning model) into listview at a give index.

Parameters

index

An index in ssize_t.

void pushBackCustomItem

(

Widget *

item

)

Insert a custom item into the end of ListView.

Parameters

item	An item in Widget*.

var pushBackCustomItem

(

var

item

)

Insert a custom item into the end of ListView.

Parameters

item	An item in Widget*.

local pushBackCustomItem

(

local

item

)

Insert a custom item into the end of ListView.

Parameters

item	An item in Widget*.

void insertCustomItem	(	Widget *	item,
		ssize_t	index
	)

Insert a custom widget into ListView at a given index.

Parameters

item	A widget pointer to be inserted.
index	A given index in ssize_t.

var insertCustomItem	(	var	item,
		var	index
	)

Insert a custom widget into ListView at a given index.

Parameters

item	A widget pointer to be inserted.
index	A given index in ssize_t.

local insertCustomItem	(	local	item,
		local	index
	)

Insert a custom widget into ListView at a given index.

Parameters

item	A widget pointer to be inserted.
index	A given index in ssize_t.

void removeItem

(

ssize_t

index

)

Remove an item at given index.

Parameters

index

A given index in ssize_t.

var removeItem

(

var

index

)

Remove an item at given index.

Parameters

index

A given index in ssize_t.

local removeItem

(

local

index

)

Remove an item at given index.

Parameters

index

A given index in ssize_t.

Widget* getItem

(

ssize_t

index

)

const

Return an item at a given index.

Parameters

index

A given index in ssize_t.

Returns

A widget instance.

var getItem

(

var

index

)

Return an item at a given index.

Parameters

index

A given index in ssize_t.

Returns

A widget instance.

local getItem

(

local

index

)

Return an item at a given index.

Parameters

index

A given index in ssize_t.

Returns

A widget instance.

Vector<Widget*>& getItems

(

)

Return all items in a ListView.

Returns

A vector of widget pointers.

var getItems

(

)

Return all items in a ListView.

Returns

A vector of widget pointers.

local getItems

(

)

Return all items in a ListView.

Returns

A vector of widget pointers.

ssize_t getIndex

(

Widget *

item

)

const

Return the index of specified widget.

Parameters

item	A widget pointer.

Returns

The index of a given widget in ListView.

var getIndex

(

var

item

)

Return the index of specified widget.

Parameters

item	A widget pointer.

Returns

The index of a given widget in ListView.

local getIndex

(

local

item

)

Return the index of specified widget.

Parameters

item	A widget pointer.

Returns

The index of a given widget in ListView.

void setGravity

(

Gravity

gravity

)

Set the gravity of ListView.

See also

ListViewGravity

var setGravity

(

var

gravity

)

Set the gravity of ListView.

See also

ListViewGravity

local setGravity

(

local

gravity

)

Set the gravity of ListView.

See also

ListViewGravity

void setMagneticType

(

MagneticType

magneticType

)

Set magnetic type of ListView.

See also

MagneticType

var setMagneticType

(

var

magneticType

)

Set magnetic type of ListView.

See also

MagneticType

local setMagneticType

(

local

magneticType

)

Set magnetic type of ListView.

See also

MagneticType

void setItemsMargin

(

float

margin

)

Set the margin between each item in ListView.

Parameters

margin

A margin in float.

var setItemsMargin

(

var

margin

)

Set the margin between each item in ListView.

Parameters

margin

A margin in float.

local setItemsMargin

(

local

margin

)

Set the margin between each item in ListView.

Parameters

margin

A margin in float.

float getItemsMargin

(

)

const

Query margin between each item in ListView.

Returns

A margin in float.

var getItemsMargin

(

)

Query margin between each item in ListView.

Returns

A margin in float.

local getItemsMargin

(

)

Query margin between each item in ListView.

Returns

A margin in float.

void setPadding	(	float	l,
		float	t,
		float	r,
		float	b
	)

Change padding with left, top, right, and bottom padding.

Parameters

l	Left padding in float.
t	Top margin in float.
r	Right margin in float.
b	Bottom margin in float.

var setPadding	(	var	l,
		var	t,
		var	r,
		var	b
	)

Change padding with left, top, right, and bottom padding.

Parameters

l	Left padding in float.
t	Top margin in float.
r	Right margin in float.
b	Bottom margin in float.

local setPadding	(	local	l,
		local	t,
		local	r,
		local	b
	)

Change padding with left, top, right, and bottom padding.

Parameters

l	Left padding in float.
t	Top margin in float.
r	Right margin in float.
b	Bottom margin in float.

void setLeftPadding

(

float

l

)

Change padding with left padding.

Parameters

l	Left padding in float.

var setLeftPadding

(

var

l

)

Change padding with left padding.

Parameters

l	Left padding in float.

local setLeftPadding

(

local

l

)

Change padding with left padding.

Parameters

l	Left padding in float.

void setTopPadding

(

float

t

)

Change padding with top padding.

Parameters

t	Top padding in float

var setTopPadding

(

var

t

)

Change padding with top padding.

Parameters

t	Top padding in float

local setTopPadding

(

local

t

)

Change padding with top padding.

Parameters

t	Top padding in float

void setRightPadding

(

float

r

)

Change padding with right padding.

Parameters

r	Right padding in float

var setRightPadding

(

var

r

)

Change padding with right padding.

Parameters

r	Right padding in float

local setRightPadding

(

local

r

)

Change padding with right padding.

Parameters

r	Right padding in float

void setBottomPadding

(

float

b

)

Change padding with bottom padding.

Parameters

b	Bottom padding in float

var setBottomPadding

(

var

b

)

Change padding with bottom padding.

Parameters

b	Bottom padding in float

local setBottomPadding

(

local

b

)

Change padding with bottom padding.

Parameters

b	Bottom padding in float

float getLeftPadding

(

)

const

Get the left padding in ListView.

Returns

Left padding in float

var getLeftPadding

(

)

Get the left padding in ListView.

Returns

Left padding in float

local getLeftPadding

(

)

Get the left padding in ListView.

Returns

Left padding in float

float getTopPadding

(

)

const

Get the top padding in ListView.

Returns

Top padding in float

var getTopPadding

(

)

Get the top padding in ListView.

Returns

Top padding in float

local getTopPadding

(

)

Get the top padding in ListView.

Returns

Top padding in float

float getRightPadding

(

)

const

Get the right padding in ListView.

Returns

Right padding in float

var getRightPadding

(

)

Get the right padding in ListView.

Returns

Right padding in float

local getRightPadding

(

)

Get the right padding in ListView.

Returns

Right padding in float

float getBottomPadding

(

)

const

Get the bottom padding in ListView.

Returns

Bottom padding in float

var getBottomPadding

(

)

Get the bottom padding in ListView.

Returns

Bottom padding in float

local getBottomPadding

(

)

Get the bottom padding in ListView.

Returns

Bottom padding in float

void setScrollDuration

(

float

time

)

Set the time in seconds to scroll between items.

Subsequent calls of function 'scrollToItem', will take 'time' seconds for scrolling.

Parameters

time	The seconds needed to scroll between two items. 'time' must be >= 0

See also

scrollToItem(ssize_t, const Vec2&, const Vec2&)

var setScrollDuration

(

var

time

)

Set the time in seconds to scroll between items.

Subsequent calls of function 'scrollToItem', will take 'time' seconds for scrolling.

Parameters

time	The seconds needed to scroll between two items. 'time' must be >= 0

See also

scrollToItem(ssize_t, const Vec2&, const Vec2&)

local setScrollDuration

(

local

time

)

Set the time in seconds to scroll between items.

Subsequent calls of function 'scrollToItem', will take 'time' seconds for scrolling.

Parameters

time	The seconds needed to scroll between two items. 'time' must be >= 0

See also

scrollToItem(ssize_t, const Vec2&, const Vec2&)

float getScrollDuration

(

)

const

Get the time in seconds to scroll between items.

Returns

The time in seconds to scroll between items

See also

setScrollDuration(float)

var getScrollDuration

(

)

Get the time in seconds to scroll between items.

Returns

The time in seconds to scroll between items

See also

setScrollDuration(float)

local getScrollDuration

(

)

Get the time in seconds to scroll between items.

Returns

The time in seconds to scroll between items

See also

setScrollDuration(float)

virtual void addChild ( Node *  child )

overridevirtual

Adds a child to the container with z-order as 0.

If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.

Parameters

child

A child node.

Reimplemented from ScrollView.

var addChild ( var  child )

overridevirtual

Adds a child to the container with z-order as 0.

If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.

Parameters

child

A child node.

Reimplemented from ScrollView.

local addChild ( local  child )

overridevirtual

Adds a child to the container with z-order as 0.

If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.

Parameters

child

A child node.

Reimplemented from ScrollView.

virtual void addChild ( Node *  child, int  localZOrder  )

overridevirtual

Adds a child to the container with a local z-order.

If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.

Parameters

child	A child node.
localZOrder	Z order for drawing priority. Please refer to setLocalZOrder(int).

Reimplemented from ScrollView.

var addChild ( var  child, var  localZOrder  )

overridevirtual

Adds a child to the container with a local z-order.

If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.

Parameters

child	A child node.
localZOrder	Z order for drawing priority. Please refer to setLocalZOrder(int).

Reimplemented from ScrollView.

local addChild ( local  child, local  localZOrder  )

overridevirtual

Adds a child to the container with a local z-order.

If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.

Parameters

child	A child node.
localZOrder	Z order for drawing priority. Please refer to setLocalZOrder(int).

Reimplemented from ScrollView.

virtual void addChild ( Node *  child, int  localZOrder, int  tag  )

overridevirtual

Adds a child to the container with z order and tag.

If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.

Parameters

child	A child node
localZOrder	Z order for drawing priority. Please refer to setLocalZOrder(int)
tag	A integer to identify the node easily. Please refer to setTag(int)

Reimplemented from ScrollView.

var addChild ( var  child, var  localZOrder, var  tag  )

overridevirtual

Adds a child to the container with z order and tag.

If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.

Parameters

child	A child node
localZOrder	Z order for drawing priority. Please refer to setLocalZOrder(int)
tag	A integer to identify the node easily. Please refer to setTag(int)

Reimplemented from ScrollView.

local addChild ( local  child, local  localZOrder, local  tag  )

overridevirtual

Adds a child to the container with z order and tag.

If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.

Parameters

child	A child node
localZOrder	Z order for drawing priority. Please refer to setLocalZOrder(int)
tag	A integer to identify the node easily. Please refer to setTag(int)

Reimplemented from ScrollView.

virtual void addChild ( Node *  child, int  localZOrder, const std::string &  name  )

overridevirtual

Adds a child to the container with z order and tag.

If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.

Parameters

child	A child node.
localZOrder	Z order for drawing priority. Please refer to setLocalZOrder(int).
name	A string to identify the node easily. Please refer to setName(int).

Reimplemented from ScrollView.

var addChild ( var  child, var  localZOrder, var  name  )

overridevirtual

Adds a child to the container with z order and tag.

If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.

Parameters

child	A child node.
localZOrder	Z order for drawing priority. Please refer to setLocalZOrder(int).
name	A string to identify the node easily. Please refer to setName(int).

Reimplemented from ScrollView.

local addChild ( local  child, local  localZOrder, local  name  )

overridevirtual

Adds a child to the container with z order and tag.

If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.

Parameters

child	A child node.
localZOrder	Z order for drawing priority. Please refer to setLocalZOrder(int).
name	A string to identify the node easily. Please refer to setName(int).

Reimplemented from ScrollView.

virtual void removeAllChildren ( )

overridevirtual

Removes all children from the container with a cleanup.

See also

removeAllChildrenWithCleanup(bool)

Reimplemented from ScrollView.

var removeAllChildren ( )

overridevirtual

Removes all children from the container with a cleanup.

See also

removeAllChildrenWithCleanup(bool)

Reimplemented from ScrollView.

local removeAllChildren ( )

overridevirtual

Removes all children from the container with a cleanup.

See also

removeAllChildrenWithCleanup(bool)

Reimplemented from ScrollView.

virtual void removeAllChildrenWithCleanup ( bool  cleanup )

overridevirtual

Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter.

Parameters

cleanup

true if all running actions on all children nodes should be cleanup, false otherwise.

Reimplemented from ScrollView.

var removeAllChildrenWithCleanup ( var  cleanup )

overridevirtual

Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter.

Parameters

cleanup

true if all running actions on all children nodes should be cleanup, false otherwise.

Reimplemented from ScrollView.

local removeAllChildrenWithCleanup ( local  cleanup )

overridevirtual

Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter.

Parameters

cleanup

true if all running actions on all children nodes should be cleanup, false otherwise.

Reimplemented from ScrollView.

virtual void removeChild ( Node *  child, bool  cleanup = true  )

overridevirtual

Removes a child from the container.

It will also cleanup all running actions depending on the cleanup parameter.

Parameters

child	The child node which will be removed.
cleanup	True if all running actions and callbacks on the child node will be cleanup, false otherwise.

Reimplemented from ScrollView.

var removeChild ( var  child, var  cleanup = true  )

overridevirtual

Removes a child from the container.

It will also cleanup all running actions depending on the cleanup parameter.

Parameters

child	The child node which will be removed.
cleanup	True if all running actions and callbacks on the child node will be cleanup, false otherwise.

Reimplemented from ScrollView.

local removeChild ( local  child, local  cleanup = true  )

overridevirtual

Removes a child from the container.

It will also cleanup all running actions depending on the cleanup parameter.

Parameters

child	The child node which will be removed.
cleanup	True if all running actions and callbacks on the child node will be cleanup, false otherwise.

Reimplemented from ScrollView.

Widget* getClosestItemToPosition	(	const Vec2 &	targetPosition,
		const Vec2 &	itemAnchorPoint
	)		const

Query the closest item to a specific position in inner container.

Parameters

targetPosition	Specifies the target position in inner container's coordinates.
itemAnchorPoint	Specifies an anchor point of each item for position to calculate distance.

Returns

An item instance if list view is not empty. Otherwise, returns null.

var getClosestItemToPosition	(	var	targetPosition,
		var	itemAnchorPoint
	)

Query the closest item to a specific position in inner container.

Parameters

targetPosition	Specifies the target position in inner container's coordinates.
itemAnchorPoint	Specifies an anchor point of each item for position to calculate distance.

Returns

An item instance if list view is not empty. Otherwise, returns null.

local getClosestItemToPosition	(	local	targetPosition,
		local	itemAnchorPoint
	)

Query the closest item to a specific position in inner container.

Parameters

targetPosition	Specifies the target position in inner container's coordinates.
itemAnchorPoint	Specifies an anchor point of each item for position to calculate distance.

Returns

An item instance if list view is not empty. Otherwise, returns null.

Widget* getClosestItemToPositionInCurrentView	(	const Vec2 &	positionRatioInView,
		const Vec2 &	itemAnchorPoint
	)		const

Query the closest item to a specific position in current view.

For instance, to find the item in the center of view, call 'getClosestItemToPositionInCurrentView(Vec2::ANCHOR_MIDDLE, Vec2::ANCHOR_MIDDLE)'.

Parameters

positionRatioInView	Specifies the target position with ratio in list view's content size.
itemAnchorPoint	Specifies an anchor point of each item for position to calculate distance.

Returns

An item instance if list view is not empty. Otherwise, returns null.

var getClosestItemToPositionInCurrentView	(	var	positionRatioInView,
		var	itemAnchorPoint
	)

Query the closest item to a specific position in current view.

For instance, to find the item in the center of view, call 'getClosestItemToPositionInCurrentView(Vec2::ANCHOR_MIDDLE, Vec2::ANCHOR_MIDDLE)'.

Parameters

positionRatioInView	Specifies the target position with ratio in list view's content size.
itemAnchorPoint	Specifies an anchor point of each item for position to calculate distance.

Returns

An item instance if list view is not empty. Otherwise, returns null.

local getClosestItemToPositionInCurrentView	(	local	positionRatioInView,
		local	itemAnchorPoint
	)

Query the closest item to a specific position in current view.

For instance, to find the item in the center of view, call 'getClosestItemToPositionInCurrentView(Vec2::ANCHOR_MIDDLE, Vec2::ANCHOR_MIDDLE)'.

Parameters

positionRatioInView	Specifies the target position with ratio in list view's content size.
itemAnchorPoint	Specifies an anchor point of each item for position to calculate distance.

Returns

An item instance if list view is not empty. Otherwise, returns null.

Widget* getCenterItemInCurrentView

(

)

const

Query the center item.

Returns

An item instance.

var getCenterItemInCurrentView

(

)

Query the center item.

Returns

An item instance.

local getCenterItemInCurrentView

(

)

Query the center item.

Returns

An item instance.

Widget* getLeftmostItemInCurrentView

(

)

const

Query the leftmost item in horizontal list.

Returns

An item instance.

var getLeftmostItemInCurrentView

(

)

Query the leftmost item in horizontal list.

Returns

An item instance.

local getLeftmostItemInCurrentView

(

)

Query the leftmost item in horizontal list.

Returns

An item instance.

Widget* getRightmostItemInCurrentView

(

)

const

Query the rightmost item in horizontal list.

Returns

An item instance.

var getRightmostItemInCurrentView

(

)

Query the rightmost item in horizontal list.

Returns

An item instance.

local getRightmostItemInCurrentView

(

)

Query the rightmost item in horizontal list.

Returns

An item instance.

Widget* getTopmostItemInCurrentView

(

)

const

Query the topmost item in horizontal list.

Returns

An item instance.

var getTopmostItemInCurrentView

(

)

Query the topmost item in horizontal list.

Returns

An item instance.

local getTopmostItemInCurrentView

(

)

Query the topmost item in horizontal list.

Returns

An item instance.

Widget* getBottommostItemInCurrentView

(

)

const

Query the bottommost item in horizontal list.

Returns

An item instance.

var getBottommostItemInCurrentView

(

)

Query the bottommost item in horizontal list.

Returns

An item instance.

local getBottommostItemInCurrentView

(

)

Query the bottommost item in horizontal list.

Returns

An item instance.

virtual void jumpToPercentVertical ( float  percent )

overridevirtual

Move inner container to vertical percent position of scrollview.

Parameters

percent

A value between 0 and 100.

Reimplemented from ScrollView.

var jumpToPercentVertical ( var  percent )

overridevirtual

Move inner container to vertical percent position of scrollview.

Parameters

percent

A value between 0 and 100.

Reimplemented from ScrollView.

local jumpToPercentVertical ( local  percent )

overridevirtual

Move inner container to vertical percent position of scrollview.

Parameters

percent

A value between 0 and 100.

Reimplemented from ScrollView.

virtual void jumpToPercentHorizontal ( float  percent )

overridevirtual

Move inner container to horizontal percent position of scrollview.

Parameters

percent

A value between 0 and 100.

Reimplemented from ScrollView.

var jumpToPercentHorizontal ( var  percent )

overridevirtual

Move inner container to horizontal percent position of scrollview.

Parameters

percent

A value between 0 and 100.

Reimplemented from ScrollView.

local jumpToPercentHorizontal ( local  percent )

overridevirtual

Move inner container to horizontal percent position of scrollview.

Parameters

percent

A value between 0 and 100.

Reimplemented from ScrollView.

virtual void jumpToPercentBothDirection ( const Vec2 &  percent )

overridevirtual

Move inner container to both direction percent position of scrollview.

Parameters

percent

A value between 0 and 100.

Reimplemented from ScrollView.

var jumpToPercentBothDirection ( var  percent )

overridevirtual

Move inner container to both direction percent position of scrollview.

Parameters

percent

A value between 0 and 100.

Reimplemented from ScrollView.

local jumpToPercentBothDirection ( local  percent )

overridevirtual

Move inner container to both direction percent position of scrollview.

Parameters

percent

A value between 0 and 100.

Reimplemented from ScrollView.

void jumpToItem	(	ssize_t	itemIndex,
		const Vec2 &	positionRatioInView,
		const Vec2 &	itemAnchorPoint
	)

Jump to specific item.

Parameters

itemIndex	Specifies the item's index
positionRatioInView	Specifies the position with ratio in list view's content size.
itemAnchorPoint	Specifies an anchor point of each item for position to calculate distance.

var jumpToItem	(	var	itemIndex,
		var	positionRatioInView,
		var	itemAnchorPoint
	)

Jump to specific item.

Parameters

itemIndex	Specifies the item's index
positionRatioInView	Specifies the position with ratio in list view's content size.
itemAnchorPoint	Specifies an anchor point of each item for position to calculate distance.

local jumpToItem	(	local	itemIndex,
		local	positionRatioInView,
		local	itemAnchorPoint
	)

Jump to specific item.

Parameters

itemIndex	Specifies the item's index
positionRatioInView	Specifies the position with ratio in list view's content size.
itemAnchorPoint	Specifies an anchor point of each item for position to calculate distance.

void scrollToItem	(	ssize_t	itemIndex,
		const Vec2 &	positionRatioInView,
		const Vec2 &	itemAnchorPoint
	)

Scroll to specific item.

Parameters

positionRatioInView	Specifies the position with ratio in list view's content size.
itemAnchorPoint	Specifies an anchor point of each item for position to calculate distance.
timeInSec	Scroll time

var scrollToItem	(	var	itemIndex,
		var	positionRatioInView,
		var	itemAnchorPoint
	)

Scroll to specific item.

Parameters

positionRatioInView	Specifies the position with ratio in list view's content size.
itemAnchorPoint	Specifies an anchor point of each item for position to calculate distance.
timeInSec	Scroll time

local scrollToItem	(	local	itemIndex,
		local	positionRatioInView,
		local	itemAnchorPoint
	)

Scroll to specific item.

Parameters

positionRatioInView	Specifies the position with ratio in list view's content size.
itemAnchorPoint	Specifies an anchor point of each item for position to calculate distance.
timeInSec	Scroll time

ssize_t getCurSelectedIndex

(

)

const

Query current selected widget's index.

Returns

An index of a selected item.

var getCurSelectedIndex

(

)

Query current selected widget's index.

Returns

An index of a selected item.

local getCurSelectedIndex

(

)

Query current selected widget's index.

Returns

An index of a selected item.

void setCurSelectedIndex

(

int

itemIndex

)

Set current selected widget's index and call TouchEventType::ENDED event.

Parameters

itemIndex

A index of a selected item.

var setCurSelectedIndex

(

var

itemIndex

)

Set current selected widget's index and call TouchEventType::ENDED event.

Parameters

itemIndex

A index of a selected item.

local setCurSelectedIndex

(

local

itemIndex

)

Set current selected widget's index and call TouchEventType::ENDED event.

Parameters

itemIndex

A index of a selected item.

void addEventListenerListView	(	Ref *	target,
		SEL_ListViewEvent	selector
	)

Add an event click callback to ListView, then one item of Listview is clicked, the callback will be called.

var addEventListenerListView	(	var	target,
		var	selector
	)

Add an event click callback to ListView, then one item of Listview is clicked, the callback will be called.

local addEventListenerListView	(	local	target,
		local	selector
	)

Add an event click callback to ListView, then one item of Listview is clicked, the callback will be called.

void addEventListener ( const ccListViewCallback &  callback )

virtual

Add an event click callback to ListView, then one item of Listview is clicked, the callback will be called.

Parameters

callback

A callback function with type of ccListViewCallback.

Reimplemented from ScrollView.

Reimplemented in PageView.

var addEventListener ( var  callback )

virtual

Add an event click callback to ListView, then one item of Listview is clicked, the callback will be called.

Parameters

callback

A callback function with type of ccListViewCallback.

Reimplemented from ScrollView.

Reimplemented in PageView.

local addEventListener ( local  callback )

virtual

Add an event click callback to ListView, then one item of Listview is clicked, the callback will be called.

Parameters

callback

A callback function with type of ccListViewCallback.

Reimplemented from ScrollView.

Reimplemented in PageView.

virtual void setDirection ( Direction  dir )

overridevirtual

Changes scroll direction of scrollview.

Direction Direction::VERTICAL means vertical scroll, Direction::HORIZONTAL means horizontal scroll.

Parameters

dir	Set the list view's scroll direction.

Reimplemented from ScrollView.

Reimplemented in PageView.

var setDirection ( var  dir )

overridevirtual

Changes scroll direction of scrollview.

Direction Direction::VERTICAL means vertical scroll, Direction::HORIZONTAL means horizontal scroll.

Parameters

dir	Set the list view's scroll direction.

Reimplemented from ScrollView.

Reimplemented in PageView.

local setDirection ( local  dir )

overridevirtual

Changes scroll direction of scrollview.

Direction Direction::VERTICAL means vertical scroll, Direction::HORIZONTAL means horizontal scroll.

Parameters

dir	Set the list view's scroll direction.

Reimplemented from ScrollView.

Reimplemented in PageView.

void requestRefreshView

(

)

Refresh view and layout of ListView manually.

This method will mark ListView content as dirty and the content view will be refreshed in the next frame.

var requestRefreshView

(

)

Refresh view and layout of ListView manually.

This method will mark ListView content as dirty and the content view will be refreshed in the next frame.

local requestRefreshView

(

)

Refresh view and layout of ListView manually.

This method will mark ListView content as dirty and the content view will be refreshed in the next frame.

void refreshView

(

)

Refresh content view of ListView.

var refreshView

(

)

Refresh content view of ListView.

local refreshView

(

)

Refresh content view of ListView.

---

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

• UIListView.h