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 __UIHELPER_H__
|
|
|
|
#define __UIHELPER_H__
|
|
|
|
|
2014-05-22 10:49:28 +08:00
|
|
|
#include <string>
|
2014-09-10 08:17:07 +08:00
|
|
|
#include "platform/CCPlatformMacros.h"
|
2014-07-21 17:45:56 +08:00
|
|
|
#include "ui/GUIExport.h"
|
2014-10-09 18:28:09 +08:00
|
|
|
#include "2d/CCNode.h"
|
2014-05-22 10:49:28 +08:00
|
|
|
|
2014-03-11 17:13:54 +08:00
|
|
|
NS_CC_BEGIN
|
|
|
|
|
|
|
|
namespace ui {
|
2014-05-22 10:49:28 +08:00
|
|
|
|
|
|
|
class Widget;
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2014-07-21 17:45:56 +08:00
|
|
|
class CC_GUI_DLL Helper
|
2014-03-11 17:13:54 +08:00
|
|
|
{
|
|
|
|
public:
|
|
|
|
/**
|
|
|
|
* Finds a widget whose tag equals to param tag from root widget.
|
|
|
|
*
|
|
|
|
* @param root widget which will be seeked.
|
|
|
|
*
|
|
|
|
* @tag tag value.
|
|
|
|
*
|
|
|
|
* @return finded result.
|
|
|
|
*/
|
|
|
|
static Widget* seekWidgetByTag(Widget* root, int tag);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Finds a widget whose name equals to param name from root widget.
|
|
|
|
*
|
|
|
|
* @param root widget which will be seeked.
|
|
|
|
*
|
|
|
|
* @name name value.
|
|
|
|
*
|
|
|
|
* @return finded result.
|
|
|
|
*/
|
2014-05-12 14:59:00 +08:00
|
|
|
static Widget* seekWidgetByName(Widget* root, const std::string& name);
|
2014-03-11 17:13:54 +08:00
|
|
|
|
|
|
|
/*temp action*/
|
|
|
|
static Widget* seekActionWidgetByActionTag(Widget* root, int tag);
|
2014-07-28 17:24:37 +08:00
|
|
|
|
|
|
|
/**
|
2014-07-30 10:45:35 +08:00
|
|
|
* @brief Get a UTF8 substring from a std::string with a given start position and length
|
2014-10-09 17:19:43 +08:00
|
|
|
* Sample: std::string str = "中国中国中国"; substr = getSubStringOfUTF8String(str,0,2) will = "中国"
|
2014-07-28 17:24:37 +08:00
|
|
|
* @param start The start position of the substring.
|
2014-07-30 10:45:35 +08:00
|
|
|
* @param length The length of the substring in UTF8 count
|
|
|
|
* @return a UTF8 substring
|
2014-07-28 17:24:37 +08:00
|
|
|
*/
|
2014-07-30 10:45:35 +08:00
|
|
|
static std::string getSubStringOfUTF8String(const std::string& str,
|
2014-07-29 16:17:10 +08:00
|
|
|
std::string::size_type start,
|
|
|
|
std::string::size_type length);
|
2014-10-09 18:28:09 +08:00
|
|
|
|
|
|
|
static void doLayout(Node *rootNode);
|
2014-07-28 17:24:37 +08:00
|
|
|
|
2014-03-11 17:13:54 +08:00
|
|
|
};
|
|
|
|
}
|
|
|
|
|
|
|
|
NS_CC_END
|
|
|
|
|
|
|
|
#endif /* defined(__CocoGUI__UISystem__) */
|