egret-docs-master/Engine2D/displayObject/addAndRemove/README.md

164 lines
5.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

在Egret中建立显示对象和渲染显示对象是两个过程。建立显示对象后对象会处于内存中但不会参与渲染过程只有把显示对象放到显示列表后显示对象才会参与渲染过程。如果想将某个显示对象从渲染过程中删除只需要将其移除显示列表即可。
## 1.添加显示对象到显示列表
当创建一个显示对象后就可以将其添加到显示列表中首先绘制一个Sprite这个Sprite是一个宽高为100的绿色正方形。
```javascript
var spr:egret.Sprite = new egret.Sprite();
spr.graphics.beginFill( 0x00ff00 );
spr.graphics.drawRect(0, 0, 100, 100);
spr.graphics.endFill();
```
上面的代码就是建立显示对象的过程,测试程序,在舞台中看不到任何内容。将 spr 添加到显示列表中,代码如下:
```javascript
this.addChild( spr );
```
添加这句代码之后,再次编译运行程序,浏览器中看到效果如图:
![](5668e2533b617.png)
代码中 `addChild()` 方法将 `spr` 添加到显示列表中。前面介绍过,显示列表是一个树状结构,这里 `spr` 的上一级就是 `this`,也就是文档类。文档类是 `stage` 舞台的第一个子对象。
下面是关于当前示例的层级示意图:
![](5668e25358e2b.png)
## 2.删除显示对象
使用 `removeChild()` 方法可删除显示对象,代码如下:
```javascript
this.removeChild( spr );
```
执行删除操作与添加显示对象操作类似,将被删除的显示对象作为参数传递给 `removeChild` 方法。示例中 `spr` 就是被删除的显示对象,而 `this` 则是 `spr` 的父级。
## 3.显示对象操作的注意点
### 3.1.显示对象独立于显示列表
虽然显示对象在运行时会被高频率的添加到显示列表或从中删除,但显示对象独立于显示列表。简单解释:当创建一个显示对象`Sprite`时该对象拥有自己的坐标属性旋转角度属性等。这些属性都是显示对象独立拥有的。一旦该显示对象被添加到显示列表之中Egret就会按照显示对象的状态进行显示。
当用户将显示对象从显示列表中移除后,这些状态依然存在。将一个显示对象移除显示列表后,该对象并非在内存中被销毁。只是不让显示对象参与渲染而已。
通过一段代码观察显示对象在容器中的操作与状态改变:
```javascript
//创建了一个类型为Sprite的显示对象
var spr:egret.Sprite = new egret.Sprite();
spr.graphics.beginFill( 0x00ff00 );
spr.graphics.drawRect(0, 0, 100, 100);
spr.graphics.endFill();
//该对象存在,被添加到显示列表中,在画面中显示
this.addChild( spr );
//该对象存在,但已被移除显示列表,画面上不显示
this.removeChild( spr );
//该对象存在,驻于内存中
```
### 3.2.相对坐标系
显示对象的坐标系是相对坐标系,而非绝对坐标系。
当一个显示对象的x,y坐标值均设置为100的时候该坐标值表示当前显示对象居于父级原点100100的位置。通过下面一个实例来说明具体区别。
首先建立两个容器为了能够方便的看清效果将两个容器的宽高都设置为100*100同时将两个容器分别设置为红色和绿色。
绿色的容器x轴位置设置为120像素。
红色的容器y轴位置设置为130像素
将两个容器都添加到显示列表中,他们的父级都是文档类。下面是示例代码:
```javascript
var sprcon1:egret.Sprite = new egret.Sprite();
sprcon1.graphics.beginFill( 0x00ff00 );
sprcon1.graphics.drawRect(0, 0, 100, 100);
sprcon1.graphics.endFill();
this.addChild( sprcon1 );
sprcon1.x = 120;
var sprcon2:egret.Sprite = new egret.Sprite();
sprcon2.graphics.beginFill( 0xff0000 );
sprcon2.graphics.drawRect(0, 0, 100, 100);
sprcon2.graphics.endFill();
this.addChild( sprcon2 );
sprcon2.y = 130;
```
此时运行后的效果如下:
![](5668e25372b48.png)
然后绘制一个宽高为50的蓝色正方形将这个正方形的x轴和y轴都设置为10像素。分别将这个蓝色的正方形添加到不同的容器中以便查看效果。
创建并绘制一个蓝色正方形的代码:
```javascript
var spr:egret.Sprite = new egret.Sprite();
spr.graphics.beginFill( 0x0000ff );
spr.graphics.drawRect( 0, 0, 50, 50 );
spr.graphics.endFill();
spr.x = 10;
spr.y = 10
```
添加到文档类的显示容器中:
```javascript
this.addChild( spr );
```
运行效果:
![](5668e2537f781.png)
添加到sprcon1绿色容器中
```javascript
sprcon1.addChild( spr );
```
运行效果:
![](5668e253912b4.png)
添加到sprcon2红色容器中
```javascript
sprcon2.addChild( spr );
```
运行效果:
![](5668e253a0fc6.png)
### 3.3.多次添加显示对象到显示列表
同一个显示对象无论被代码加入显示列表多少次,在屏幕上只绘制一次。
如果一个显示对象A被添加到了B这个容器中然后A又被添加到了C容器中。那么在第二次执行 C.addChild(A) 的时候A自动的从B容器中删除然后添加到C容器中。
### 3.4.删除操作的注意点
当删除一个显示对象的时候需要执行的操作是:
`容器对象.removeChild( 显示对象 );`
执行删除操作时,“显示对象”必须拥有父级。换句话说,被删除的显示对象必须存在于容器对象当中。
如果当前删除的显示对象不在容器对象之中JavaScript控制台会报错`Uncaught Error: [Fatal]child未被addChild到该parent:`
避免这种问题的处理方法是每次removeChild之前对即将要被删除的显示对象做一次判断判断它是否拥有父级。判断的代码如下
```javascript
if( spr.parent ) {
spr.parent.removeChild( spr );
}
```