LibGDX_6.5: 常用系统控件: 文本框（TextField）

本文链接: http://blog.csdn.net/xietansheng/article/details/50187911

LibGDX 基础教程（总目录）

1. 文本框（TextField）

文本框主要用于提供给用户输入文字，获取用户输出，例如在登录时让用户输入用户名和密码等。文本框一般由背景图片（文本框的边框）和 光标（也用图片来表示）组成。为了方便演示，这里不再引入外部的图片和字体文件，而是使用 Pixmap 自己在内存中创建图片生成纹理，并且直接使用 gdx.jar 包中的字体文件（字体较小，可能会显示不清晰）。

2. 代码示例: TextField 的使用

package com.libgdx.test;

import com.badlogic.gdx.Application;
import com.badlogic.gdx.ApplicationAdapter;
import com.badlogic.gdx.Gdx;
import com.badlogic.gdx.Input.Keys;
import com.badlogic.gdx.graphics.Color;
import com.badlogic.gdx.graphics.GL20;
import com.badlogic.gdx.graphics.Pixmap;
import com.badlogic.gdx.graphics.Texture;
import com.badlogic.gdx.graphics.g2d.BitmapFont;
import com.badlogic.gdx.graphics.g2d.TextureRegion;
import com.badlogic.gdx.scenes.scene2d.Stage;
import com.badlogic.gdx.scenes.scene2d.ui.TextField;
import com.badlogic.gdx.scenes.scene2d.utils.TextureRegionDrawable;
import com.badlogic.gdx.utils.Align;
import com.badlogic.gdx.utils.viewport.StretchViewport;

/**
* 游戏主程序的启动入口类
*/
public class MainGame extends ApplicationAdapter {

private static final String TAG = MainGame.class.getSimpleName();

// 视口世界的宽高统使用 480 * 800, 并统一使用伸展视口（StretchViewport）
public static final float WORLD_WIDTH = 480;
public static final float WORLD_HEIGHT = 800;

// 文本框的宽高
public static final int TEXT_FIELD_WIDTH = 300;
public static final int TEXT_FIELD_HEIGHT = 50;

// 舞台
private Stage stage;

// 文本框背景纹理
private Texture bgTexture;

// 文本框中的光标纹理
private Texture cursorTexture;

// 位图字体
private BitmapFont bitmapFont;

// 文本框（用户名）
private TextField usernameTextField;

// 文本框（密码）
private TextField passwordTextField;

@Override
public void create() {
// 设置日志输出级别
Gdx.app.setLogLevel(Application.LOG_DEBUG);

// 使用伸展视口（StretchViewport）创建舞台
stage = new Stage(new StretchViewport(WORLD_WIDTH, WORLD_HEIGHT));

// 将输入处理设置到舞台（必须设置, 否则文本框无法获取焦点）
Gdx.input.setInputProcessor(stage);

/*
* 第 1 步: 创建文本框背景纹理, 光标纹理, 以及创建位图字体（用于显示文本框中的文本）
*
* 为了方便演示, 这里创建纹理不再用图片来创建, 而是使用 Pixmap 来创建
*/
bgTexture = createBackgroundTexture();
cursorTexture = createCursorTexture();

// 为了方便演示, 这里直接使用 gdx.jar 中自带的字体文件创建位图字体（只要在 BitmapFont 中包含有的字符才能够被输入）
bitmapFont = new BitmapFont();

// gdx.jar 中自带的字体比较小, 这里放大一下
bitmapFont.getData().setScale(2.0F);

/*
* 第 2 步: 创建 TextFieldStyle
*/
TextField.TextFieldStyle style = new TextField.TextFieldStyle();

// 设置背景纹理区域
style.background = new TextureRegionDrawable(new TextureRegion(bgTexture));

// 设置光标纹理区域
style.cursor = new TextureRegionDrawable(new TextureRegion(cursorTexture));

// 设置文本框显示文本的字体来源
style.font = bitmapFont;

// 设置文本框字体颜色为白色
style.fontColor = new Color(1, 1, 1, 1);

/*
* 第 3 步: 创建 TextField
*/
usernameTextField = new TextField("", style);
passwordTextField = new TextField("", style);

// 设置文本框的宽高
usernameTextField.setSize(TEXT_FIELD_WIDTH, TEXT_FIELD_HEIGHT);
passwordTextField.setSize(TEXT_FIELD_WIDTH, TEXT_FIELD_HEIGHT);

// 设置文本框的位置
usernameTextField.setPosition(90, 500);
passwordTextField.setPosition(90, 430);

// 文本框中的文字居中对齐
usernameTextField.setAlignment(Align.center);
passwordTextField.setAlignment(Align.center);

// 用于显示密码的文本框, 需要将文本框设置为密码模式
passwordTextField.setPasswordMode(true);
// 显示密码时用 * 号代替密码字符
passwordTextField.setPasswordCharacter('*');

/*
* 第 4 步: 添加 TextField 到舞台
*/
stage.addActor(usernameTextField);
stage.addActor(passwordTextField);
}

/**
* 创建文本框的背景纹理
*/
private Texture createBackgroundTexture() {
Pixmap pixmap = new Pixmap(TEXT_FIELD_WIDTH, TEXT_FIELD_HEIGHT, Pixmap.Format.RGBA8888);
pixmap.setColor(1, 0, 0, 1);
pixmap.drawRectangle(0, 0, pixmap.getWidth(), pixmap.getHeight());
Texture texture = new Texture(pixmap);
pixmap.dispose();
return texture;
}

/**
* 创建文本框中的光标纹理
*/
private Texture createCursorTexture() {
Pixmap pixmap = new Pixmap(1, TEXT_FIELD_HEIGHT - 4, Pixmap.Format.RGBA8888);
pixmap.setColor(1, 0, 0, 1);
pixmap.fill();
Texture texture = new Texture(pixmap);
pixmap.dispose();
return texture;
}

@Override
public void render() {
/*
* 当按下 回车键 时获取文本框中的用户名和密码输出 Log
*/
if (Gdx.input.isKeyJustPressed(Keys.ENTER)) {
Gdx.app.log(TAG, "username = " + usernameTextField.getText());
Gdx.app.log(TAG, "password = " + passwordTextField.getText());
}

// 黑色清屏
Gdx.gl.glClearColor(0, 0, 0, 1);
Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);

// 更新舞台逻辑
stage.act();
// 绘制舞台
stage.draw();
}

@Override
public void dispose() {
// 应用退出时释放资源
if (bgTexture != null) {
bgTexture.dispose();
}
if (cursorTexture != null) {
cursorTexture.dispose();
}
if (bitmapFont != null) {
bitmapFont.dispose();
}
if (stage != null) {
stage.dispose();
}
}

}

运行代码，输入用户名和密码（只能输入 BitmapFont 中包含的字符），然后按回车键查看控制台输出的 Log：