qc.Node

描述

qc.Node 是所有 GameObject 对象的基类,可以挂载各类游戏脚本,本身具有 RectTransform 位置、定位属性,可作为其他节点的父亲、儿子。

创建 Node

详见qc.GameObjectFactory

// 创建一个 Node 节点
var node = new qc.game.add.node(parent);

变量

变量名 类型 作用
uuid string 对象的唯一标识符
name string 节点的名字
ignoreDestroy bool 节点及其孩子在切换场景时不会被析构。一定要置于根节点才起效
alpha number 透明度值,0 - 1
visible bool 是否可见,注意 visible 为 false 时则所有孩子都不显示,visible 为 true 的时则使用孩子们自己的 visible;另外 visiable 为 false 时连 transform 都不再更新计算
parent qc.Node 父亲节点
worldVisible bool 只读,节点最终的 visible
mask PIXI.Graphics 遮罩,必须为 PIXI.Graphics 对象
children Array 只读,儿子列表
colorTint qc.Color 混合颜色
scripts Array 只读。挂载的逻辑脚本列表

定位相关

变量名 类型 作用
x number 本地 x 坐标(相对于父节点)
y number 本地 y 坐标(相对于父节点)
anchoredX number 相对于父亲anchor的X偏移量。UI中大部分使用此属性,而不是x属性。
anchoredY number 相对于父亲anchor的Y偏移量。UI中大部分使用此属性,而不是y属性。
scaleX number 节点在 X 轴上的缩放
scaleY number 节点在 Y 轴上的缩放
pivotX number 节点自身的原点X位置(0为左边,1为右边)
pivotY number 节点自身的原点Y位置(0为上边,1为下边)
rotation number 旋转角度。在代码中,使用弧度为单位。在编辑器的Inspector面板中,使用角度为单位。
width number 节点的宽度
height number 节点的高度
minAnchor qc.Point 只读,定位矩形左上角的坐标(相对于父亲长宽的比例值),请使用方法 setAnchor 进行设置。
maxAnchor qc.Point 只读,定位矩形右下角的坐标(相对于父亲长宽的比例值),请使用方法 setAnchor 进行设置。
left number 距离左边的位置(如果minAnchor.x = maxAnchor.x,此时不起效)
right number 距离右边的位置(如果minAnchor.x = maxAnchor.x,此时不起效)
top number 距离上边的位置(如果minAnchor.y = maxAnchor.y,此时不起效)
bottom number 距离下边的位置(如果minAnchor.y = maxAnchor.y,此时不起效)
rect qc.Rectangle 相对父亲节点的矩形包围盒
worldTransform qc.Matrix 在世界中的最终变换矩阵
localBounds qc.Rectangle 节点自身的显示范围
localZOrder number 节点本地 zorder 顺序,会根据该值从小到大进行重新排序
onRelayout qc.Signal 节点重新布局的事件通知

交互相关

变量名 类型 作用
interactive boolean 节点是否允许交互(即:是否有能力接受输入事件)
hitArea qc.Rectangleqc.Rectangle,null,undefined 碰撞区域
onDown qc.Signal 按下的事件
onUp qc.Signal 松开的事件
onClick qc.Signal 点击的事件
onDragStart qc.Signal 拖拽开始事件
onDrag qc.Signal 拖拽事件,每帧触发
onDragEnd qc.Signal 拖拽结束事件
onDragDrop qc.Signal 拖拽放下事件(目标节点触发)
onWheel qc.Signal 滚轮事件
onEnter qc.Signal 光标进入事件
onExit qc.Signal 光标移出事件

方法

方法名 作用
addScript 添加一个逻辑脚本对象(移除请调用 qc.Behaviour#destroy 接口)
getScript 取得一个逻辑脚本对象
getScripts 取得逻辑脚本对象列表
isDescendantOf 判断本对象是否是指定 Node 的子孙节点
addChild 添加一个孩子节点到尾部
addChildAt 添加一个孩子节点到指定位置
swapChildren 交换两个孩子的位置
getChildIndex 取得孩子的位置
setChildIndex 设置孩子的位置
getChildAt 取得指定位置的孩子对象
removeChild 移除一个孩子
removeChildAt 在指定的位置删除孩子
removeChildren 删除所有的孩子
destroy 销毁本对象(节点先隐藏掉,下一帧才会真正被清除)
destroyImmediately 立刻销毁本节点(不推荐使用)
find 查找子孙节点,可用 '/' 进行级联查询
addListener 监听事件,在对象析构时会自动移除事件监听
addListenerOnce 增加一次性事件关注,事件响应一次后自动移除监听
removeListener 手动移除事件
snapshotAsAtlas 将当前节点进行截屏,得到一个qc.Atlas对象可用于qc.UIImage使用
snapshotAsImage 将当前节点进行截屏,得到一个html的Image对象(可直接添加到div中)

定位相关

方法名 作用
getWorldPosition 获取节点在全局坐标系中的位置
getWorldScale 获取节点在全局坐标系中的缩放
getWorldRotation 获取节点在全局坐标系中的旋转弧度
switchParent 切换父节点为指定节点,并保证本节点在世界坐标系中的状态不变
getWorldCorners 获取节点在世界坐标中的四个角
getWorldBox 获取节点在世界坐标的包围盒
getBoxIn 获取节点在指定节点坐标系中的包围盒
rectContains 判断世界坐标中的某个点是否在矩形框的范围内
toGlobal 本地坐标转换为全局坐标
toLocal 全局坐标转换为本地坐标
setAnchor 设置锚点定位范围
setStretch 修改可伸缩参数(上、下、左、右边距)

参考手册

空节点

results matching ""

    No results matching ""