/* * Copyright (c) 2012 cocos2d-x.org * https://axis-project.github.io/ * * Copyright 2011 Yannick Loriot. All rights reserved. * http://yannickloriot.com * * Copyright (c) 2017-2018 Xiamen Yaji Software Co., Ltd. * * 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. * * Converted to c++ / cocos2d-x by Angus C */ #ifndef __CCCONTROL_BUTTON_H__ #define __CCCONTROL_BUTTON_H__ #include "CCControl.h" #include "CCInvocation.h" #include "base/CCMap.h" #include "ui/UIScale9Sprite.h" NS_CC_EXT_BEGIN /* Define the button margin for Left/Right edge */ #define ControlButtonMarginLR 8 // px /* Define the button margin for Top/Bottom edge */ #define ControlButtonMarginTB 2 // px /** * @addtogroup GUI * @{ * @addtogroup control_extension * @{ */ /** @class ControlButton Button control for Cocos2D. */ class CC_EX_DLL ControlButton : public Control { public: static ControlButton* create(); static ControlButton* create(cocos2d::ui::Scale9Sprite* sprite); static ControlButton* create(Node* label, cocos2d::ui::Scale9Sprite* backgroundSprite); static ControlButton* create(std::string_view title, std::string_view fontName, float fontSize); static ControlButton* create(Node* label, cocos2d::ui::Scale9Sprite* backgroundSprite, bool adjustBackGroundSize); virtual void needsLayout() override; virtual void setEnabled(bool enabled) override; virtual void setSelected(bool enabled) override; virtual void setHighlighted(bool enabled) override; bool isPushed() const { return _isPushed; } /** * Returns the title used for a state. * * @param state The state that uses the title. Possible values are described in * "CCControlState". * * @return The title for the specified state. */ virtual std::string getTitleForState(State state); /** * Sets the title string to use for the specified state. * If a property is not specified for a state, the default is to use * the ButtonStateNormal value. * * @param title The title string to use for the specified state. * @param state The state that uses the specified title. The values are described * in "CCControlState". */ virtual void setTitleForState(std::string_view title, State state); /** * Returns the title color used for a state. * * @param state The state that uses the specified color. The values are described * in "CCControlState". * * @return The color of the title for the specified state. */ virtual Color3B getTitleColorForState(State state) const; /** * Sets the color of the title to use for the specified state. * * @param color The color of the title to use for the specified state. * @param state The state that uses the specified color. The values are described * in "CCControlState". */ virtual void setTitleColorForState(const Color3B& color, State state); /** * Returns the title label used for a state. * * @param state The state that uses the title label. Possible values are described * in "CCControlState". */ virtual Node* getTitleLabelForState(State state); /** * Sets the title label to use for the specified state. * If a property is not specified for a state, the default is to use * the ButtonStateNormal value. * * @param label The title label to use for the specified state. * @param state The state that uses the specified title. The values are described * in "CCControlState". */ virtual void setTitleLabelForState(Node* label, State state); virtual void setTitleTTFForState(std::string_view fntFile, State state); virtual std::string_view getTitleTTFForState(State state); virtual void setTitleTTFSizeForState(float size, State state); virtual float getTitleTTFSizeForState(State state); /** * Sets the font of the label, changes the label to a BMFont if necessary. * @param fntFile The name of the font to change to * @param state The state that uses the specified fntFile. The values are described * in "CCControlState". */ virtual void setTitleBMFontForState(std::string_view fntFile, State state); virtual std::string_view getTitleBMFontForState(State state); /** * Returns the background sprite used for a state. * * @param state The state that uses the background sprite. Possible values are * described in "CCControlState". */ virtual cocos2d::ui::Scale9Sprite* getBackgroundSpriteForState(State state); /** * Sets the background sprite to use for the specified button state. * * @param sprite The background sprite to use for the specified state. * @param state The state that uses the specified image. The values are described * in "CCControlState". */ virtual void setBackgroundSpriteForState(cocos2d::ui::Scale9Sprite* sprite, State state); /** * Sets the background spriteFrame to use for the specified button state. * * @param spriteFrame The background spriteFrame to use for the specified state. * @param state The state that uses the specified image. The values are described * in "CCControlState". */ virtual void setBackgroundSpriteFrameForState(SpriteFrame* spriteFrame, State state); // set the margins at once (so we only have to do one call of needsLayout) virtual void setMargins(int marginH, int marginV); /** Adjust the background image. YES by default. If the property is set to NO, the background will use the preferred size of the background image. */ bool doesAdjustBackgroundImage(); void setAdjustBackgroundImage(bool adjustBackgroundImage); // Overrides virtual bool onTouchBegan(Touch* touch, Event* event) override; virtual void onTouchMoved(Touch* touch, Event* event) override; virtual void onTouchEnded(Touch* touch, Event* event) override; virtual void onTouchCancelled(Touch* touch, Event* event) override; virtual void setOpacity(uint8_t var) override; virtual void updateDisplayedOpacity(uint8_t parentOpacity) override; virtual void setColor(const Color3B&) override; virtual void updateDisplayedColor(const Color3B& parentColor) override; std::string_view getCurrentTitle() const { return _currentTitle; }; std::string getCurrentTitle() { return _currentTitle; }; /** * @js ctor */ ControlButton(); /** * @js NA * @lua NA */ virtual ~ControlButton(); virtual bool init() override; virtual bool initWithLabelAndBackgroundSprite(Node* label, cocos2d::ui::Scale9Sprite* backgroundSprite, bool adjustBackGroundSize); virtual bool initWithBackgroundSprite(cocos2d::ui::Scale9Sprite* sprite); virtual bool initWithTitleAndFontNameAndFontSize(std::string_view title, std::string_view fontName, float fontSize); protected: bool _isPushed; bool _parentInited; bool _doesAdjustBackgroundImage; /** The current title that is displayed on the button. */ std::string _currentTitle; /** The current color used to display the title. */ CC_SYNTHESIZE_READONLY_PASS_BY_REF(Color3B, _currentTitleColor, CurrentTitleColor); /** The current title label. */ CC_SYNTHESIZE_RETAIN(Node*, _titleLabel, TitleLabel); /** The current background sprite. */ CC_SYNTHESIZE_RETAIN(cocos2d::ui::Scale9Sprite*, _backgroundSprite, BackgroundSprite); /** The preferred size of the button, if label is larger it will be expanded. */ CC_PROPERTY_PASS_BY_REF(Size, _preferredSize, PreferredSize); /** Adjust the button zooming on touchdown. Default value is YES. */ CC_PROPERTY(bool, _zoomOnTouchDown, ZoomOnTouchDown); /** Scale ratio button on touchdown. Default value 1.1f */ CC_SYNTHESIZE(float, _scaleRatio, ScaleRatio); CC_PROPERTY_PASS_BY_REF(Vec2, _labelAnchorPoint, LabelAnchorPoint); std::unordered_map _titleDispatchTable; std::unordered_map _titleColorDispatchTable; Map _titleLabelDispatchTable; Map _backgroundSpriteDispatchTable; /* Define the button margin for Top/Bottom edge */ CC_SYNTHESIZE_READONLY(int, _marginV, VerticalMargin); /* Define the button margin for Left/Right edge */ CC_SYNTHESIZE_READONLY(int, _marginH, HorizontalOrigin); private: CC_DISALLOW_COPY_AND_ASSIGN(ControlButton); }; // end of GUI group /// @} /// @} NS_CC_EXT_END #endif