cocos代码研究（23）Widget子类ScrollView学习笔记

基础理论

一个能够被用户触摸滚动的一个层次型布局容器视图，允许其尺寸大于屏幕显示的物理尺寸，其内部维护有一个布局用于水平的或垂直的存放子节点。继承自 Layout，被 ListView 继承。

代码实践

void setBounceEnabled (bool enabled)
设置当滚动到边界时，是否内部容器发生弹回(bounce)效果

bool isBounceEnabled () const
获取边界弹回(bounce)状态。

void setInertiaScrollEnabled (bool enabled)
设置是否开启滚动惯性。

bool isInertiaScrollEnabled () const
获取滚动视图是否开启滚动惯性。

void setScrollBarEnabled (bool enabled)
设置是否启用滚动条。

bool isScrollBarEnabled () const
返回滚动条是否启用。

virtual void setDirection (Direction dir)
改变滚动视图的方向。

Direction getDirection () const
获取滚动视图的滚动方向。

Layout * getInnerContainer () const
获取滚动视图的内部布局容器，该布局容器为滚动视图的子节点。

//与滚动方位有关
void scrollToPercentVertical (float percent, float second, bool attenuated)
按百分比竖直滚动内部布局容器

void scrollToPercentHorizontal (float percent, float second, bool attenuated)
按百分比水平滚动内部布局容器

void scrollToPercentBothDirection (const Vec2 &percent, float second, bool attenuated)
在竖直方向和水平方向分别按一定的百分比滚动内部布局容器

void scrollToBottom (float second, bool attenuated)
将内部的布局容器滚动到滚动视图的底部边界。

void scrollToTop (float second, bool attenuated)
将内部布局容器滚动到滚动视图的顶部边界。

void scrollToLeft (float second, bool attenuated)
将内部容器滚动到滚动视图的左端边界

void scrollToRight (float time, bool attenuated)
将内部布局容器滚动到滚动视图的右端边界

void scrollToTopLeft (float second, bool attenuated)
滚动内部布局容器到滚动视图的左上角

void scrollToTopRight (float time, bool attenuated)
滚动内部布局容器到滚动使徒的右上角

void scrollToBottomLeft (float second, bool attenuated)
滚动内部布局容器到视图的左下角

void scrollToBottomRight (float time, bool attenuated)
滚动内部布局容器到视图的右下角

//与滚动条样式有关
void setScrollBarPositionFromCorner (const Vec2 &positionFromCorner)
设置滚动条水平位置和垂直位置。

void setScrollBarPositionFromCornerForVertical (const Vec2 &positionFromCorner)
设置滚动条垂直位置。

Vec2 getScrollBarPositionFromCornerForVertical () const
获得滚动条垂直位置。

void setScrollBarPositionFromCornerForHorizontal (const Vec2 &positionFromCorner)
设置滚动条水平位置。

Vec2 getScrollBarPositionFromCornerForHorizontal () const
获得滚动条水平位置。

void setScrollBarWidth (float width)
设置滚动条宽度。

float getScrollBarWidth () const
获取滚动条宽度。

void setScrollBarColor (const Color3B &color)
设置滚动条颜色。

const Color3B & getScrollBarColor () const
获取滚动条颜色。

void setScrollBarOpacity (GLubyte opacity)
设置滚动条透明度。

GLubyte getScrollBarOpacity () const
获取滚动条透明度。

void setScrollBarAutoHideEnabled (bool autoHideEnabled)
设置滚动条自动隐藏状态。

bool isScrollBarAutoHideEnabled () const
获取滚动条是否自动隐藏。

void setScrollBarAutoHideTime (float autoHideTime)
设置滚动条自动隐藏时间。

float getScrollBarAutoHideTime () const
获取滚动条是否自动隐藏。

//
void jumpToBottom ()
将内部布局容器移至视图底端。

void jumpToTop ()
将内部布局容器移至视图顶端。

void jumpToLeft ()
将内部布局容器移至视图左端。

void jumpToRight ()
将内部布局容器移至视图右端。

void jumpToTopLeft ()
将内部布局容器移至视图的左上角。

void jumpToTopRight ()
将内部布局容器移至视图的右上角。

void jumpToBottomLeft ()
将内部布局容器移至视图的左下角。

void jumpToBottomRight ()
将内部布局容器移至视图的右下角。

void jumpToPercentVertical (float percent)
按一定的百分比竖直滚动视图内的布局容器。

void jumpToPercentHorizontal (float percent)
按一定的百分比竖直滚动视图内的布局容器。

void jumpToPercentBothDirection (const Vec2 &percent)
竖直方向和水平方向分别按一定的百分比滚动容器。

void setInnerContainerSize (const Size &size)
设置滚动容器的滚动区域大小。

const Size & getInnerContainerSize () const
获取滚动容器的滚动区域大小。

void setInnerContainerPosition (const Vec2 &pos)
设置容器内的位置。

const Vec2 getInnerContainerPosition () const
获取容器内的位置。

void addEventListenerScrollView (Ref *target, SEL_ScrollViewEvent selector)
添加一个回调函数，该回调函数将会在视图发生滚动时触发。

virtual void addEventListener (const ccScrollViewCallback &callback)
添加一个回调函数，该回调函数将在滚动事件触发时被调用。

实例：

        Layout* root = static_cast<Layout*>(_uiLayer->getChildByTag());

        Layout* background = dynamic_cast<Layout*>(root->getChildByName("background_Panel"));

        ui::ScrollView* sc = ui::ScrollView::create();
        sc->setBackGroundColor(Color3B::GREEN);
        sc->setBackGroundColorType(Layout::BackGroundColorType::SOLID);
        sc->setBounceEnabled(true);
        sc->setDirection(ui::ScrollView::Direction::BOTH);
        sc->setInnerContainerSize(Size(, ));
        sc->setContentSize(Size(,));
        sc->setScrollBarPositionFromCornerForHorizontal(Vec2(, sc->getContentSize().height - ));
        sc->setScrollBarPositionFromCornerForVertical(Vec2(sc->getContentSize().width - , ));
        sc->setScrollBarAutoHideEnabled(false);
        Size backgroundSize = background->getContentSize();
        sc->setPosition(Vec2((widgetSize.width - backgroundSize.width) / 2.0f +
                              (backgroundSize.width - sc->getContentSize().width) / 2.0f,
                              (widgetSize.height - backgroundSize.height) / 2.0f +
                              (backgroundSize.height - sc->getContentSize().height) / 2.0f));
        sc->scrollToPercentBothDirection(Vec2(, ), , true);
        ImageView* iv = ImageView::create("cocosui/Hello.png");
        iv->setPosition(Vec2(, ));
        sc->addChild(iv);
        _uiLayer->addChild(sc);
        return true;