Sprite Sprite 显示对象精灵
显示对象的基类,支持显示图片和事件响应
支持通用鼠标事件:
EventObject.RIGHT_MOUSE_UP 鼠标右键弹起
EventObject.RIGHT_MOUSE_DOWN 鼠标右键按下
EventObject.RIGHT_CLICK 鼠标右键点击
EventObject.CLICK 鼠标左键点击
EventObject.DOUBLE_CLICK 鼠标左键双击
EventObject.MOUSE_DOWN 鼠标左键按下
EventObject.MOUSE_UP 鼠标左键弹起
EventObject.MOUSE_WHEEL 鼠标滚轮
EventObject.DRAG_START 鼠标拖拽开始
EventObject.DRAG_MOVE 鼠标拖拽移动中
EventObject.DRAG_END 鼠标拖拽移动结束
// 事件监听示例
var sp = new Sprite();
sp.on(EventObject.CLICK,this,this.onClick);
维护人员:黑暗之神KDS
创建时间:2017-01-01
继承 →TreeNode
子类 GameDialog、GameSprite
Public 属性
属性 |
---|
x : number; 相对父容器的水平方向坐标 |
y : number; 相对父容器的垂直方向坐标 |
width : number; 宽度,用于鼠标检测 |
height : number; 高度,用于鼠标检测 |
hasMouseEvent : boolean; 只读是否存在鼠标事件 |
scaleX : number; X轴缩放值 |
scaleY : number; Y轴缩放值 |
rotation : number; 旋转角度 |
skewX : number; 水平倾斜角度 |
skewY : number; 垂直倾斜角度 |
transform : Matrix; 对象的矩阵信息。通过设置矩阵可以实现节点旋转,缩放,位移效果。 |
pivotX : number; 轴心点的位置X,以轴心点进行缩放、旋转 |
pivotY : number; 轴心点的位置Y,以轴心点进行缩放、旋转 |
alpha : number; 透明度 |
visible : boolean; 是否显示 |
blendMode : string; 合成模式 null/lighter/blend1-1 (lighter=加法 数字可以更改,参考地图图层自定义混合模式) |
graphics : Graphics; 绘制对象 |
scrollRect : Rectangle; 显示对象的滚动矩形范围,具有裁剪效果 |
parent : TreeNode; 父节点 |
stage : Stage; 只读若该对象在舞台上则返回舞台,否则返回null |
hitArea : any; 可以设置一个Rectangle区域作为点击区域,设置后则以该区域作为鼠标事件检测 |
mask : Sprite; 遮罩,可以设置一个对象(支持位图和矢量图),根据对象形状进行遮罩显示,支持像素级遮罩 |
mouseEnabled : boolean; 是否接受鼠标事件 |
globalScaleX : number; 只读获得相对于stage的全局X轴缩放值(会叠加父亲节点的缩放值)。 |
globalScaleY : number; 只读获得相对于stage的全局Y轴缩放值(会叠加父亲节点的缩放值)。 |
mouseX : number; 只读返回鼠标在此对象坐标系上的 X 轴坐标信息。 |
mouseY : number; 只读返回鼠标在此对象坐标系上的 Y 轴坐标信息。 |
Public 方法
方法 |
---|
dispose(): void 销毁 |
getBounds(): Rectangle 获取本对象在父容器坐标系的矩形显示区域,计算量较大,尽量少用 |
getSelfBounds(): Rectangle 获取本对象在自己坐标系的矩形显示区域,计算量较大,尽量少用 |
localToGlobal(point : Point): Point 把本地坐标转换为全局坐标 |
globalToLocal(point : Point): Point 把全局坐标转换为本地坐标 |
startDrag(area? : Rectangle): void 开始拖动此对象 |
stopDrag(): void 停止拖动此对象 |
hitTestPoint(x : number, y : number): boolean 检测某个点是否在此对象内 |
pos(x : number, y : number, speedMode? : boolean): Sprite 设置坐标位置。相当于分别设置x和y属性。 |
详情
stage
stage : Stage;
只读若该对象在舞台上则返回舞台,否则返回null
@return Stage
hitArea
hitArea : any;
可以设置一个Rectangle区域作为点击区域,设置后则以该区域作为鼠标事件检测
支持类型:HitArea | Rectangle
mask
mask : Sprite;
遮罩,可以设置一个对象(支持位图和矢量图),根据对象形状进行遮罩显示,支持像素级遮罩
遮罩对象坐标系是相对遮罩对象本身的,即以该对象的0,0点为准
mouseEnabled
mouseEnabled : boolean;
是否接受鼠标事件
默认为false,如果监听鼠标事件,则会自动设置本对象及父节点的属性 mouseEnable 的值都为 true(如果父节点手动设置为false,则不会更改)
dispose
dispose(): void :
销毁
getBounds
getBounds(): Rectangle :
获取本对象在父容器坐标系的矩形显示区域,计算量较大,尽量少用
返回
矩形区域
getSelfBounds
getSelfBounds(): Rectangle :
获取本对象在自己坐标系的矩形显示区域,计算量较大,尽量少用
返回
矩形区域
localToGlobal
localToGlobal(point : Point): Point :
把本地坐标转换为全局坐标
参数
point 本地坐标点
返回
Point 转换后的全局坐标
globalToLocal
globalToLocal(point : Point): Point :
把全局坐标转换为本地坐标
参数
point 全局坐标点
返回
Point 转换后的坐标的点
startDrag
startDrag(area? : Rectangle): void :
开始拖动此对象
参数
area [可选] 默认值=null 拖动限定的区域范围内
stopDrag
stopDrag(): void :
停止拖动此对象
hitTestPoint
hitTestPoint(x : number, y : number): boolean :
检测某个点是否在此对象内
@param x 全局x坐标
@param y 全局y坐标。
返回
表示是否在对象内
pos
pos(x : number, y : number, speedMode? : boolean): Sprite :
设置坐标位置。相当于分别设置x和y属性。
@param x X轴坐标。
@param y Y轴坐标。
参数
speedMode (可选)是否极速模式,正常是调用this.x=value进行赋值,极速模式直接调用内部函数处理,,如果未重写x,y属性,建议设置为急速模式性能更高。
@return 返回对象本身。