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

【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