Cocos2d-x 3.4 之 文本输入之 CCTextFieldTTF

***************************************转载请注明出处：http://blog.csdn.net/lttree********************************************

本文主要讲述文本输入的小编。

这个的作用就不用多说，还是很重要的，

cocos2d-x 引擎对于文本输入 有两个类可以实现，

一个是 —— CCTextFieldTTF

另一个是 —— CCEditBox

本文就主要说一下 第一个 CCTextFieldTTF，在 文本输入<2> 的时候再说 CCEditBox。

一、简介

这个类，在3.4 API 中的继承图是酱紫的：

可以看到，这个类继承自 Label 和 IMEDelegate（为子类提供虚拟键盘功能），

所以也有种说法，它就是个通过监听输入的字符而时时更新的Label而已。

二、相关操作

1. 创建

要注意，这里的创建并不是用 create了，但有两种方式

第一种，就是这样的，自己定义文本框大小、对齐方式

/** creates a TextFieldTTF from a fontname,alignment,dimension and font size */
    static TextFieldTTF * textFieldWithPlaceHolder(const std::string& placeholder,const Size& dimensions,TextHAlignment alignment,const std::string& fontName,float fontSize);

参数分别是：

placeholder 文本框默认内容（没有字符的时候的内容）

dimensions 文本框大小

alignment 文本框内容对齐方式

fontName 文本框采用的字体

fontSize 文本框字体大小

PS：关于 TextHAlignment 有

enum class CC_DLL TextHAlignment
{
    LEFT,CENTER,RIGHT
};

第二种就是，只定义字体种类、大小 和 默认内容，大小等于Label大小，如果内容超过编辑框大小会自动扩展：

/** creates a TextFieldTTF from a fontname and font size */
static TextFieldTTF * textFieldWithPlaceHolder(const std::string& placeholder,float fontSize);

参数和上面的意义一样，就不写了。

2.其他操作

<1> 设置文本框默认内容，默认内容的字体颜色

// 设置/获取 文本框默认内容
virtual void setPlaceHolder(const std::string& text);
virtual const std::string& getPlaceHolder() const;
// 设置/获取 文本框默认内容颜色
virtual const Color4B& getColorSpaceHolder();

virtual void setColorSpaceHolder(const Color3B& color);
virtual void setColorSpaceHolder(const Color4B& color);

<2> 编辑框内容

// 设置/获取 编辑框内容
virtual void setString(const std::string& text) override;
virtual const std::string& getString() const override;
// 设置 编辑框内容颜色
virtual void setTextColor(const Color4B& textColor) override;

<3> 虚拟键盘

//开启虚拟键盘  
virtual bool attachWithIME();
//关闭虚拟键盘 
virtual bool detachWithIME(); 

<4> 密码

// 如果输入的是密码，让输入的东西全是 * ，一个字母是一个*，一个汉字是3个*
textEdit->setSecureTextEntry(true);

<5> 字符个数

// 获取 文本框内容字符个数
inline int getCharCount() const { return _charCount; };

至于其他的一些操作，自行看API吧...

这里就不再赘述

三、Do it

现在来一个小例子，展现一下吧

创建文本框

// 创建文本框1
textEdit = CCTextFieldTTF::textFieldWithPlaceHolder("Please input:","Arial",36);  
textEdit->setPosition(Vec2(visibleSize.width/2,visibleSize.height/2));  
textEdit->setColorSpaceHolder(Color3B::BLUE);
this->addChild(textEdit);  

设置4个按钮，对文本框进行操作：

// 文字按钮——密码 模式
auto btn_psw = MenuItemFont::create("password",CC_CALLBACK_1(TextInput::menupswCallback,this));  
btn_psw->setPosition(Vec2(btn_psw->getContentSize().width,visibleSize.height/4)); 
	
// 文字按钮——展示 文本框内容
auto btn_show = MenuItemFont::create("show",CC_CALLBACK_1(TextInput::menushowCallback,this));
btn_show->setPosition(Vec2(btn_psw->getContentSize().width*2,visibleSize.height/4));

// 文字按钮——计算文本框内字符个数
auto btn_count = MenuItemFont::create("count",CC_CALLBACK_1(TextInput::menucountCallback,this));
btn_count->setPosition(Vec2(btn_psw->getContentSize().width,visibleSize.height/6));

// 文字按钮——改变文本框内字体颜色
auto btn_color = MenuItemFont::create("color",CC_CALLBACK_1(TextInput::menuchangeColorCallback,this));
btn_color->setPosition(Vec2(btn_psw->getContentSize().width*2,visibleSize.height/6));

相应函数的设定：

// 触摸事件
bool TextInput::onTouchBegan(CCTouch* touch,CCEvent* ev)  
{  
    //用于判断是否点中了控件  
    bool isClicked = textEdit->boundingBox().containsPoint(touch->getLocation());  

    //如果点中了控件  
	if( isClicked )  
    {  
        //弹出软键盘  
        textEdit->attachWithIME();  
    }
	else
	{
		textEdit->detachWithIME();
	}

    //表示接受触摸消息  
    return true;  
} 

// 是否设置成 密码 模式
void TextInput::menupswCallback(cocos2d::Ref* pSender)
{
	if( textEdit->isSecureTextEntry() )
	{
		textEdit->setSecureTextEntry(false);
	}
	else
	{
		textEdit->setSecureTextEntry(true);
	}
}

// 展示文本框内容
void TextInput::menushowCallback(cocos2d::Ref* pSender)
{
	auto label = (Label*) this->getChildByTag(111);
	label->setString(textEdit->getString());
}

// 计算文本框内容字符个数
void TextInput::menucountCallback(cocos2d::Ref* pSender)
{
	auto label = (Label*) this->getChildByTag(112);
	label->setString( StringUtils::format(" %d ",textEdit->getCharCount()) );
}

// 改变文本框字体颜色
void TextInput::menuchangeColorCallback(cocos2d::Ref* pSender)
{
	textEdit->setColor(Color3B::GREEN);
}

Ok，运行一下（界面有点渣呀。。小测试，不要在意这些细节。。）

关于CCTextFieldTTF 就到这里了，

测试小例子的全部内容并非只有这些。。

有些内容没有写出来，

完整版测试内容 -> 这里

********************************************