cocos代码研究（14）Widget子类Button学习笔记

理论基础

表示一个按钮组件。 按钮可以被按下,或者点击, 并且在按下或者点击之后，可以由用户指定一个动作来执行，继承自 Widget。

代码部分

static Button * create ()
创建一个空的按钮。

static Button * create (const std::string &normalImage, //正常状态纹理的名字。
const std::string &selectedImage="", //选中状态纹理名称。
const std::string &disableImage="", //禁用状态纹理的名字。
TextureResType texType=TextureResType::LOCAL)
使用自定义的纹理创建一个按钮。

void loadTextures (const std::string &normal,
const std::string &selected, const std::string &disabled="",
TextureResType texType=TextureResType::LOCAL)
加载按钮的纹理。

//跟纹理有关
void loadTextureNormal (const std::string &normal,
TextureResType texType=TextureResType::LOCAL)
加载按钮正常状态的纹理。

void loadTexturePressed (const std::string &selected,
TextureResType texType=TextureResType::LOCAL)
加载按钮选中状态纹理。

void loadTextureDisabled (const std::string &disabled,
TextureResType texType=TextureResType::LOCAL)
加载按钮禁用状态的纹理。

//和按钮文字有关
void setTitleText (const std::string &text)
改变按钮的标题的内容。

const std::string getTitleText () const
查询按钮标题内容。

void setTitleColor (const Color3B &color)
改变按钮的标题的颜色。

Color3B getTitleColor () const
查询按钮标题的颜色。

void setTitleFontSize (float size)
改变按钮的标题的字体大小

float getTitleFontSize () const
查询按钮标题的字体大小

void setTitleFontName (const std::string &fontName)
改变按钮的标题的字体名称

const std::string getTitleFontName () const
查询按钮的标题的字体名称

void setTitleAlignment (TextHAlignment hAlignment)
设置标题的文本的水平对齐方式

//和九宫格技术有关
void setCapInsets (const Rect &capInsets)
设置按钮的capInsets。 这个capInset影响按钮所有的九宫格渲染器，只有在调用“setScale9Enabled(true)”后才生效

void setCapInsetsNormalRenderer (const Rect &capInsets)
设置按钮的capInsets,只有正常状态的九宫格渲染器才会受到影响。

const Rect & getCapInsetsNormalRenderer () const
返回正常状态的九宫格渲染器的capInsets。

void setCapInsetsPressedRenderer (const Rect &capInsets)
设置按钮的capInsets,只有按下状态的九宫格渲染器会受到影响。

const Rect & getCapInsetsPressedRenderer () const
返回按下状态的九宫格渲染器的capInsets

void setCapInsetsDisabledRenderer (const Rect &capInsets)
设置按钮的capInsets,只有禁用状态的九宫格渲染器会受到影响。

const Rect & getCapInsetsDisabledRenderer () const
返回禁用状态的九宫格渲染器的capInsets。

virtual void setScale9Enabled (bool enable)
启用九宫格渲染

bool isScale9Enabled () const
查询按钮是否使用scale9渲染

void setPressedActionEnabled (bool enabled)
设置启用按钮被按下时的缩放操作。

virtual std::string getDescription () const override
返回控件类的描述

Label * getTitleRenderer () const
返回按钮的内部标题渲染器。
void setTitleAlignment (TextHAlignment hAlignment, TextVAlignment vAlignment)
设置标题的文本垂直和水平对齐方式

void setZoomScale (float scale)
当用户按下按钮,按钮将照一个缩放比例来缩放 按钮最终的缩放比例等于（按钮初始缩放比例+ _zoomScale)

float getZoomScale () const
返回一个缩放比例