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
子类 GameDialogGameSprite

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

Copyright © 2021 - 2025