UITextField公有属性、方法
/** * TextField事件类型 */ enum class EventType { ATTACH_WITH_IME, // 键盘弹出 DETACH_WITH_IME, // 键盘回收 INSERT_TEXT, // 输入字符 DELETE_BACKWARD, // 删除字符 }; /** * 一个将在TextField事件发生时被调用的回调 */ typedef std::function<void(Ref*, EventType)> ccTextFieldCallback; /** * 构造函数 */ TextField(); /** * 构造函数 * @return TextField实例 */ static TextField* create(); /** * 构造函数 * @param placeholder 占位符 * @param fontName The 字体名 * @param fontSize The 字体大小 * @return TextField实例 */ static TextField* create(const std::string& placeholder, const std::string& fontName, int fontSize); /** * 设置TextField触摸范围 * 触摸范围用于 "hitTest" * @param 触摸范围 */ void setTouchSize(const Size &size); /** * 获取TextField的当前触摸范围 * @return 触摸范围 */ Size getTouchSize()const; /** * 启用切换启用触摸区域。 * @param enable 是否允许触摸 */ void setTouchAreaEnabled(bool enable); virtual bool hitTest(const Vec2 &pt, const Camera* camera, Vec3 *p) const override; /** * 设置占位符 * @param value 占位符 */ void setPlaceHolder(const std::string& value); /** * 获取占位符 * @return 占位符 */ const std::string& getPlaceHolder()const; /** * 设置占位符颜色 * @param color 占位符颜色 */ void setPlaceHolderColor(const Color3B& color); void setPlaceHolderColor(const Color4B& color); /** * 获取占位符颜色 * @return 占位符颜色 */ const Color4B& getPlaceHolderColor()const; /** * 设置文本颜色 * @param textColor 文本颜色 */ void setTextColor(const Color4B& textColor); /** * 获取文本颜色 * @return 文本颜色 */ const Color4B& getTextColor()const; /** * 设置文本大小 * @param size 文本大小 */ void setFontSize(int size); /** * 获取文本大小 * @return 文本大小 */ int getFontSize()const; /** * 设置文本字体 * @param name 字体名 */ void setFontName(const std::string& name); /** * 获取文本字体 * @return 文本字体 */ const std::string& getFontName()const; /** * 设置文本 * @param text 文本 */ void setString(const std::string& text); /** * 获取文本 * @return 文本 */ const std::string& getString()const; /** * 启用最大长度限制 * @param enable 是否启用 */ void setMaxLengthEnabled(bool enable); /** * 获取是否启用最大长度 * @return 是否启用 */ bool isMaxLengthEnabled()const; /** * 设置长度限制 * @param length 最大长度 */ void setMaxLength(int length); /** * 获取长度限制的长度 * @return 长度 */ int getMaxLength()const; /** * 获取文本长度 * @return 文本长度 */ int getStringLength() const; /** * 启用密文模式 * @param enable 是否启用密文模式 */ void setPasswordEnabled(bool enable); /** * 获取是否启用了密文模式 * @return 是否启用密文模式 */ bool isPasswordEnabled()const; /** * 设置密文模式字符样式 * @param styleText 字符样式，默认为'*' */ void setPasswordStyleText(const char* styleText); /** * 获取密文样式 * @return 密文样式 */ const char* getPasswordStyleText()const; /** * 设置启用IME * @param attach 如果附加IME则为true，否则为false。 */ void setAttachWithIME(bool attach); /** * 查询IME是否附加。 * @return 如果附加了IME，则为true;否则为false。 */ bool getAttachWithIME()const; /** * 设置与IME分离 * @param detach 是否分离 */ void setDetachWithIME(bool detach); /** * 查询IME是否被分离 * @return 是否分离 */ bool getDetachWithIME()const; /** * 启用插入文本模式 * @param true，启用；false，未启用 */ void setInsertText(bool insertText); /** * 是否准备好插入文本 * @return 如果插入文本准备就绪，则返回true，否则返回false */ bool getInsertText()const; /** * 启用删除字符模式 * @param deleteBackward true，启用；false，未启用 */ void setDeleteBackward(bool deleteBackward); /** * 是否准备好删除文本 * @return true进行删除文本，否则为false。 */ bool getDeleteBackward()const; /** * 给TextField添加一个事件监听器，当某个预定义的事件发生时，回调将被调用。 * @param target 事件对象 * @param selecor 对调函数 */ void addEventListener(const ccTextFieldCallback& callback); /** * 打开键盘 */ void attachWithIME(); /** * 设置文字渲染范围（即文本显示范围） * 注意：要实现该函数的效果，必须调用该对象的ignoreContentAdaptWithSize(false) * @param 渲染范围 */ void setTextAreaSize(const Size &size); /** * 设置水平方向对齐方式 * @param alignment 对齐方式，查看TextHAlignment */ void setTextHorizontalAlignment(TextHAlignment alignment); /** * 获取水平方向对齐方式 * @return 对齐方式 */ TextHAlignment getTextHorizontalAlignment() const; /** * 设置垂直方向对齐方式 * @param alignment 对齐方式，查看TextVAlignment */ void setTextVerticalAlignment(TextVAlignment alignment); /** * 获取垂直方向对齐方式 * @return 对齐方式 */ TextVAlignment getTextVerticalAlignment() const;