【v2.x OGE教程 14】 控件使用

 

下面介绍精灵、动画精灵、按钮精灵、文本的常用使用方法

 

一、精灵相关

 

1.添加精灵

//创建精灵

Sprite bar_up = new Sprite(400, 0, RegionRes.getRegion(Res.BAR_UP),    getVertexBufferObjectManager());

//将精灵添加至BaseEntityGroup或其子类（如：Scene、Layer等）

BaseEntityGroup.attachChild(bar_up);

2.精灵翻转

//两者默认是false

bar_up.setFlippedHorizontal(pFlippedHorizontal);//水平翻转

bar_up.setFlippedVertical(pFlippedVertical)//垂直翻转

3.精灵分离

方法一：

object.detachChild(bar_up);//object必须是attachChild时所引用的对象

方法二：

bar_up.detachSelf();//引用其Parent对象将其detach

 

二、动画精灵相关

1.添加动画精灵

//创建动画精灵 所需帧图必须在同一纹理上

AnimatedSprite bird = new AnimatedSprite(0, 0, Res.BRID_YELLOW, 

getVertexBufferObjectManager());

//将精灵添加至BaseEntityGroup或其子类（如：Scene、Layer等）

BaseEntityGroup.attachChild(bird);

2.播放动画

AnimatedSprite类中有各种animate方法对帧图进行播放，以下是animate方法中各参数意思：

 

pFrameDurationEach：每帧播放时间（毫秒）

IAnimationListener ：监听当播放前后，切换帧，循环结束后。

pLoop：是否循环

pLoopCount：循环次数

pFrameDurations：自定义每帧播放时间

pFirstTileIndex：从哪一帧开始播放 

pLastTileIndex：从哪一帧结束播放 （FirstTileIndex必须小于LastTileIndex）

pFrames[]：自定义播放的帧

IAnimationData：设置动画参数的接口

3.播放动画监听

AnimatedSprite类中用IAnimationListener接口来监听动画

 

//AnimatedSprite.LOOP_CONTINUOUS是无限循环

public void onAnimationStarted(final AnimatedSprite pAnimatedSprite, final int pInitialLoopCount);

 

//动画的帧改变时会调用

public void onAnimationFrameChanged(final AnimatedSprite pAnimatedSprite, final int pOldFrameIndex, final int pNewFrameIndex);

 

//循环一次结束时调用

public void onAnimationLoopFinished(final AnimatedSprite pAnimatedSprite, final int pRemainingLoopCount, final int pInitialLoopCount);

 

//动画播放完时调用

public void onAnimationFinished(final AnimatedSprite pAnimatedSprite);

 

 

4.分离动画精灵

方法一：

object.detachChild(bar_up);//object必须是attachChild时所引用的对象

方法二：

bar_up.detachSelf();//引用其Parent对象将其detach

 

三、按钮精灵

按钮精灵使用TiledRegion使得按钮在ButtonSprite.State不同状态中切换帧图，加强表达效果，重写onAreaTouched方法给予用户良好体验，注册OnClickListener监听点击事件发生

1.添加按钮

//创建按钮精灵 所需帧图必须在同一纹理上

ButtonSprite btnOK = new ButtonSprite(0, 0, Res.GAME_READY, 

getVertexBufferObjectManager());

this.attachChild(btnOK);

2.按钮监听

btnOK.setOnClickListener(new OnClickListener() {

@Override

public void onClick(ButtonSprite pButtonSprite, float pTouchAreaLocalX, 

float pTouchAreaLocalY) {

//TODO 

}

});

3.按钮状态

NORMAL(0),//普通

PRESSED(1),//按下

DISABLED(2);//不可用

 

DISABLED状态需设置setEnable(pEnabled)才可改变

4.分离按钮

方法一：

object.detachChild(btnOK);//object必须是attachChild时所引用的对象

方法二：

btnOK.detachSelf();//引用其Parent对象将其detach

 

 

四、文本相关

1.添加文本

//确保BitmapFont已加载，并且已包含所需文字

//pCharactersMaximum 所允许最大文本长度，若超出则后面部分不显示

Text bitmapText = new Text(0, 0, bitmapFont, "Hello World!",200

new TextOptions(HorizontalAlign.CENTER),

this.getVertexBufferObjectManager());

//将精灵添加至BaseEntityGroup或其子类（如：Scene、Layer等）

this.attachChild(bitmapText);

 

2.更新文本

//更新文本后矩形会根据文字内容增大或缩小，所以需要配合setPosition将坐标重新更改

bitmapText.setText("Just a Demo");

3.分离文本

方法一：

object.detachChild(bitmapText);//object必须是attachChild时所引用的对象

方法二：

bitmapText.detachSelf();//引用其Parent对象将其detach

4.软键盘监听

 

 

/**hint 文本为空时出现的信息

* text 默认文本

* 输入类型ISoftInput.INPUT_TYPE_XXX

* 最大输入字节数

* 文本监听

Device.getDevice().getSoftInput().showSoftInput(hint, text, inputType, maxTextLength, onSoftInputListener);

 

五、线、矩形相关

1.创建线、矩形

//创建需要两个点

Line line = new Line(0, 0, 0, 0, pVertexBufferObjectManager);

//将精灵添加至BaseEntityGroup或其子类（如：Scene、Layer等）

BaseEntityGroup.attachChild(line);

 

//创建需要设定宽高

Rectangle rect = new Rectangle(0, 0, 100, 100, getVertexBufferObjectManager());

//将精灵添加至BaseEntityGroup或其子类（如：Scene、Layer等）

BaseEntityGroup.attachChild(rect);

2.分离线、矩形

方法一：

object.detachChild(line);//object必须是attachChild时所引用的对象

object.detachChild(rect);//object必须是attachChild时所引用的对象

方法二：

line.detachSelf();//引用其Parent对象将其detach

rect.detachSelf();//引用其Parent对象将其detach