/* * Copyright (c) 2012 cocos2d-x.org * http://www.cocos2d-x.org * * 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_SLIDER_H__ #define __CCCONTROL_SLIDER_H__ #include "CCControl.h" #include "CCInvocation.h" #include "extensions/ExtensionExport.h" NS_CC_EXT_BEGIN /** * @addtogroup GUI * @{ * @addtogroup control_extension * @{ */ class CC_EX_DLL ControlSlider: public Control { public: /** * Creates slider with a background filename, a progress filename and a * thumb image filename. */ static ControlSlider* create(const char* bgFile, const char* progressFile, const char* thumbFile); /** * Creates a slider with a given background sprite and a progress bar and a * thumb item. * * @see initWithSprites */ static ControlSlider* create(Sprite * backgroundSprite, Sprite* pogressSprite, Sprite* thumbSprite); /** * Creates slider with a background filename, a progress filename, a thumb * and a selected thumb image filename. */ static ControlSlider* create(const char* bgFile, const char* progressFile, const char* thumbFile, const char* selectedThumbSpriteFile); /** * Creates a slider with a given background sprite and a progress bar, a thumb * and a selected thumb . * * @see initWithSprites */ static ControlSlider* create(Sprite * backgroundSprite, Sprite* pogressSprite, Sprite* thumbSprite, Sprite* selectedThumbSprite); /** * @js ctor * @lua new */ ControlSlider(); /** * @js NA * @lua NA */ virtual ~ControlSlider(); /** * Initializes a slider with a background sprite, a progress bar and a thumb * item. * * @param backgroundSprite Sprite, that is used as a background. * @param progressSprite Sprite, that is used as a progress bar. * @param thumbSprite Sprite, that is used as a thumb. */ virtual bool initWithSprites(Sprite * backgroundSprite, Sprite* progressSprite, Sprite* thumbSprite); /** * Initializes a slider with a background sprite, a progress bar and a thumb * item. * * @param backgroundSprite Sprite, that is used as a background. * @param progressSprite Sprite, that is used as a progress bar. * @param thumbSprite Sprite, that is used as a thumb. * @param selectedThumbSprite Sprite, that is used as a selected thumb. */ virtual bool initWithSprites(Sprite * backgroundSprite, Sprite* progressSprite, Sprite* thumbSprite, Sprite* selectedThumbSprite); virtual void needsLayout() override; virtual void setMaximumValue(float val); virtual void setEnabled(bool enabled) override; virtual bool isTouchInside(Touch * touch) override; Vec2 locationFromTouch(Touch* touch); virtual void setValue(float val); virtual void setMinimumValue(float val); protected: void sliderBegan(Vec2 location); void sliderMoved(Vec2 location); void sliderEnded(Vec2 location); virtual bool onTouchBegan(Touch* touch, Event* pEvent) override; virtual void onTouchMoved(Touch *pTouch, Event *pEvent) override; virtual void onTouchEnded(Touch *pTouch, Event *pEvent) override; /** Returns the value for the given location. */ float valueForLocation(Vec2 location); //manually put in the setters /** Contains the receiver's current value. */ CC_SYNTHESIZE_READONLY(float, _value, Value); /** Contains the minimum value of the receiver. * The default value of this property is 0.0. */ CC_SYNTHESIZE_READONLY(float, _minimumValue, MinimumValue); /** Contains the maximum value of the receiver. * The default value of this property is 1.0. */ CC_SYNTHESIZE_READONLY(float, _maximumValue, MaximumValue); CC_SYNTHESIZE(float, _minimumAllowedValue, MinimumAllowedValue); CC_SYNTHESIZE(float, _maximumAllowedValue, MaximumAllowedValue); // maybe this should be read-only CC_SYNTHESIZE_RETAIN(Sprite*, _thumbSprite, ThumbSprite); CC_SYNTHESIZE_RETAIN(Sprite*, _selectedThumbSprite, SelectedThumbSprite); CC_SYNTHESIZE_RETAIN(Sprite*, _progressSprite, ProgressSprite); CC_SYNTHESIZE_RETAIN(Sprite*, _backgroundSprite, BackgroundSprite); }; // end of GUI group /// @} /// @} NS_CC_EXT_END #endif