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 返回对象本身。