2014-03-11 17:13:54 +08:00
|
|
|
/****************************************************************************
|
|
|
|
Copyright (c) 2013-2014 Chukong Technologies Inc.
|
|
|
|
|
|
|
|
http://www.cocos2d-x.org
|
|
|
|
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
|
|
in the Software without restriction, including without limitation the rights
|
|
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
|
|
all copies or substantial portions of the Software.
|
|
|
|
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
|
THE SOFTWARE.
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
#ifndef __UIBUTTON_H__
|
|
|
|
#define __UIBUTTON_H__
|
|
|
|
|
|
|
|
#include "ui/UIWidget.h"
|
2014-07-21 17:45:56 +08:00
|
|
|
#include "ui/GUIExport.h"
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
NS_CC_BEGIN
|
|
|
|
|
2014-06-04 14:26:21 +08:00
|
|
|
class Label;
|
|
|
|
|
2014-03-11 17:13:54 +08:00
|
|
|
namespace ui{
|
2014-07-30 15:19:39 +08:00
|
|
|
|
|
|
|
class Scale9Sprite;
|
2014-03-11 17:13:54 +08:00
|
|
|
/**
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2014-07-21 17:45:56 +08:00
|
|
|
class CC_GUI_DLL Button : public Widget
|
2014-03-11 17:13:54 +08:00
|
|
|
{
|
|
|
|
|
|
|
|
DECLARE_CLASS_GUI_INFO
|
|
|
|
|
|
|
|
public:
|
2014-06-15 15:55:46 +08:00
|
|
|
|
2014-03-11 17:13:54 +08:00
|
|
|
/**
|
|
|
|
* Default constructor
|
|
|
|
*/
|
|
|
|
Button();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Default destructor
|
|
|
|
*/
|
|
|
|
virtual ~Button();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Allocates and initializes.
|
|
|
|
*/
|
|
|
|
static Button* create();
|
2014-04-02 11:48:42 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* create a button with custom textures
|
|
|
|
* @normalImage normal state texture name
|
|
|
|
* @selectedImage selected state texture name
|
2014-04-03 17:13:24 +08:00
|
|
|
* @disableImage disabled state texture name
|
2014-04-02 11:48:42 +08:00
|
|
|
* @param texType @see UI_TEX_TYPE_LOCAL
|
|
|
|
*/
|
|
|
|
static Button* create(const std::string& normalImage,
|
|
|
|
const std::string& selectedImage = "",
|
|
|
|
const std::string& disableImage = "",
|
2014-05-09 14:56:05 +08:00
|
|
|
TextureResType texType = TextureResType::LOCAL);
|
2014-04-02 11:48:42 +08:00
|
|
|
|
2014-03-11 17:13:54 +08:00
|
|
|
/**
|
|
|
|
* Load textures for button.
|
|
|
|
*
|
2014-04-02 11:48:42 +08:00
|
|
|
* @param normal normal state texture name.
|
2014-03-11 17:13:54 +08:00
|
|
|
*
|
2014-04-02 11:48:42 +08:00
|
|
|
* @param selected selected state texture name.
|
2014-03-11 17:13:54 +08:00
|
|
|
*
|
2014-04-03 17:13:24 +08:00
|
|
|
* @param disabled disabled state texture name.
|
2014-03-11 17:13:54 +08:00
|
|
|
*
|
2014-07-15 15:56:07 +08:00
|
|
|
* @param texType @see TextureResType
|
2014-03-11 17:13:54 +08:00
|
|
|
*/
|
2014-04-02 16:08:45 +08:00
|
|
|
void loadTextures(const std::string& normal,
|
|
|
|
const std::string& selected,
|
|
|
|
const std::string& disabled = "",
|
2014-05-09 14:56:05 +08:00
|
|
|
TextureResType texType = TextureResType::LOCAL);
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Load normal state texture for button.
|
|
|
|
*
|
|
|
|
* @param normal normal state texture.
|
|
|
|
*
|
2014-07-15 15:56:07 +08:00
|
|
|
* @param texType @see TextureResType
|
2014-03-11 17:13:54 +08:00
|
|
|
*/
|
2014-05-09 14:56:05 +08:00
|
|
|
void loadTextureNormal(const std::string& normal, TextureResType texType = TextureResType::LOCAL);
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Load selected state texture for button.
|
|
|
|
*
|
|
|
|
* @param selected selected state texture.
|
|
|
|
*
|
2014-07-15 15:56:07 +08:00
|
|
|
* @param texType @see TextureResType
|
2014-03-11 17:13:54 +08:00
|
|
|
*/
|
2014-05-09 14:56:05 +08:00
|
|
|
void loadTexturePressed(const std::string& selected, TextureResType texType = TextureResType::LOCAL);
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Load dark state texture for button.
|
|
|
|
*
|
|
|
|
* @param disabled dark state texture.
|
|
|
|
*
|
2014-07-15 15:56:07 +08:00
|
|
|
* @param texType @see TextureResType
|
2014-03-11 17:13:54 +08:00
|
|
|
*/
|
2014-05-09 14:56:05 +08:00
|
|
|
void loadTextureDisabled(const std::string& disabled, TextureResType texType = TextureResType::LOCAL);
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets capinsets for button, if button is using scale9 renderer.
|
|
|
|
*
|
|
|
|
* @param capInsets capinsets for button
|
|
|
|
*/
|
|
|
|
void setCapInsets(const Rect &capInsets);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets capinsets for button, if button is using scale9 renderer.
|
|
|
|
*
|
|
|
|
* @param capInsets capinsets for button
|
|
|
|
*/
|
|
|
|
void setCapInsetsNormalRenderer(const Rect &capInsets);
|
|
|
|
|
2014-05-27 11:06:32 +08:00
|
|
|
const Rect& getCapInsetsNormalRenderer()const;
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets capinsets for button, if button is using scale9 renderer.
|
|
|
|
*
|
|
|
|
* @param capInsets capinsets for button
|
|
|
|
*/
|
|
|
|
void setCapInsetsPressedRenderer(const Rect &capInsets);
|
|
|
|
|
2014-05-27 11:06:32 +08:00
|
|
|
const Rect& getCapInsetsPressedRenderer()const;
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets capinsets for button, if button is using scale9 renderer.
|
|
|
|
*
|
|
|
|
* @param capInsets capinsets for button
|
|
|
|
*/
|
|
|
|
void setCapInsetsDisabledRenderer(const Rect &capInsets);
|
|
|
|
|
2014-05-27 11:06:32 +08:00
|
|
|
const Rect& getCapInsetsDisabledRenderer()const;
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets if button is using scale9 renderer.
|
|
|
|
*
|
|
|
|
* @param true that using scale9 renderer, false otherwise.
|
|
|
|
*/
|
|
|
|
virtual void setScale9Enabled(bool able);
|
|
|
|
|
2014-05-27 11:06:32 +08:00
|
|
|
bool isScale9Enabled()const;
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Changes if button can be clicked zoom effect.
|
|
|
|
*
|
|
|
|
* @param true that can be clicked zoom effect, false otherwise.
|
|
|
|
*/
|
|
|
|
void setPressedActionEnabled(bool enabled);
|
|
|
|
|
|
|
|
//override "ignoreContentAdaptWithSize" method of widget.
|
|
|
|
virtual void ignoreContentAdaptWithSize(bool ignore) override;
|
|
|
|
|
2014-04-17 14:08:25 +08:00
|
|
|
//override "getVirtualRendererSize" method of widget.
|
2014-09-12 14:39:22 +08:00
|
|
|
virtual Size getVirtualRendererSize() const override;
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
//override "getVirtualRenderer" method of widget.
|
|
|
|
virtual Node* getVirtualRenderer() override;
|
2014-09-17 10:57:40 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Return the inner title renderer of Button
|
|
|
|
* @since v3.3
|
|
|
|
*/
|
|
|
|
Label* getTitleRenderer()const;
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the "class name" of widget.
|
|
|
|
*/
|
|
|
|
virtual std::string getDescription() const override;
|
|
|
|
|
|
|
|
void setTitleText(const std::string& text);
|
|
|
|
const std::string& getTitleText() const;
|
|
|
|
void setTitleColor(const Color3B& color);
|
|
|
|
const Color3B& getTitleColor() const;
|
|
|
|
void setTitleFontSize(float size);
|
|
|
|
float getTitleFontSize() const;
|
2014-04-03 10:31:10 +08:00
|
|
|
void setTitleFontName(const std::string& fontName);
|
|
|
|
const std::string& getTitleFontName() const;
|
2014-08-14 11:14:24 +08:00
|
|
|
/** When user pressed the button, the button will zoom to a scale.
|
|
|
|
* The final scale of the button equals (button original scale + _zoomScale)
|
2014-09-17 10:57:40 +08:00
|
|
|
* @since v3.3
|
2014-08-14 11:14:24 +08:00
|
|
|
*/
|
|
|
|
void setZoomScale(float scale);
|
|
|
|
/**
|
|
|
|
* @brief Return a zoom scale
|
2014-09-17 10:57:40 +08:00
|
|
|
* @since v3.3
|
2014-08-14 11:14:24 +08:00
|
|
|
*/
|
|
|
|
float getZoomScale()const;
|
2014-03-21 13:44:29 +08:00
|
|
|
|
|
|
|
CC_CONSTRUCTOR_ACCESS:
|
|
|
|
virtual bool init() override;
|
2014-04-02 11:48:42 +08:00
|
|
|
virtual bool init(const std::string& normalImage,
|
|
|
|
const std::string& selectedImage = "",
|
|
|
|
const std::string& disableImage = "",
|
2014-05-09 14:56:05 +08:00
|
|
|
TextureResType texType = TextureResType::LOCAL);
|
2014-04-02 11:48:42 +08:00
|
|
|
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
protected:
|
|
|
|
virtual void initRenderer() override;
|
|
|
|
virtual void onPressStateChangedToNormal() override;
|
|
|
|
virtual void onPressStateChangedToPressed() override;
|
|
|
|
virtual void onPressStateChangedToDisabled() override;
|
|
|
|
virtual void onSizeChanged() override;
|
2014-06-06 16:00:28 +08:00
|
|
|
|
2014-03-11 17:13:54 +08:00
|
|
|
void normalTextureScaleChangedWithSize();
|
|
|
|
void pressedTextureScaleChangedWithSize();
|
|
|
|
void disabledTextureScaleChangedWithSize();
|
2014-06-06 16:00:28 +08:00
|
|
|
|
2014-04-17 14:08:25 +08:00
|
|
|
virtual void adaptRenderers() override;
|
|
|
|
void updateTitleLocation();
|
2014-10-11 12:13:04 +08:00
|
|
|
void updateContentSize();
|
2014-06-06 16:00:28 +08:00
|
|
|
|
|
|
|
virtual Widget* createCloneInstance() override;
|
|
|
|
virtual void copySpecialProperties(Widget* model) override;
|
|
|
|
|
2014-10-25 18:00:57 +08:00
|
|
|
virtual Size getNormalSize() const;
|
2014-03-11 17:13:54 +08:00
|
|
|
protected:
|
2014-07-30 15:19:39 +08:00
|
|
|
Scale9Sprite* _buttonNormalRenderer;
|
|
|
|
Scale9Sprite* _buttonClickedRenderer;
|
|
|
|
Scale9Sprite* _buttonDisableRenderer;
|
2014-03-14 21:06:40 +08:00
|
|
|
Label* _titleRenderer;
|
2014-08-14 11:14:24 +08:00
|
|
|
|
|
|
|
float _zoomScale;
|
2014-03-11 17:13:54 +08:00
|
|
|
std::string _normalFileName;
|
|
|
|
std::string _clickedFileName;
|
|
|
|
std::string _disabledFileName;
|
|
|
|
bool _prevIgnoreSize;
|
|
|
|
bool _scale9Enabled;
|
|
|
|
Rect _capInsetsNormal;
|
|
|
|
Rect _capInsetsPressed;
|
|
|
|
Rect _capInsetsDisabled;
|
|
|
|
TextureResType _normalTexType;
|
|
|
|
TextureResType _pressedTexType;
|
|
|
|
TextureResType _disabledTexType;
|
|
|
|
Size _normalTextureSize;
|
|
|
|
Size _pressedTextureSize;
|
|
|
|
Size _disabledTextureSize;
|
|
|
|
bool _pressedActionEnabled;
|
|
|
|
float _normalTextureScaleXInSize;
|
|
|
|
float _normalTextureScaleYInSize;
|
|
|
|
float _pressedTextureScaleXInSize;
|
|
|
|
float _pressedTextureScaleYInSize;
|
|
|
|
bool _normalTextureLoaded;
|
|
|
|
bool _pressedTextureLoaded;
|
|
|
|
bool _disabledTextureLoaded;
|
2014-04-17 14:08:25 +08:00
|
|
|
bool _normalTextureAdaptDirty;
|
|
|
|
bool _pressedTextureAdaptDirty;
|
|
|
|
bool _disabledTextureAdaptDirty;
|
2014-06-15 15:55:46 +08:00
|
|
|
|
2014-06-17 15:34:54 +08:00
|
|
|
private:
|
|
|
|
enum class FontType
|
|
|
|
{
|
|
|
|
SYSTEM,
|
|
|
|
TTF
|
|
|
|
};
|
|
|
|
|
2014-06-15 15:55:46 +08:00
|
|
|
std::string _fontName;
|
|
|
|
int _fontSize;
|
2014-06-17 15:34:54 +08:00
|
|
|
FontType _type;
|
2014-03-11 17:13:54 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
NS_CC_END
|
|
|
|
|
|
|
|
#endif /* defined(__CocoGUI__Button__) */
|