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：

---