Public 类型 - 《Cocos2dx 3.0 api 文档帮助手册教程》

详细描述
成员类型定义说明
成员枚举类型说明
构造及析构函数说明
成员函数说明
类成员变量说明

cocos2d-x 3.0

- 首页 - 相关页面 - 模块 - 命名空间 - 类 - 文件 -

)
- 类列表 - 类索引 - 类继承关系 - 类成员

全部) 类) 命名空间) 文件) 函数) 变量) 类型定义) 枚举) 枚举值) 属性) 友元) 宏定义) 组) 页)

Widget类参考

NA NA 更多…

#include

类 Widget 继承关系图:

Public 类型 - 图3

## Public 类型
enum	FocusDirection { LEFT, RIGHT, UP, DOWN }

enum	PositionType { ABSOLUTE, PERCENT }

enum	SizeType { ABSOLUTE, PERCENT }

enum	TouchEventType { BEGAN, MOVED, ENDED, CANCELED }

enum	TextureResType { LOCAL = 0, PLIST = 1 }

enum	BrightStyle { NONE = -1, NORMAL, HIGHLIGHT }

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

## Public 成员函数
	Widget (void)
	默认构造函数更多…

virtual	~Widget ()
	默认析构函数更多…

virtual void	setEnabled (bool enabled)
	设置widget是否为可用更多…

bool	isEnabled () const
	判断该widget是否可用更多…

void	setBright (bool bright)
	设置widget是否为亮色（对应可用状态）更多…

bool	isBright () const
	判断该widget是否为亮色更多…

virtual void	setTouchEnabled (bool enabled)
	设置widget是否可以响应触摸。更多…

void	setBrightStyle (BrightStyle style)
	设置widget的亮色风格（bright style）更多…

bool	isTouchEnabled () const
	判定该widget是否可以响应触摸更多…

bool	isHighlighted () const
	判定该widget是否为高亮（对应被选中状态）更多…

void	setHighlighted (bool hilight)
	设置该widget是否处于高亮状态（对应被选中状态）更多…

float	getLeftInParent ()
	获取该widget左边界横坐标更多…

float	getBottomInParent ()
	获取该widget底部边界纵坐标更多…

float	getRightInParent ()
	获取该widget右边界横坐标更多…

float	getTopInParent ()
	获取该widget顶部边界纵坐标更多…

virtual Widget	getChildByName (const std::string &name)
	通过名字从容器中获取一个子节点更多…

virtual void	visit (cocos2d::Renderer renderer, const Mat4 &parentTransform, bool parentTransformUpdated) override
	访问节点的孩子，并且循环递归的绘制它们。更多…

CC_DEPRECATED_ATTRIBUTE void	addTouchEventListener (Ref target, SEL_TouchEvent selector)
	为菜单项的目标／选择器设置触摸事件更多…

void	addTouchEventListener (ccWidgetTouchCallback callback)

virtual void	setPosition (const Vec2 &pos) override
	改变该widget在OpenGL坐标系中的绝对位置坐标（x,y）更多…

void	setPositionPercent (const Vec2 &percent)
	改变该widget在OpenGL坐标系中的相对百分比位置坐标（x,y）更多…

const Vec2 &	getPositionPercent ()
	获取该widget在OpenGL坐标系中的相对百分比位置坐标(x,y) 更多…

void	setPositionType (PositionType type)
	改变该widget的位置坐标类型更多…

PositionType	getPositionType () const
	获取该widget的位置坐标类型更多…

virtual void	setFlippedX (bool flippedX)
	设置该widget是否应该被水平翻转. 更多…

virtual bool	isFlippedX ()
	返回表明该widget是否被水平翻转的标识更多…

virtual void	setFlippedY (bool flippedY)
	设置该widget是否应该被垂直翻转. 更多…

virtual bool	isFlippedY ()
	返回表明该widget是否被垂直翻转的标识更多…

virtual void	setColor (const Color3B &color) override

virtual void	setOpacity (GLubyte opacity) override

const Color3B &	getColor () const override

GLubyte	getOpacity () const override

CC_DEPRECATED_ATTRIBUTE bool	isFlipX ()

CC_DEPRECATED_ATTRIBUTE void	setFlipX (bool flipX)

CC_DEPRECATED_ATTRIBUTE bool	isFlipY ()

CC_DEPRECATED_ATTRIBUTE void	setFlipY (bool flipY)

bool	clippingParentAreaContainPoint (const Vec2 &pt)

virtual void	checkChildInfo (int handleState, Widget sender, const Vec2 &touchPoint)

const Vec2 &	getTouchStartPos ()

const Vec2 &	getTouchMovePos ()

const Vec2 &	getTouchEndPos ()

void	setName (const std::string &name)
	改变widget的名字，使用名字可以更轻松地识别出该widget 更多…

const std::string &	getName () const
	返回widget的名字，使用名字可以更轻松地识别出该widget 更多…

virtual void	setSize (const Size &size)
	改变widget的尺寸（size）更多…

virtual void	setSizePercent (const Vec2 &percent)
	改变widget的百分比尺寸（percent size）更多…

void	setSizeType (SizeType type)
	改变widget的尺寸类型（size type）更多…

SizeType	getSizeType () const
	获取widget的尺寸类型（size type）更多…

const Size &	getSize () const
	返回widget的尺寸（size）更多…

const Size &	getCustomSize () const

virtual const Size &	getLayoutSize ()

const Vec2 &	getSizePercent () const
	返回widget的尺寸百分比更多…

virtual bool	hitTest (const Vec2 &pt)
	检查一个点是否在该widget所在区域更多…

virtual bool	onTouchBegan (Touch touch, Event unusedEvent)

virtual void	onTouchMoved (Touch touch, Event unusedEvent)

virtual void	onTouchEnded (Touch touch, Event unusedEvent)

virtual void	onTouchCancelled (Touch touch, Event unusedEvent)

void	setLayoutParameter (LayoutParameter parameter)
	为widget设置LayoutParameter 更多…

LayoutParameter	getLayoutParameter (LayoutParameter::Type type)
	获取widget的LayoutParameter 更多…

virtual void	ignoreContentAdaptWithSize (bool ignore)
	忽略widget的尺寸（size）更多…

bool	isIgnoreContentAdaptWithSize () const
	检查该widget的尺寸（size）是否被忽略更多…

Vec2	getWorldPosition ()
	获取widget在全局中的位置坐标更多…

virtual Node	getVirtualRenderer ()
	获取widget的虚拟渲染器更多…

virtual const Size &	getVirtualRendererSize () const
	获取widget的content size 更多…

virtual std::string	getDescription () const override
	返回widget的类名更多…

Widget	clone ()

virtual void	onEnter () override
	每次当Node进入“stage”时才调用事件回调。如果Node进入“stage”状态时伴随着一个转换（transition）,那么事件将会在这个转换开始的时候被调用。在onEnter过程中，你不能够接入“sister/brother”兄妹节点。如果你重写了onEnter方法，你应该调用它的父类，e.g., Node::onEnter(). 更多…

virtual void	onExit () override
	事件回调在每次Node离开“stage”时被调用。如果Node离开‘stage’并开始变换(transition)，此事件将在变换(transition)完成后被调用。在 onExit执行期间你不能访问兄弟节点(sibling node)。如果你 override onExit, 你应该调用其父节点的此方法，例如, Node::onExit(). 更多…

void	updateSizeAndPosition ()

void	updateSizeAndPosition (const Size &parentSize)

void	setActionTag (int tag)

int	getActionTag ()

bool	isFocused ()

void	setFocused (bool focus)

bool	isFocusEnabled ()

void	setFocusEnabled (bool enable)

virtual Widget	findNextFocusedWidget (FocusDirection direction, Widget current)
	当一个widget处于某一个layout中的时候，你可以通过调用这个方法在指定的方向获取下一个被focus的widget 如果一个widget没有在一个layout中，调用这个方法会获得该widget自身更多…

void	requestFocus ()
	当一个widget调用了这个方法，这个widget会立刻被focus 更多…

void	onFocusChange (Widget widgetLostFocus, Widget widgetGetFocus)
	这个方法会在focus状态发生改变的时候被调用更多…

void	dispatchFocusEvent (Widget widgetLoseFocus, Widget widgetGetFocus)
	通过EventDispatcher来调度EventFocus 更多…

Widget	getCurrentFocusedWidget (bool isWidget)
	不管你想要调用这个方法去获得什么样的widget对象，这个方法会返回给你被focus的widget 更多…

Public 成员函数继承自 ProtectedNode
virtual void	cleanup () override
	暂停所有的活动着的动作和调度器。更多…

virtual void	onEnterTransitionDidFinish () override
	当Node进入“stage”时，事件回调被调用。如果Node进入‘stage’并开始变换(transition)，此事件将在变换(transition)完成后被调用。如果你 override onEnterTransitionDidFinish, 你应该调用其父节点的此方法, 例如： Node::onEnterTransitionDidFinish() NA NA 更多…

virtual void	onExitTransitionDidStart () override
	事件回调在每次Node离开“stage”时被调用。如果Node离开‘stage’并开始变换(transition)，此事件将在变换(transition)开始时被调用。 NA NA 更多…

virtual void	updateDisplayedOpacity (GLubyte parentOpacity) override

virtual void	updateDisplayedColor (const Color3B &parentColor) override

virtual void	disableCascadeColor () override

virtual	~ProtectedNode ()

virtual void	addProtectedChild (Node child)
	添加一个z-order为0的child到容器中。更多…

virtual void	addProtectedChild (Node child, int localZOrder)
	添加一个child(定义localZOrder)到容器中。更多…

virtual void	addProtectedChild (Node child, int localZOrder, int tag)
	添加一个child(定义localZOrder，定义tag)到容器中。更多…

virtual Node	getProtectedChildByTag (int tag)
	从容器中获取child及其tag 更多…

virtual void	removeProtectedChild (Node child, bool cleanup=true)
	从容器中删除一个child。它也将清除所有运行中的动作(取决于cleanup的参数)。更多…

virtual void	removeProtectedChildByTag (int tag, bool cleanup=true)
	根据tag的值(value)来删除child。它也将清除所有运行中的动作(取决于cleanup的参数)。更多…

virtual void	removeAllProtectedChildren ()
	删除容器中所有child。更多…

virtual void	removeAllProtectedChildrenWithCleanup (bool cleanup)
	删除容器中所有child，并清理所有运行中的动作(取决于cleanup的参数)。更多…

virtual void	reorderProtectedChild (Node child, int localZOrder)
	重新排序(reorders)一个child依据其新z值(z vlaue)。(此z值应为localZOrder的值，原文简写为z value。译者注) 更多…

virtual void	sortAllProtectedChildren ()
	在绘制之前整理子节点数组(children array)，而不是每次子节点(child node)被添加或重新排序(reordered)时。此方法可以大大提高性能。更多…

Public 成员函数继承自 Node
virtual bool	isRunning () const
	返回节点是否是“running(活动的)”。更多…

void	scheduleUpdateWithPriorityLua (int handler, int priority)
	lua script的时间表 NA 更多…

virtual void	draw (Renderer renderer, const Mat4 &transform, bool transformUpdated)
	重写这个方法来绘制你自己的节点。以下的GL状态是默认开启的：更多…

virtual void	draw () final

virtual void	visit () final

virtual Scene	getScene ()
	返回包含Node(节点)的Scene（场景）。如果这个节点不属于任何的场景，它将返回`nullptr`。这个函数循环递归地调用parent->getScene() 直到父类是一个Scene对象。结果不会被缓存。只有当这个函数被用在一个循环中时，用户才会缓存这个结果。更多…

virtual Rect	getBoundingBox () const
	返回一个AABB(轴向包围盒)在它的父坐标系中。更多…

virtual CC_DEPRECATED_ATTRIBUTE Rect	boundingBox () const

virtual void	setEventDispatcher (EventDispatcher dispatcher)

virtual EventDispatcher	getEventDispatcher () const

virtual GLubyte	getDisplayedOpacity () const

virtual bool	isCascadeOpacityEnabled () const

virtual void	setCascadeOpacityEnabled (bool cascadeOpacityEnabled)

virtual const Color3B &	getDisplayedColor () const

virtual bool	isCascadeColorEnabled () const

virtual void	setCascadeColorEnabled (bool cascadeColorEnabled)

virtual void	setOpacityModifyRGB (bool bValue)

virtual bool	isOpacityModifyRGB () const

virtual	~Node ()

virtual bool	init ()

virtual void	setLocalZOrder (int localZOrder)
	LocalZOrder是“key”(关键)来分辨节点和它兄弟节点的相关性。更多…

virtual CC_DEPRECATED_ATTRIBUTE void	setZOrder (int localZOrder)

virtual void	_setLocalZOrder (int z)

virtual int	getLocalZOrder () const
	得到这个节点的局部Z顺序更多…

virtual CC_DEPRECATED_ATTRIBUTE int	getZOrder () const

virtual void	setGlobalZOrder (float globalZOrder)
	定义渲染节点的顺序拥有全局Z顺序越小的节点，最先渲染更多…

virtual float	getGlobalZOrder () const
	返回节点的全局Z顺序。更多…

virtual void	setScaleX (float scaleX)
	设置节点的缩放（x）。更多…

virtual float	getScaleX () const
	返回该节点的X轴的缩放因子。更多…

virtual void	setScaleY (float scaleY)
	设置节点的缩放（y）。更多…

virtual float	getScaleY () const
	返回该节点的Y轴的缩放因子。更多…

virtual void	setScaleZ (float scaleZ)
	改变该节点的Z轴的缩放因子。更多…

virtual float	getScaleZ () const
	返回该节点的梓州的缩放因子。更多…

virtual void	setScale (float scale)
	设置几点的缩放（x,y,z）. 更多…

virtual float	getScale () const
	得到该节点的缩放因子，当X轴和Y轴有相同的缩放因子时。更多…

virtual void	setScale (float scaleX, float scaleY)
	设置节点的缩放（x,y）. 更多…

virtual const Vec2 &	getPosition () const
	得到在父节点坐标系中节点的位置（x,y）。更多…

virtual void	setPosition (float x, float y)
	设置节点在它父节点坐标系中的位置（x,y）。更多…

virtual void	getPosition (float x, float y) const
	用一个更有效率的方法设置位置，返回两个数字而不是Vec2对象。更多…

virtual void	setPositionX (float x)
	分别得到或者设置位置的X或者Y轴坐标系这些方法被绑定使用在在Lua和JavaScript。更多…

virtual float	getPositionX (void) const

virtual void	setPositionY (float y)

virtual float	getPositionY (void) const

virtual void	setPosition3D (const Vec3 &position)
	设置在父节点坐标系中的位置（x,y,z）。更多…

virtual Vec3	getPosition3D () const
	返回父坐标系的位置（X,Y,Z）。更多…

virtual void	setPositionZ (float positionZ)
	设置位置的“z”轴坐标系，是OpneGL Z 定点值。更多…

virtual CC_DEPRECATED_ATTRIBUTE void	setVertexZ (float vertexZ)

virtual float	getPositionZ () const
	得到该节点的Z轴坐标系的位置。更多…

virtual CC_DEPRECATED_ATTRIBUTE float	getVertexZ () const

virtual void	setSkewX (float skewX)
	改变该节点X轴的倾斜角，单位是度。更多…

virtual float	getSkewX () const
	返回该节点的X轴倾斜角，单位是度。更多…

virtual void	setSkewY (float skewY)
	改变该节点Y轴的倾斜角，单位是度。更多…

virtual float	getSkewY () const
	返回该节点的Y轴倾斜角，单位是度。更多…

virtual void	setAnchorPoint (const Vec2 &anchorPoint)
	设置锚点，用百分比表示。更多…

virtual const Vec2 &	getAnchorPoint () const
	返回用百分比表示的锚点。更多…

virtual const Vec2 &	getAnchorPointInPoints () const
	返回绝对像素的锚点更多…

virtual void	setContentSize (const Size &contentSize)
	设置不转换节点的大小。更多…

virtual const Size &	getContentSize () const
	返回未转换节点的大小。更多…

virtual void	setVisible (bool visible)
	设置节点是否可见。更多…

virtual bool	isVisible () const
	决定节点是否可见。更多…

virtual void	setRotation (float rotation)
	设置节点的旋转（angle）角度。更多…

virtual float	getRotation () const
	返回节点的旋转角度。更多…

virtual void	setRotation3D (const Vec3 &rotation)
	设置（X,Y,Z）旋转角度。对3d旋转非常有用。更多…

virtual Vec3	getRotation3D () const
	返回（X,Y,Z）的旋转角度。更多…

virtual void	setRotationSkewX (float rotationX)
	设置节点X轴的旋转角度，表现为水平旋转倾斜。更多…

virtual CC_DEPRECATED_ATTRIBUTE void	setRotationX (float rotationX)

virtual float	getRotationSkewX () const
	得到X轴节点的旋转角度，表现为水平旋转倾斜（horizontal rotation skew）. 更多…

virtual CC_DEPRECATED_ATTRIBUTE float	getRotationX () const

virtual void	setRotationSkewY (float rotationY)
	设置Y轴节点的旋转角度，表现为垂直旋转倾斜。更多…

virtual CC_DEPRECATED_ATTRIBUTE void	setRotationY (float rotationY)

virtual float	getRotationSkewY () const
	得到节点Y轴的旋转角度，表现为垂直旋转倾斜（vertical rotational skew. 更多…

virtual CC_DEPRECATED_ATTRIBUTE float	getRotationY () const

void	setOrderOfArrival (int orderOfArrival)
	设置到达顺序，当这个节点和其他子节点有相同的ZOrder时。更多…

int	getOrderOfArrival () const
	返回到达顺序，指出哪一个子类先被添加。更多…

CC_DEPRECATED_ATTRIBUTE void	setGLServerState (int serverState)

CC_DEPRECATED_ATTRIBUTE int	getGLServerState () const

virtual void	ignoreAnchorPointForPosition (bool ignore)
	设置抹点为（0,0）当你摆放这个节点的时候。更多…

virtual bool	isIgnoreAnchorPointForPosition () const
	得到节点的锚点是否为（0,0），当你摆放这个节点时。更多…

virtual void	addChild (Node child)
	添加一个子节点到容器内，z-order是0. 更多…

virtual void	addChild (Node child, int localZOrder)
	添加一个子节点到容器中，参数有一个局部Z轴顺序。更多…

virtual void	addChild (Node child, int localZOrder, int tag)
	添加一个子节点到容器中，有Z轴顺序和一个标记。更多…

virtual Node	getChildByTag (int tag)
	从容器中得到一个子节点通过它的标记。更多…

virtual Vector< Node > &	getChildren ()
	返回子节点数组。更多…

virtual const Vector< Node > &	getChildren () const

virtual ssize_t	getChildrenCount () const
	返回子节点的总数更多…

virtual void	setParent (Node parent)
	设置父节点Sets the parent node 更多…

virtual Node	getParent ()
	返回指向父节点的指针。更多…

virtual const Node	getParent () const

virtual void	removeFromParent ()
	从父节点中删除一个节点，有一个cleanup参数。如果这个节点是一个孤节点，那么什么都不会发生。更多…

virtual void	removeFromParentAndCleanup (bool cleanup)
	从父节点中删除一个节点如果这个节点是一个孤节点，那么什么都不会发生。更多…

virtual void	removeChild (Node child, bool cleanup=true)
	从容器中删除一个孩子，取决于cleanup参数同时会清除所有的活动的动作。更多…

virtual void	removeChildByTag (int tag, bool cleanup=true)
	从一个容器中删除一个孩子通过标记值。取决于cleanup参数同时会清除所有的活动的动作。更多…

virtual void	removeAllChildren ()
	从容器中删除所有的孩子，with a cleanup。更多…

virtual void	removeAllChildrenWithCleanup (bool cleanup)
	从容器中删除所有的孩子, 取决于cleanup参数同时会清除所有的活动的动作。更多…

virtual void	reorderChild (Node child, int localZOrder)
	对一个孩子重新排序，设定一个新的z轴的值。更多…

virtual void	sortAllChildren ()
	在绘画之前，排列所有的孩子数组一次，而不是每次添加或者删除子节点时都排序。这个方法可以大量地提高性能。更多…

virtual int	getTag () const
	返回一个用来更简单分辨节点的标记。更多…

virtual void	setTag (int tag)
	改变这个用来更容易分辨节点的标记。更多…

virtual void	getUserData ()
	返回一个自定义用户数据的指针。更多…

virtual const void	getUserData () const
	NA NA 更多…

virtual void	setUserData (void userData)
	设置一个自定义用户数据的指针。更多…

virtual Ref	getUserObject ()
	返回一个用户分配的对象更多…

virtual const Ref	getUserObject () const
	NA NA 更多…

virtual void	setUserObject (Ref userObject)
	返回一个用户分配的对象更多…

GLProgram	getGLProgram ()
	返回当前用于这个节点的GLProgram (shader) 更多…

CC_DEPRECATED_ATTRIBUTE GLProgram	getShaderProgram ()

GLProgramState	getGLProgramState ()

void	setGLProgramState (GLProgramState glProgramState)

void	setGLProgram (GLProgram glprogram)
	为这个节点设置着色器程序更多…

CC_DEPRECATED_ATTRIBUTE void	setShaderProgram (GLProgram glprogram)

virtual void	setActionManager (ActionManager actionManager)
	设置被所有动作使用的ActionManager对象。更多…

virtual ActionManager	getActionManager ()
	得到被所有动作使用的ActionManager对象。更多…

virtual const ActionManager	getActionManager () const

Action	runAction (Action action)
	执行一个动作，并且返回执行的该动作。更多…

void	stopAllActions ()
	停止并且删除所有的动作从活动动作列表中。更多…

void	stopAction (Action action)
	停止并且删除所有的动作从活动动作列表中。更多…

void	stopActionByTag (int tag)
	通过动作的标记从活动动作列表中删除一个动作。更多…

Action	getActionByTag (int tag)
	通过动作的标记从活动动作列表中得到一个动作。更多…

ssize_t	getNumberOfRunningActions () const
	返回活动着的动作加上正在调度运行的动作的总数 (在actionsToAdd状态的动作和动作数组中的). 更多…

CC_DEPRECATED_ATTRIBUTE ssize_t	numberOfRunningActions () const

virtual void	setScheduler (Scheduler scheduler)
	设置一个调度器对象来用于调度所有的“update”和定时器。更多…

virtual Scheduler	getScheduler ()
	得到调度器对象。更多…

virtual const Scheduler	getScheduler () const

bool	isScheduled (SEL_SCHEDULE selector)
	检查是否一个选择器是预定的。更多…

void	scheduleUpdate (void)
	调度“update”方法。更多…

void	scheduleUpdateWithPriority (int priority)
	调度这个"update"方法伴随着一个自定义优先级。更多…

void	unscheduleUpdate (void)

void	schedule (SEL_SCHEDULE selector, float interval, unsigned int repeat, float delay)
	调度一个自定义的选择器。更多…

void	schedule (SEL_SCHEDULE selector, float interval)
	调度一个自定义的选择器伴随着一个以秒为单位的内部时间。更多…

void	scheduleOnce (SEL_SCHEDULE selector, float delay)
	调度一个只运行一次的选择器，伴随着一个0或者更大的延期。更多…

void	schedule (SEL_SCHEDULE selector)
	调度一个自定义的选择器，这个调度后的选择器将会以每帧为时间间隔。更多…

void	unschedule (SEL_SCHEDULE selector)
	不调度一个自定义的选择器。更多…

void	unscheduleAllSelectors (void)
	不调度所有的调度过的选择器：自定义选择器, 和 'update' 选择器。动作不受这个方法的影响。 NA 更多…

void	resume (void)
	恢复所有的调度过的选择器，动作和事件监听器。这个方法被onEnter方法在内部调用。更多…

void	pause (void)
	暂停所有的调度过的选择器，动作和事件监听器。这个方法被onExit方法在内部调用。更多…

CC_DEPRECATED_ATTRIBUTE void	resumeSchedulerAndActions (void)
	恢复所有的调度过的选择器，动作和事件监听器。这个方法被onEnter方法在内部调用。更多…

CC_DEPRECATED_ATTRIBUTE void	pauseSchedulerAndActions (void)
	暂停所有的调度过的选择器，动作和事件监听器。这个方法被onExit方法在内部调用。更多…

virtual void	update (float delta)

virtual void	updateTransform ()
	递归的调用孩子的updateTransform()方法。更多…

virtual const Mat4 &	getNodeToParentTransform () const
	返回这个将节点（局部）的空间坐标系转换成父节点的空间坐标系的矩阵。这个矩阵以像素为单位。更多…

virtual AffineTransform	getNodeToParentAffineTransform () const

virtual void	setNodeToParentTransform (const Mat4 &transform)
	手动设置变换矩阵。更多…

virtual CC_DEPRECATED_ATTRIBUTE AffineTransform	nodeToParentTransform () const

virtual const Mat4 &	getParentToNodeTransform () const
	返回这个将父节点的空间坐标系转换成节点（局部）的空间坐标系转的矩阵。这个矩阵以像素为单位。更多…

virtual AffineTransform	getParentToNodeAffineTransform () const

virtual CC_DEPRECATED_ATTRIBUTE AffineTransform	parentToNodeTransform () const

virtual Mat4	getNodeToWorldTransform () const
	返回世界仿射变换矩阵。矩阵单位是像素。更多…

virtual AffineTransform	getNodeToWorldAffineTransform () const

virtual CC_DEPRECATED_ATTRIBUTE AffineTransform	nodeToWorldTransform () const

virtual Mat4	getWorldToNodeTransform () const
	返回逆世界仿射变换矩阵。矩阵单位是像素。更多…

virtual AffineTransform	getWorldToNodeAffineTransform () const

virtual CC_DEPRECATED_ATTRIBUTE AffineTransform	worldToNodeTransform () const

Vec2	convertToNodeSpace (const Vec2 &worldPoint) const
	将Vec2 转换成节点 (局部) 空间坐标系。结果按以Points为单位。更多…

Vec2	convertToWorldSpace (const Vec2 &nodePoint) const
	将Vec2转换成世界空间坐标系。结果按以Points为单位。更多…

Vec2	convertToNodeSpaceAR (const Vec2 &worldPoint) const
	将Vec2转换成节点(局部)空间坐标系. 更多…

Vec2	convertToWorldSpaceAR (const Vec2 &nodePoint) const
	将局部的Vec2转换成世界空间坐标系。结果按以Points为单位。将returned/received节点的point当作相对应的锚点。更多…

Vec2	convertTouchToNodeSpace (Touch touch) const
	一个方便的方法将触摸转换成Vec2 更多…

Vec2	convertTouchToNodeSpaceAR (Touch touch) const
	将Touch (世界坐标系) 转换成局部坐标系。这个方法是AR (相对的锚点). 更多…

void	setAdditionalTransform (Mat4 additionalTransform)
	为节点设置一个附加转换矩阵。更多…

void	setAdditionalTransform (const AffineTransform &additionalTransform)

Component	getComponent (const std::string &pName)
	通过名字得到组件更多…

virtual bool	addComponent (Component pComponent)
	添加一个组件更多…

virtual bool	removeComponent (const std::string &pName)
	通过名字删除一个组件更多…

virtual void	removeAllComponents ()
	删除所有组件更多…

Public 成员函数继承自 Ref
void	retain ()
	保留所有权. 更多…

void	release ()
	立即释放所有权. 更多…

Ref	autorelease ()
	自动释放所有权在不久的将来. 更多…

unsigned int	getReferenceCount () const
	返回Ref对象当前的引用计数. 更多…

virtual	~Ref ()
	NA NA 更多…

## 静态 Public 成员函数
static Widget	create ()
	分配空间并初始化widget 更多…

静态 Public 成员函数继承自 ProtectedNode
static ProtectedNode	create (void)

静态 Public 成员函数继承自 Node
static Node *	create (void)
	分配并且初始化一个节点. 更多…

## Public 属性
CC_CONSTRUCTOR_ACCESS	pad0: virtual bool init() override

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

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

Public 属性继承自 ProtectedNode
CC_CONSTRUCTOR_ACCESS	pad0: ProtectedNode()

Public 属性继承自 Node
CC_CONSTRUCTOR_ACCESS	pad0: Node()

## Protected 成员函数
virtual void	onSizeChanged ()

virtual void	initRenderer ()

virtual void	onPressStateChangedToNormal ()

virtual void	onPressStateChangedToPressed ()

virtual void	onPressStateChangedToDisabled ()

void	pushDownEvent ()

void	moveEvent ()

void	releaseUpEvent ()

void	cancelUpEvent ()

virtual void	updateTextureColor ()

virtual void	updateTextureOpacity ()

virtual void	updateTextureRGBA ()

virtual void	updateFlippedX ()

virtual void	updateFlippedY ()

void	updateColorToRenderer (Node renderer)

void	updateOpacityToRenderer (Node renderer)

void	updateRGBAToRenderer (Node renderer)

void	copyProperties (Widget model)

virtual Widget	createCloneInstance ()

virtual void	copySpecialProperties (Widget model)

virtual void	copyClonedWidgetChildren (Widget model)

Widget	getWidgetParent ()

void	updateContentSizeWithTextureSize (const Size &size)

virtual void	adaptRenderers ()

bool	isAncestorsEnabled ()

Widget	getAncensterWidget (Node node)

bool	isAncestorsVisible (Node node)

Protected 成员函数继承自 ProtectedNode
void	insertProtectedChild (Node child, int z)
	helper重新排序一个child 更多…

Protected 成员函数继承自 Node
void	childrenAlloc (void)
	较慢的分配更多…

void	insertChild (Node child, int z)
	记录孩子的助手更多…

void	detachChild (Node child, ssize_t index, bool doCleanup)
	删除一个孩子，调用child->onExit(), 从子数列中做清理，并删除它。更多…

Vec2	convertToWindowSpace (const Vec2 &nodePoint) const
	转换cocos2d 坐标系到用户界面窗口坐标更多…

Mat4	transform (const Mat4 &parentTransform)

virtual void	updateCascadeOpacity ()

virtual void	disableCascadeOpacity ()

virtual void	updateCascadeColor ()

virtual void	updateColor ()

Protected 成员函数继承自 Ref
	Ref ()
	构造函数更多…

## Protected 属性
bool	_enabled
	widget的最高控制更多…

bool	_bright
	widget是否为亮色（bright）更多…

bool	_touchEnabled
	widget是否能响应触摸更多…

bool	_highlight
	widget是否被focus 更多…

BrightStyle	_brightStyle
	亮色风格（bright style）更多…

Vec2	_touchStartPos
	触摸开始点更多…

Vec2	_touchMovePos
	触摸移动点更多…

Vec2	_touchEndPos
	触摸结束点更多…

Ref	_touchEventListener

SEL_TouchEvent	_touchEventSelector

ccWidgetTouchCallback	_touchEventCallback

std::string	_name

int	_actionTag

Size	_size

Size	_customSize

bool	_ignoreSize

bool	_affectByClipping

SizeType	_sizeType

Vec2	_sizePercent

PositionType	_positionType

Vec2	_positionPercent

bool	_reorderWidgetChildDirty

bool	_hitted

EventListenerTouchOneByOne	_touchListener

Color3B	_color

GLubyte	_opacity

bool	_flippedX

bool	_flippedY

Map< int, LayoutParameter >	_layoutParameterDictionary

bool	_focused

bool	_focusEnabled

Protected 属性继承自 ProtectedNode
Vector< Node >	_protectedChildren
	子节点(children nodes)数组更多…

bool	_reorderProtectedChildDirty

Protected 属性继承自 Node
float	_rotationX
	X轴的旋转更多…

float	_rotationY
	Y轴的旋转更多…

float	_rotationZ_X
	旋转角度在Z轴，组件X轴更多…

float	_rotationZ_Y
	旋转角度在Z轴，组件Y轴更多…

float	_scaleX
	X轴的缩放因子更多…

float	_scaleY
	Y轴的缩放因子更多…

float	_scaleZ
	Z轴的缩放因子更多…

Vec2	_position
	节点的位置更多…

float	_positionZ
	OpenGL 真正Z轴坐标位置更多…

float	_skewX
	X轴的倾斜角更多…

float	_skewY
	Y轴的倾斜角更多…

Vec2	_anchorPointInPoints
	锚点以points为单位更多…

Vec2	_anchorPoint
	正常的锚点(不是以points为单位的) 更多…

Size	_contentSize
	未转换节点的大小更多…

Mat4	_modelViewTransform
	节点的模型视图变换更多…

Mat4	_transform
	变换更多…

bool	_transformDirty
	transform dirty flag 更多…

Mat4	_inverse
	逆变换更多…

bool	_inverseDirty
	inverse transform dirty flag 更多…

Mat4	_additionalTransform
	变换更多…

bool	_useAdditionalTransform
	The flag to check whether the additional transform is dirty. 更多…

bool	_transformUpdated
	是否Transform 对象在最后一帧更新了更多…

int	_localZOrder
	Local 顺序 (和兄妹节点相关) 被用于节点的排序更多…

float	_globalZOrder
	Global 顺序用于节点的排序更多…

Vector< Node >	_children
	子节点数列更多…

Node	_parent
	父节点的弱引用更多…

int	_tag
	一个标记. 你可以定义任何的数字来分辨这个节点更多…

std::string	_name
	一个字符串标签, 一个用户定义的字符串来分辨这个节点更多…

void	_userData
	一个用户分配的空指针，能够指向任何cpp对象更多…

Ref	_userObject
	一个用户分配的对象更多…

GLProgramState	_glProgramState
	OpenGL Program State. 更多…

int	_orderOfArrival
	用于保存序列当对有相同localZOrder的子节点进行排序更多…

Scheduler	_scheduler
	调度器用于调度定时器和更新更多…

ActionManager	_actionManager
	一个指向ActionManager singleton模式的指针, 用于操作所有的动作。更多…

EventDispatcher	_eventDispatcher
	事件调度器使用调度各种事件更多…

bool	_running
	活动中更多…

bool	_visible
	节点可见更多…

bool	_ignoreAnchorPointForPosition
	true 如果锚点 Vec2 是 (0,0) 当你拜访节点时, false则不是（0，0）更多…

bool	_reorderChildDirty
	children order dirty flag 更多…

bool	_isTransitionFinished
	一个表明转换是否完成的标记更多…

ComponentContainer *	_componentContainer
	Dictionary of components. 更多…

GLubyte	_displayedOpacity

GLubyte	_realOpacity

Color3B	_displayedColor

Color3B	_realColor

bool	_cascadeColorEnabled

bool	_cascadeOpacityEnabled

Protected 属性继承自 Ref
unsigned int	_referenceCount
	引用计数更多…

## 静态 Protected 属性
static Widget	_focusedWidget
	储存唯一一个处于被focus状态的widget 更多…

static Widget	_realFocusedWidget

静态 Protected 属性继承自 Node
static int	s_globalOrderOfArrival

## 额外继承的成员函数
静态 Public 属性继承自 Node
static const int	INVALID_TAG = -1
	默认的标记用于所有的节点更多…

详细描述

NA NA

成员类型定义说明

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

成员枚举类型说明

enum BrightStyle

strong

枚举值
NONE
NORMAL
HIGHLIGHT

enum FocusDirection

strong

枚举值
LEFT
RIGHT
UP
DOWN

enum PositionType

strong

枚举值
ABSOLUTE
PERCENT

enum SizeType

strong

枚举值
ABSOLUTE
PERCENT

enum TextureResType

strong

枚举值
LOCAL
PLIST

enum TouchEventType

strong

枚举值
BEGAN
MOVED
ENDED
CANCELED

构造及析构函数说明

Widget

(

void

)

默认构造函数

virtual ~Widget

(

)

virtual

默认析构函数

成员函数说明

virtual void adaptRenderers

(

)

inlineprotectedvirtual

被 Slider, CheckBox, Button, TextField, Text, LoadingBar, ImageView, TextAtlas , 以及 TextBMFont 重载.

CC_DEPRECATED_ATTRIBUTE void addTouchEventListener	(	Ref *	target,
		SEL_TouchEvent	selector
	)

为菜单项的目标／选择器设置触摸事件

void addTouchEventListener

(

ccWidgetTouchCallback

callback

)

void cancelUpEvent

(

)

protected

virtual void checkChildInfo	(	int	handleState,
		Widget *	sender,
		const Vec2 &	touchPoint
	)

virtual

被 ScrollView , 以及 PageView 重载.

bool clippingParentAreaContainPoint

(

const Vec2 &

)

Widget* clone

(

)

virtual void copyClonedWidgetChildren

(

Widget *

model

)

protectedvirtual

被 ScrollView, Layout, ListView , 以及 PageView 重载.

void copyProperties

(

Widget *

model

)

protected

virtual void copySpecialProperties

(

Widget *

model

)

protectedvirtual

被 ScrollView, Layout, Slider, CheckBox, Button, ListView, PageView, TextField, Text, LoadingBar, ImageView, TextAtlas , 以及 TextBMFont 重载.

static Widget* create

(

)

static

分配空间并初始化widget

virtual Widget* createCloneInstance

(

)

protectedvirtual

被 ScrollView, Layout, Slider, CheckBox, Button, ListView, PageView, TextField, Text, LoadingBar, ImageView, TextAtlas , 以及 TextBMFont 重载.

void dispatchFocusEvent	(	Widget	widgetLoseFocus,
		Widget	widgetGetFocus
	)

通过EventDispatcher来调度EventFocus

参数
widgetLoseFocus失去focus状态的widget widgetGetFocus得到focus状态的widget

返回
void

virtual Widget findNextFocusedWidget	(	FocusDirection	direction,
		Widget	current
	)

virtual

当一个widget处于某一个layout中的时候，你可以通过调用这个方法在指定的方向获取下一个被focus的widget 如果一个widget没有在一个layout中，调用这个方法会获得该widget自身

参数
dir在该layout中找寻下一个被focus的widget的方向 current目前被focus的widget

返回
该layout中下一个被focus的widget

int getActionTag

(

)

Widget getAncensterWidget

(

Node

node

)

protected

float getBottomInParent

(

)

获取该widget底部边界纵坐标

返回
该widget底部边界纵坐标

virtual Widget* getChildByName

(

const std::string &

name

)

virtual

通过名字从容器中获取一个子节点

参数
name用于找到所需widget子节点的关键字（key）

返回
名字与输入的参数相同的widget

被 ScrollView, ListView , 以及 PageView 重载.

const Color3B& getColor

(

void

)

const

inlineoverridevirtual

重载 Node .

Widget* getCurrentFocusedWidget

(

bool

isWidget

)

不管你想要调用这个方法去获得什么样的widget对象，这个方法会返回给你被focus的widget

参数
isWidget如果你将参数isWidget设置为true，这个方法会返回_realFocusedWidget，它只是一个widget类的变量；如果你将参数isWidget设置为false，这个方法会返回一个widget类变量或者一个layout类变量

const Size& getCustomSize

(

)

const

virtual std::string getDescription

(

)

const

overridevirtual

返回widget的类名

重载 Node .

被 ScrollView, Slider, Layout, CheckBox, ListView, Button, PageView, TextField, Text, LoadingBar, ImageView, RichText, TextAtlas , 以及 TextBMFont 重载.

LayoutParameter* getLayoutParameter

(

LayoutParameter::Type

type

)

获取widget的LayoutParameter

参见
LayoutParameter

参数
type相对的或者线性的

返回
LayoutParameter

virtual const Size& getLayoutSize

(

)

inlinevirtual

被 ScrollInnerContainer 重载.

float getLeftInParent

(

)

获取该widget左边界横坐标

返回
该widget左边界横坐标

const std::string& getName

(

)

const

返回widget的名字，使用名字可以更轻松地识别出该widget

你可以为widget设置标签（tag）以更好地识别他们

返回
一个可用于识别该widget的字符串常量（const std::string）

GLubyte getOpacity

(

void

)

const

inlineoverridevirtual

重载 Node .

const Vec2& getPositionPercent

(

)

获取该widget在OpenGL坐标系中的相对百分比位置坐标(x,y)

参见
setPosition(const Vec2&)

返回
该widget在OpenGL坐标系中的相对百分比位置坐标(x,y)

PositionType getPositionType

(

)

const

获取该widget的位置坐标类型

参见
PositionType

返回
type 该widget的位置坐标类型

float getRightInParent

(

)

获取该widget右边界横坐标

返回
该widget右边界横坐标

const Size& getSize

(

)

const

返回widget的尺寸（size）

返回
size

const Vec2& getSizePercent

(

)

const

返回widget的尺寸百分比

返回
size percent

SizeType getSizeType

(

)

const

获取widget的尺寸类型（size type）

参见
SizeType

参数
typewidget的尺寸类型（size type）

float getTopInParent

(

)

获取该widget顶部边界纵坐标

返回
该widget顶部边界纵坐标

const Vec2& getTouchEndPos

(

)

const Vec2& getTouchMovePos

(

)

const Vec2& getTouchStartPos

(

)

virtual Node* getVirtualRenderer

(

)

virtual

获取widget的虚拟渲染器

比如说，按钮的虚拟渲染器渲染器就是该按钮的纹理贴图的渲染器

返回
Node pointer.

被 Slider, CheckBox, Button, TextField, Text, LoadingBar, ImageView, TextAtlas , 以及 TextBMFont 重载.

virtual const Size& getVirtualRendererSize

(

)

const

virtual

获取widget的content size

Content size是指widget所用纹理贴图的尺寸

被 Slider, CheckBox, Button, TextField, Text, LoadingBar, ImageView, RichText, TextAtlas , 以及 TextBMFont 重载.

Widget* getWidgetParent

(

)

protected

Vec2 getWorldPosition

(

)

获取widget在全局中的位置坐标

返回
widget在全局中的位置坐标

virtual bool hitTest

(

const Vec2 &

)

virtual

检查一个点是否在该widget所在区域

参数
point

返回
如果改点在widget所在区域则返回true，不在widget所在区域则返回false

被 Slider , 以及 TextField 重载.

virtual void ignoreContentAdaptWithSize

(

bool

ignore

)

virtual

忽略widget的尺寸（size）

参数
ignore,参数为true则忽略widget的尺寸，使用纹理贴图的尺寸，参数为false则不忽略widget的尺寸。参数的默认值为true

被 Slider, Button, LoadingBar, RichText , 以及 ImageView 重载.

virtual void initRenderer

(

)

protectedvirtual

被 ScrollView, Slider, CheckBox, Button, TextField, Text, LoadingBar, ImageView, RichText, TextAtlas , 以及 TextBMFont 重载.

bool isAncestorsEnabled

(

)

protected

bool isAncestorsVisible

(

Node *

node

)

protected

bool isBright

(

)

const

判断该widget是否为亮色

返回
亮色则返回true，暗色则返回false

bool isEnabled

(

)

const

判断该widget是否可用

返回
可用则返回true，不可用则返回false

virtual bool isFlippedX

(

)

inlinevirtual

返回表明该widget是否被水平翻转的标识

只会翻转该widget自身的纹理贴图（texture），不会翻转其子节点（child）的纹理贴图并且翻转不会改变anchorPoint 如果你想要翻转anchorPoint，并且／或者翻转该widget的子节点，你应该使用: widget->setScaleX(sprite->getScaleX() * -1);

返回
如果该widget被水平翻转则返回true，该widget没有被水平翻转则返回false

virtual bool isFlippedY

(

)

inlinevirtual

返回表明该widget是否被垂直翻转的标识

只会翻转该widget自身的纹理贴图（texture），不会翻转其子节点（child）的纹理贴图并且翻转不会改变anchorPoint 如果你想要翻转anchorPoint，并且／或者翻转该widget的子节点，你应该使用: widget->setScaleY(sprite->getScaleY() * -1);

返回
如果该widget被垂直翻转则返回true，该widget没有被垂直翻转则返回false

CC_DEPRECATED_ATTRIBUTE bool isFlipX

(

)

inline

弃用:
使用 isFlippedX() 作为替代

CC_DEPRECATED_ATTRIBUTE bool isFlipY

(

)

inline

弃用:
使用 isFlippedY() 作为替代

bool isFocused

(

)

返回
widget是否被focus

bool isFocusEnabled

(

)

返回
如果widget可以被focus则返回true，如果widget不能被focus则返回false

bool isHighlighted

(

)

const

判定该widget是否为高亮（对应被选中状态）

返回
如果该widget处于高亮状态则返回true，如果该widget不处于高亮状态则返回false

bool isIgnoreContentAdaptWithSize

(

)

const

检查该widget的尺寸（size）是否被忽略

参数
参数为true则忽略widget的尺寸，使用纹理贴图的尺寸，参数为false则不忽略widget的尺寸。参数的默认值为true

bool isTouchEnabled

(

)

const

判定该widget是否可以响应触摸

返回
如果可以响应触摸则返回true，不能响应触摸则返回false

void moveEvent

(

)

protected

virtual void onEnter

(

)

overridevirtual

每次当Node进入“stage”时才调用事件回调。如果Node进入“stage”状态时伴随着一个转换（transition）,那么事件将会在这个转换开始的时候被调用。在onEnter过程中，你不能够接入“sister/brother”兄妹节点。如果你重写了onEnter方法，你应该调用它的父类，e.g., Node::onEnter().

NA NA

重载 ProtectedNode .

被 ScrollView, Layout, PageView , 以及 TextField 重载.

virtual void onExit

(

)

overridevirtual

事件回调在每次Node离开“stage”时被调用。如果Node离开‘stage’并开始变换(transition)，此事件将在变换(transition)完成后被调用。在 onExit执行期间你不能访问兄弟节点(sibling node)。如果你 override onExit, 你应该调用其父节点的此方法，例如, Node::onExit().

NA NA

重载 ProtectedNode .

被 Layout 重载.

void onFocusChange	(	Widget	widgetLostFocus,
		Widget	widgetGetFocus
	)

这个方法会在focus状态发生改变的时候被调用

参数
widgetLostFocus失去focus状态的widget widgetGetFocus得到focus状态的widget

返回
void

virtual void onPressStateChangedToDisabled

(

)

protectedvirtual

被 Slider, CheckBox, Button , 以及 Text 重载.

virtual void onPressStateChangedToNormal

(

)

protectedvirtual

被 Slider, CheckBox, Button , 以及 Text 重载.

virtual void onPressStateChangedToPressed

(

)

protectedvirtual

被 Slider, CheckBox, Button , 以及 Text 重载.

virtual void onSizeChanged

(

)

protectedvirtual

被 ScrollView, Layout, Slider, CheckBox, ListView, PageView, Button, TextField, Text, LoadingBar, ImageView, TextAtlas , 以及 TextBMFont 重载.

virtual bool onTouchBegan	(	Touch	touch,
		Event	unusedEvent
	)

virtual

被 ScrollView, Slider, PageView , 以及 TextField 重载.

virtual void onTouchCancelled	(	Touch	touch,
		Event	unusedEvent
	)

virtual

被 ScrollView, Slider , 以及 PageView 重载.

virtual void onTouchEnded	(	Touch	touch,
		Event	unusedEvent
	)

virtual

被 ScrollView, Slider, CheckBox , 以及 PageView 重载.

virtual void onTouchMoved	(	Touch	touch,
		Event	unusedEvent
	)

virtual

被 ScrollView, Slider , 以及 PageView 重载.

void pushDownEvent

(

)

protected

void releaseUpEvent

(

)

protected

void requestFocus

(

)

当一个widget调用了这个方法，这个widget会立刻被focus

void setActionTag

(

int

tag

)

void setBright

(

bool

bright

)

设置widget是否为亮色（对应可用状态）

默认值为true，widget默认为亮色

参数
visible参数为true则设置该widget为亮色，参数为false则设置该widget为暗色（dark，对应禁用状态）。

void setBrightStyle

(

BrightStyle

style

)

设置widget的亮色风格（bright style）

参见
BrightStyle

参数
styleBRIGHT_NORMAL 表示该widget为普通亮色, BRIGHT_HIGHLIGHT 表示该widget为高亮

virtual void setColor

(

const Color3B &

color

)

overridevirtual

重载 Node .

virtual void setEnabled

(

bool

enabled

)

virtual

设置widget是否为可用

参数为true则设置该widget可用，该widget可以响应触摸；参数为false则设置该widget不可用，该widget不能响应触摸

参数默认值为true，widget默认为可用

参数
enabled

virtual void setFlippedX

(

bool

flippedX

)

virtual

设置该widget是否应该被水平翻转.

参数
bFlippedXtrue 该widget应该被水平翻转, false 该widget不应被水平翻转.

virtual void setFlippedY

(

bool

flippedY

)

virtual

设置该widget是否应该被垂直翻转.

参数
bFlippedXtrue 该widget应该被垂直翻转, false 该widget不应被垂直翻转.

CC_DEPRECATED_ATTRIBUTE void setFlipX

(

bool

flipX

)

inline

弃用:
使用 setFlippedX() 作为替代

CC_DEPRECATED_ATTRIBUTE void setFlipY

(

bool

flipY

)

inline

弃用:
使用 setFlippedY() 作为替代

void setFocused

(

bool

focus

)

参数
focus传递参数true来使得widget处于focus状态或者传递参数false来取消focus状态

返回
void

void setFocusEnabled

(

bool

enable

)

参数
enable传递参数true/flase来使得widget可以／不可以被focus

返回
void

void setHighlighted

(

bool

hilight

)

设置该widget是否处于高亮状态（对应被选中状态）

默认值为false，widget默认为处于非高亮状态

参数
hilight参数为true则设置该widget为高亮状态，参数为false则设置该widget为非高亮状态

void setLayoutParameter

(

LayoutParameter *

parameter

)

为widget设置LayoutParameter

参见
LayoutParameter

参数
LayoutParameterLayoutParameter指针 type相对的（relative）或者线性的（linear）

void setName

(

const std::string &

name

)

改变widget的名字，使用名字可以更轻松地识别出该widget

参数
一个可用于识别该widget的字符串常量（conststd::string）

virtual void setOpacity

(

GLubyte

opacity

)

overridevirtual

重载 Node .

virtual void setPosition

(

const Vec2 &

pos

)

overridevirtual

改变该widget在OpenGL坐标系中的绝对位置坐标（x,y）

我们通常使用p(x,y)来组成Vec2对象原点（0，0）位于屏幕的左下方

参数
position该widget在OpenGL坐标系中的绝对位置坐标(x,y)

重载 Node .

void setPositionPercent

(

const Vec2 &

percent

)

改变该widget在OpenGL坐标系中的相对百分比位置坐标（x,y）

我们通常使用p(x,y)来组成Vec2对象原点（0，0）位于屏幕的左下方

参数
percent该widget在OpenGL坐标系中的相对百分比位置坐标(x,y)

void setPositionType

(

PositionType

type

)

改变该widget的位置坐标类型

参见
PositionType

参数
type该widget的位置坐标类型

virtual void setSize

(

const Size &

size

)

virtual

改变widget的尺寸（size）

参数
sizewidget的尺寸（size）

virtual void setSizePercent

(

const Vec2 &

percent

)

virtual

改变widget的百分比尺寸（percent size）

参数
percentidget的百分比尺寸（percent size）

void setSizeType

(

SizeType

type

)

改变widget的尺寸类型（size type）

参见
SizeType

参数
typewidget的尺寸类型（size type）

virtual void setTouchEnabled

(

bool

enabled

)

virtual

设置widget是否可以响应触摸。

默认值为false，widget默认为不能响应触摸

参数
visible参数为true则设置该widget可以响应触摸，参数为false则设置该widget不能响应触摸

void updateColorToRenderer

(

Node *

renderer

)

protected

void updateContentSizeWithTextureSize

(

const Size &

size

)

protected

virtual void updateFlippedX

(

)

inlineprotectedvirtual

被 CheckBox, Button, Text , 以及 ImageView 重载.

virtual void updateFlippedY

(

)

inlineprotectedvirtual

被 CheckBox, Button, Text , 以及 ImageView 重载.

void updateOpacityToRenderer

(

Node *

renderer

)

protected

void updateRGBAToRenderer

(

Node *

renderer

)

protected

void updateSizeAndPosition

(

)

void updateSizeAndPosition

(

const Size &

parentSize

)

virtual void updateTextureColor

(

)

inlineprotectedvirtual

被 Slider, CheckBox, Button, TextField, Text, LoadingBar, ImageView, TextAtlas , 以及 TextBMFont 重载.

virtual void updateTextureOpacity

(

)

inlineprotectedvirtual

被 Slider, CheckBox, Button, TextField, Text, LoadingBar, ImageView, TextAtlas , 以及 TextBMFont 重载.

virtual void updateTextureRGBA

(

)

inlineprotectedvirtual

被 Slider, CheckBox, Button, TextField, Text, LoadingBar, ImageView, TextAtlas , 以及 TextBMFont 重载.

virtual void visit	(	cocos2d::Renderer *	renderer,
		const Mat4 &	parentTransform,
		bool	parentTransformUpdated
	)

overridevirtual

访问节点的孩子，并且循环递归的绘制它们。

重载 ProtectedNode .

被 Layout , 以及 RichText 重载.

类成员变量说明

CC_CONSTRUCTOR_ACCESS pad0

int _actionTag

protected

bool _affectByClipping

protected

bool _bright

protected

widget是否为亮色（bright）

BrightStyle _brightStyle

protected

亮色风格（bright style）

Color3B _color

protected

Size _customSize

protected

bool _enabled

protected

widget的最高控制

bool _flippedX

protected

bool _flippedY

protected

bool _focused

protected

Widget* _focusedWidget

staticprotected

储存唯一一个处于被focus状态的widget

bool _focusEnabled

protected

bool _highlight

protected

widget是否被focus

bool _hitted

protected

bool _ignoreSize

protected

Map<int, LayoutParameter*> _layoutParameterDictionary

protected

std::string _name

protected

GLubyte _opacity

protected

Vec2 _positionPercent

protected

PositionType _positionType

protected

Widget* _realFocusedWidget

staticprotected

bool _reorderWidgetChildDirty

protected

Size _size

protected

Vec2 _sizePercent

protected

SizeType _sizeType

protected

bool _touchEnabled

protected

widget是否能响应触摸

Vec2 _touchEndPos

protected

触摸结束点

ccWidgetTouchCallback _touchEventCallback

protected

Ref* _touchEventListener

protected

SEL_TouchEvent _touchEventSelector

protected

EventListenerTouchOneByOne* _touchListener

protected

Vec2 _touchMovePos

protected

触摸移动点

Vec2 _touchStartPos

protected

触摸开始点

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

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

该类的文档由以下文件生成:

/Users/zeroyang/Documents/github/cocos2d-x/cocos/ui/UIWidget.h

cocos2d
ui
Widget
生成于 2014年五月 29日星期四 09:41:58 , 为 cocos2d-x使用 1.8.6