Cocos2d-x  v4
PageView Class Reference

Layout manager that allows the user to flip left & right and up & down through pages of data. More...

Inherits ListView.

Public Types

enum  EventType
 Page turn event type.
 
enum  TouchDirection
 Touch direction type.
 
typedef std::function< void(Ref *, EventType)> ccPageViewCallback
 PageView page turn event callback.
 
- Public Types inherited from ListView
enum  Gravity
 Gravity for docking elements in ListView.
 
enum  EventType
 ListView element item click event.
 
enum  MagneticType
 ListView supports magnetic scroll. More...
 
typedef std::function< void(Ref *, EventType)> ccListViewCallback
 ListView item click callback.
 
- Public Types inherited from ScrollView
enum  Direction
 ScrollView scroll direction type.
 
enum  EventType
 Scrollview scroll event type.
 
typedef std::function< void(Ref *, EventType)> ccScrollViewCallback
 A callback which would be called when a ScrollView is scrolling.
 
- Public Types inherited from Layout
enum  Type
 Layout type, default is ABSOLUTE.
 
enum  ClippingType
 Clipping Type, default is STENCIL.
 
enum  BackGroundColorType
 Background color type, default is NONE.
 
- Public Types inherited from Widget
enum  FocusDirection
 Widget focus direction.
 
enum  PositionType
 Widget position type for layout.
 
enum  SizeType
 Widget size type for layout.
 
enum  TouchEventType
 Touch event type.
 
enum  TextureResType
 Texture resource type. More...
 
enum  BrightStyle
 Widget bright style.
 
typedef std::function< void(Ref *, Widget::TouchEventType)> ccWidgetTouchCallback
 Widget touch event callback.
 
typedef std::function< void(Ref *)> ccWidgetClickCallback
 Widget click event callback.
 
typedef std::function< void(Ref *, int)> ccWidgetEventCallback
 Widget custom event callback. More...
 

Public Member Functions

 PageView ()
 Default constructor @js ctor @lua new.
 
virtual ~PageView ()
 Default destructor @js NA @lua NA.
 
virtual void setDirection (Direction direction) override
 Changes direction Direction Direction::VERTICAL means vertical scroll, Direction::HORIZONTAL means horizontal scroll. More...
 
void addPage (Widget *page)
 Insert a page into the end of PageView. More...
 
void insertPage (Widget *page, int idx)
 Insert a page into PageView at a given index. More...
 
void removePage (Widget *page)
 Remove a page of PageView. More...
 
void removePageAtIndex (ssize_t index)
 Remove a page at a given index of PageView. More...
 
void removeAllPages ()
 Remove all pages of the PageView.
 
void scrollToPage (ssize_t idx)
 Scroll to a page with a given index. More...
 
void scrollToPage (ssize_t idx, float time)
 Scroll to a page with a given index and with a given scroll time. More...
 
void scrollToItem (ssize_t itemIndex)
 Scroll to a page with a given index. More...
 
void scrollToItem (ssize_t idx, float time)
 Scroll to a item with a given index and with a given scroll time. More...
 
ssize_t getCurrentPageIndex ()
 Gets current displayed page index. More...
 
void setCurrentPageIndex (ssize_t index)
 Jump to a page with a given index without scrolling. More...
 
void addEventListener (const ccPageViewCallback &callback)
 Add a page turn callback to PageView, then when one page is turning, the callback will be called. More...
 
virtual std::string getDescription () const override
 Return the "class name" of widget.
 
void setIndicatorEnabled (bool enabled)
 Toggle page indicator enabled. More...
 
bool getIndicatorEnabled () const
 Query page indicator state. More...
 
void setIndicatorPositionAsAnchorPoint (const Vec2 &positionAsAnchorPoint)
 Set the page indicator's position using anchor point. More...
 
const Vec2getIndicatorPositionAsAnchorPoint () const
 Get the page indicator's position as anchor point. More...
 
void setIndicatorPosition (const Vec2 &position)
 Set the page indicator's position in page view. More...
 
const Vec2getIndicatorPosition () const
 Get the page indicator's position. More...
 
void setIndicatorSpaceBetweenIndexNodes (float spaceBetweenIndexNodes)
 Set space between page indicator's index nodes. More...
 
float getIndicatorSpaceBetweenIndexNodes () const
 Get the space between page indicator's index nodes. More...
 
void setIndicatorSelectedIndexColor (const Color3B &color)
 Set color of page indicator's selected index. More...
 
const Color3BgetIndicatorSelectedIndexColor () const
 Get the color of page indicator's selected index. More...
 
void setIndicatorIndexNodesColor (const Color3B &color)
 Set color of page indicator's index nodes. More...
 
const Color3BgetIndicatorIndexNodesColor () const
 Get the color of page indicator's index nodes. More...
 
void setIndicatorSelectedIndexOpacity (uint8_t opacity)
 Set opacity of page indicator's selected index. More...
 
uint8_t getIndicatorSelectedIndexOpacity () const
 Get the opacity of page indicator's selected index. More...
 
void setIndicatorIndexNodesOpacity (uint8_t opacity)
 Set opacity of page indicator's index nodes. More...
 
uint8_t getIndicatorIndexNodesOpacity () const
 Get the opacity of page indicator's index nodes. More...
 
void setIndicatorIndexNodesScale (float indexNodesScale)
 Set scale of page indicator's index nodes. More...
 
void setIndicatorIndexNodesTexture (const std::string &texName, Widget::TextureResType texType=Widget::TextureResType::LOCAL)
 sets texture for index nodes. More...
 
float getIndicatorIndexNodesScale () const
 Get scale of page indicator's index nodes. More...
 
virtual void addEventListener (const ccScrollViewCallback &callback)
 Add callback function which will be called when scrollview event triggered. More...
 
- Public Member Functions inherited from ListView
 ListView ()
 Default constructor @js ctor @lua new.
 
virtual ~ListView ()
 Default destructor @js NA @lua NA.
 
void setItemModel (Widget *model)
 Set an item model for listview. More...
 
void pushBackDefaultItem ()
 Insert a default item(create by a cloned model) at the end of the listview.
 
void insertDefaultItem (ssize_t index)
 Insert a default item(create by cloning model) into listview at a give index. More...
 
void pushBackCustomItem (Widget *item)
 Insert a custom item into the end of ListView. More...
 
void insertCustomItem (Widget *item, ssize_t index)
 Insert a custom widget into ListView at a given index. More...
 
void removeLastItem ()
 Removes the last item of ListView.
 
void removeItem (ssize_t index)
 Remove an item at given index. More...
 
void removeAllItems ()
 Remove all items in current ListView.
 
WidgetgetItem (ssize_t index) const
 Return an item at a given index. More...
 
Vector< Widget * > & getItems ()
 Return all items in a ListView. More...
 
ssize_t getIndex (Widget *item) const
 Return the index of specified widget. More...
 
void setGravity (Gravity gravity)
 Set the gravity of ListView. More...
 
void setMagneticType (MagneticType magneticType)
 Set magnetic type of ListView. More...
 
MagneticType getMagneticType () const
 Get magnetic type of ListView.
 
void setMagneticAllowedOutOfBoundary (bool magneticAllowedOutOfBoundary)
 Set magnetic allowed out of boundary.
 
bool getMagneticAllowedOutOfBoundary () const
 Query whether the magnetic out of boundary is allowed.
 
void setItemsMargin (float margin)
 Set the margin between each item in ListView. More...
 
float getItemsMargin () const
 Query margin between each item in ListView. More...
 
void setPadding (float l, float t, float r, float b)
 Change padding with left, top, right, and bottom padding. More...
 
void setLeftPadding (float l)
 Change padding with left padding. More...
 
void setTopPadding (float t)
 Change padding with top padding. More...
 
void setRightPadding (float r)
 Change padding with right padding. More...
 
void setBottomPadding (float b)
 Change padding with bottom padding. More...
 
float getLeftPadding () const
 Get the left padding in ListView. More...
 
float getTopPadding () const
 Get the top padding in ListView. More...
 
float getRightPadding () const
 Get the right padding in ListView. More...
 
float getBottomPadding () const
 Get the bottom padding in ListView. More...
 
void setScrollDuration (float time)
 Set the time in seconds to scroll between items. More...
 
float getScrollDuration () const
 Get the time in seconds to scroll between items. More...
 
virtual void requestDoLayout () override
 request to refresh widget layout
 
virtual void addChild (Node *child) override
 Adds a child to the container with z-order as 0. More...
 
virtual void addChild (Node *child, int localZOrder) override
 Adds a child to the container with a local z-order. More...
 
virtual void addChild (Node *child, int zOrder, int tag) override
 Adds a child to the container with z order and tag. More...
 
virtual void addChild (Node *child, int zOrder, const std::string &name) override
 Adds a child to the container with z order and tag. More...
 
virtual void removeAllChildren () override
 Removes all children from the container with a cleanup. More...
 
virtual void removeAllChildrenWithCleanup (bool cleanup) override
 Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter. More...
 
virtual void removeChild (Node *child, bool cleanup=true) override
 Removes a child from the container. More...
 
WidgetgetClosestItemToPosition (const Vec2 &targetPosition, const Vec2 &itemAnchorPoint) const
 Query the closest item to a specific position in inner container. More...
 
WidgetgetClosestItemToPositionInCurrentView (const Vec2 &positionRatioInView, const Vec2 &itemAnchorPoint) const
 Query the closest item to a specific position in current view. More...
 
WidgetgetCenterItemInCurrentView () const
 Query the center item. More...
 
WidgetgetLeftmostItemInCurrentView () const
 Query the leftmost item in horizontal list. More...
 
WidgetgetRightmostItemInCurrentView () const
 Query the rightmost item in horizontal list. More...
 
WidgetgetTopmostItemInCurrentView () const
 Query the topmost item in horizontal list. More...
 
WidgetgetBottommostItemInCurrentView () const
 Query the bottommost item in horizontal list. More...
 
virtual void jumpToBottom () override
 Override functions.
 
virtual void jumpToTop () override
 Move inner container to top boundary of scrollview.
 
virtual void jumpToLeft () override
 Move inner container to left boundary of scrollview.
 
virtual void jumpToRight () override
 Move inner container to right boundary of scrollview.
 
virtual void jumpToTopLeft () override
 Move inner container to top and left boundary of scrollview.
 
virtual void jumpToTopRight () override
 Move inner container to top and right boundary of scrollview.
 
virtual void jumpToBottomLeft () override
 Move inner container to bottom and left boundary of scrollview.
 
virtual void jumpToBottomRight () override
 Move inner container to bottom and right boundary of scrollview.
 
virtual void jumpToPercentVertical (float percent) override
 Move inner container to vertical percent position of scrollview. More...
 
virtual void jumpToPercentHorizontal (float percent) override
 Move inner container to horizontal percent position of scrollview. More...
 
virtual void jumpToPercentBothDirection (const Vec2 &percent) override
 Move inner container to both direction percent position of scrollview. More...
 
void jumpToItem (ssize_t itemIndex, const Vec2 &positionRatioInView, const Vec2 &itemAnchorPoint)
 Jump to specific item. More...
 
void scrollToItem (ssize_t itemIndex, const Vec2 &positionRatioInView, const Vec2 &itemAnchorPoint)
 Scroll to specific item. More...
 
ssize_t getCurSelectedIndex () const
 Query current selected widget's index. More...
 
void setCurSelectedIndex (int itemIndex)
 Set current selected widget's index and call TouchEventType::ENDED event. More...
 
virtual void addEventListener (const ccScrollViewCallback &callback)
 Add callback function which will be called when scrollview event triggered. More...
 
- Public Member Functions inherited from ScrollView
 ScrollView ()
 Default constructor @js ctor @lua new.
 
virtual ~ScrollView ()
 Default destructor @js NA @lua NA.
 
Direction getDirection () const
 Query scroll direction of scrollview. More...
 
LayoutgetInnerContainer () const
 Get inner container of scrollview. More...
 
virtual void stopScroll ()
 Immediately stops inner container scroll (auto scrolling is not affected).
 
virtual void stopAutoScroll ()
 Immediately stops inner container scroll initiated by any of the "scrollTo*" member functions.
 
virtual void stopOverallScroll ()
 Immediately stops inner container scroll if any.
 
virtual void scrollToBottom (float timeInSec, bool attenuated)
 Scroll inner container to bottom boundary of scrollview. More...
 
virtual void scrollToTop (float timeInSec, bool attenuated)
 Scroll inner container to top boundary of scrollview. More...
 
virtual void scrollToLeft (float timeInSec, bool attenuated)
 Scroll inner container to left boundary of scrollview. More...
 
virtual void scrollToRight (float timeInSec, bool attenuated)
 Scroll inner container to right boundary of scrollview. More...
 
virtual void scrollToTopLeft (float timeInSec, bool attenuated)
 Scroll inner container to top and left boundary of scrollview. More...
 
virtual void scrollToTopRight (float timeInSec, bool attenuated)
 Scroll inner container to top and right boundary of scrollview. More...
 
virtual void scrollToBottomLeft (float timeInSec, bool attenuated)
 Scroll inner container to bottom and left boundary of scrollview. More...
 
virtual void scrollToBottomRight (float timeInSec, bool attenuated)
 Scroll inner container to bottom and right boundary of scrollview. More...
 
virtual void scrollToPercentVertical (float percent, float timeInSec, bool attenuated)
 Scroll inner container to vertical percent position of scrollview. More...
 
virtual void scrollToPercentHorizontal (float percent, float timeInSec, bool attenuated)
 Scroll inner container to horizontal percent position of scrollview. More...
 
virtual void scrollToPercentBothDirection (const Vec2 &percent, float timeInSec, bool attenuated)
 Scroll inner container to both direction percent position of scrollview. More...
 
float getScrolledPercentVertical () const
 
float getScrolledPercentHorizontal () const
 
Vec2 getScrolledPercentBothDirection () const
 
void setInnerContainerSize (const Size &size)
 Change inner container size of scrollview. More...
 
const Size & getInnerContainerSize () const
 Get inner container size of scrollview. More...
 
void setInnerContainerPosition (const Vec2 &pos)
 Set inner container position. More...
 
const Vec2getInnerContainerPosition () const
 Get inner container position. More...
 
virtual Vector< Node * > & getChildren () override
 Returns the array of the node's children. More...
 
virtual ssize_t getChildrenCount () const override
 Returns the amount of children. More...
 
virtual NodegetChildByTag (int tag) const override
 Gets a child from the container with its tag. More...
 
virtual NodegetChildByName (const std::string &name) const override
 Gets a child from the container with its name. More...
 
virtual bool onTouchBegan (Touch *touch, Event *unusedEvent) override
 A callback which will be called when touch began event is issued. More...
 
virtual void onTouchMoved (Touch *touch, Event *unusedEvent) override
 A callback which will be called when touch moved event is issued. More...
 
virtual void onTouchEnded (Touch *touch, Event *unusedEvent) override
 A callback which will be called when touch ended event is issued. More...
 
virtual void onTouchCancelled (Touch *touch, Event *unusedEvent) override
 A callback which will be called when touch cancelled event is issued. More...
 
virtual void update (float dt) override
 Update method will be called automatically every frame if "scheduleUpdate" is called, and the node is "live". More...
 
void setBounceEnabled (bool enabled)
 Toggle bounce enabled when scroll to the edge. More...
 
bool isBounceEnabled () const
 Query bounce state. More...
 
void setInertiaScrollEnabled (bool enabled)
 Toggle whether enable scroll inertia while scrolling. More...
 
bool isInertiaScrollEnabled () const
 Query inertia scroll state. More...
 
void setScrollBarEnabled (bool enabled)
 Toggle scroll bar enabled. More...
 
bool isScrollBarEnabled () const
 Query scroll bar state. More...
 
void setScrollBarPositionFromCorner (const Vec2 &positionFromCorner)
 Set the scroll bar positions from the left-bottom corner (horizontal) and right-top corner (vertical). More...
 
void setScrollBarPositionFromCornerForVertical (const Vec2 &positionFromCorner)
 Set the vertical scroll bar position from right-top corner. More...
 
Vec2 getScrollBarPositionFromCornerForVertical () const
 Get the vertical scroll bar's position from right-top corner. More...
 
void setScrollBarPositionFromCornerForHorizontal (const Vec2 &positionFromCorner)
 Set the horizontal scroll bar position from left-bottom corner. More...
 
Vec2 getScrollBarPositionFromCornerForHorizontal () const
 Get the horizontal scroll bar's position from right-top corner. More...
 
void setScrollBarWidth (float width)
 Set the scroll bar's width. More...
 
float getScrollBarWidth () const
 Get the scroll bar's width. More...
 
void setScrollBarColor (const Color3B &color)
 Set the scroll bar's color. More...
 
const Color3BgetScrollBarColor () const
 Get the scroll bar's color. More...
 
void setScrollBarOpacity (uint8_t opacity)
 Set the scroll bar's opacity. More...
 
uint8_t getScrollBarOpacity () const
 Get the scroll bar's opacity. More...
 
void setScrollBarAutoHideEnabled (bool autoHideEnabled)
 Set scroll bar auto hide state. More...
 
bool isScrollBarAutoHideEnabled () const
 Query scroll bar auto hide state. More...
 
void setScrollBarAutoHideTime (float autoHideTime)
 Set scroll bar auto hide time. More...
 
float getScrollBarAutoHideTime () const
 Get the scroll bar's auto hide time. More...
 
void setTouchTotalTimeThreshold (float touchTotalTimeThreshold)
 Set the touch total time threshold. More...
 
float getTouchTotalTimeThreshold () const
 Get the touch total time threshold. More...
 
virtual void setLayoutType (Type type) override
 Set layout type for scrollview. More...
 
virtual Type getLayoutType () const override
 Get the layout type for scrollview. More...
 
virtual void onEnter () override
 @lua NA
 
virtual void onExit () override
 @lua NA
 
virtual WidgetfindNextFocusedWidget (FocusDirection direction, Widget *current) override
 When a widget is in a layout, you could call this method to get the next focused widget within a specified direction. More...
 
bool isScrolling () const
 
bool isAutoScrolling () const
 
- Public Member Functions inherited from Layout
 Layout ()
 Default constructor @js ctor @lua new.
 
virtual ~Layout ()
 Default destructor @js NA @lua NA.
 
void setBackGroundImage (const std::string &fileName, TextureResType texType=TextureResType::LOCAL)
 Sets a background image for layout. More...
 
void setBackGroundImageCapInsets (const Rect &capInsets)
 Sets a background image capinsets for layout, it only affects the scale9 enabled background image. More...
 
const RectgetBackGroundImageCapInsets () const
 Query background image's capInsets size. More...
 
void setBackGroundColorType (BackGroundColorType type)
 Sets Color Type for layout's background. More...
 
BackGroundColorType getBackGroundColorType () const
 Query the layout's background color type. More...
 
void setBackGroundImageScale9Enabled (bool enabled)
 Enable background image scale9 rendering. More...
 
bool isBackGroundImageScale9Enabled () const
 Query background image scale9 enable status. More...
 
void setBackGroundColor (const Color3B &color)
 Set background color for layout The color only applies to layout when it's color type is BackGroundColorType::SOLIDE. More...
 
const Color3BgetBackGroundColor () const
 Query the layout's background color. More...
 
void setBackGroundColor (const Color3B &startColor, const Color3B &endColor)
 Set start and end background color for layout. More...
 
const Color3BgetBackGroundStartColor () const
 Get the gradient background start color. More...
 
const Color3BgetBackGroundEndColor () const
 Get the gradient background end color. More...
 
void setBackGroundColorOpacity (uint8_t opacity)
 Sets background color opacity of layout. More...
 
uint8_t getBackGroundColorOpacity () const
 Get the layout's background color opacity. More...
 
void setBackGroundColorVector (const Vec2 &vector)
 Sets background color vector for layout. More...
 
const Vec2getBackGroundColorVector () const
 Get the layout's background color vector. More...
 
void setBackGroundImageColor (const Color3B &color)
 Set layout's background image color. More...
 
void setBackGroundImageOpacity (uint8_t opacity)
 Set opacity of background image. More...
 
const Color3BgetBackGroundImageColor () const
 Get color of layout's background image. More...
 
uint8_t getBackGroundImageOpacity () const
 Get the opacity of layout's background image. More...
 
void removeBackGroundImage ()
 Remove the background image of layout.
 
const Size & getBackGroundImageTextureSize () const
 Gets background image texture size. More...
 
virtual void setClippingEnabled (bool enabled)
 Toggle layout clipping. More...
 
void setClippingType (ClippingType type)
 Change the clipping type of layout. More...
 
ClippingType getClippingType () const
 
virtual bool isClippingEnabled () const
 Gets if layout is clipping enabled. More...
 
virtual void visit (Renderer *renderer, const Mat4 &parentTransform, uint32_t parentFlags) override
 @js NA
 
virtual void forceDoLayout ()
 force refresh widget layout
 
virtual void setGlobalZOrder (float globalZOrder) override
 Defines the order in which the nodes are renderer. More...
 
void setLoopFocus (bool loop)
 If a layout is loop focused which means that the focus movement will be inside the layout. More...
 
bool isLoopFocus () const
 
void setPassFocusToChild (bool pass)
 
bool isPassFocusToChild () const
 
virtual void setCameraMask (unsigned short mask, bool applyChildren=true) override
 Override function. More...
 
- Public Member Functions inherited from Widget
 Widget ()
 Default constructor @js ctor @lua new.
 
virtual ~Widget ()
 Default destructor @js NA @lua NA.
 
virtual void setEnabled (bool enabled)
 Sets whether the widget is enabled. More...
 
bool isEnabled () const
 Determines if the widget is enabled or not. More...
 
void setBright (bool bright)
 Sets whether the widget is bright. More...
 
bool isBright () const
 Determines if the widget is bright. More...
 
virtual void setTouchEnabled (bool enabled)
 Sets whether the widget is touch enabled. More...
 
void setBrightStyle (BrightStyle style)
 To set the bright style of widget. More...
 
bool isTouchEnabled () const
 Determines if the widget is touch enabled. More...
 
bool isHighlighted () const
 Determines if the widget is highlighted. More...
 
void setHighlighted (bool highlight)
 Sets whether the widget is highlighted. More...
 
float getLeftBoundary () const
 Gets the left boundary position of this widget in parent's coordination system. More...
 
float getBottomBoundary () const
 Gets the bottom boundary position of this widget in parent's coordination system. More...
 
float getRightBoundary () const
 Gets the right boundary position of this widget in parent's coordination system. More...
 
float getTopBoundary () const
 Gets the top boundary position of this widget in parent's coordination system. More...
 
void addTouchEventListener (const ccWidgetTouchCallback &callback)
 Set a callback to touch vent listener. More...
 
void addClickEventListener (const ccWidgetClickCallback &callback)
 Set a click event handler to the widget. More...
 
virtual void addCCSEventListener (const ccWidgetEventCallback &callback)
 Set a event handler to the widget in order to use cocostudio editor and framework. More...
 
virtual void setPosition (const Vec2 &pos) override
 Changes the position (x,y) of the widget in OpenGL coordinates. More...
 
void setPositionPercent (const Vec2 &percent)
 Set the percent(x,y) of the widget in OpenGL coordinates. More...
 
const Vec2getPositionPercent ()
 Gets the percent (x,y) of the widget in OpenGL coordinates. More...
 
void setPositionType (PositionType type)
 Changes the position type of the widget. More...
 
PositionType getPositionType () const
 Gets the position type of the widget. More...
 
virtual void setFlippedX (bool flippedX)
 Sets whether the widget should be flipped horizontally or not. More...
 
virtual bool isFlippedX () const
 Returns the flag which indicates whether the widget is flipped horizontally or not. More...
 
virtual void setFlippedY (bool flippedY)
 Sets whether the widget should be flipped vertically or not. More...
 
virtual bool isFlippedY () const
 Return the flag which indicates whether the widget is flipped vertically or not. More...
 
virtual void setScaleX (float scaleX) override
 Sets the scale (x) of the node. More...
 
virtual void setScaleY (float scaleY) override
 Sets the scale (y) of the node. More...
 
virtual void setScale (float scale) override
 Sets the scale (x,y,z) of the node. More...
 
virtual void setScale (float scalex, float scaley) override
 Sets the scale (x,y) of the node. More...
 
virtual float getScaleX () const override
 Returns the scale factor on X axis of this node. More...
 
virtual float getScaleY () const override
 Returns the scale factor on Y axis of this node. More...
 
virtual float getScale () const override
 Gets the scale factor of the node, when X and Y have the same scale factor. More...
 
bool isClippingParentContainsPoint (const Vec2 &pt)
 Checks a point if in parent's area. More...
 
const Vec2getTouchBeganPosition () const
 Gets the touch began point of widget when widget is selected. More...
 
virtual void setContentSize (const Size &contentSize) override
 Changes the size that is widget's size. More...
 
virtual void setSizePercent (const Vec2 &percent)
 Changes the percent that is widget's percent size. More...
 
void setSizeType (SizeType type)
 Changes the size type of widget. More...
 
SizeType getSizeType () const
 Gets the size type of widget. More...
 
const Size & getCustomSize () const
 Get the user defined widget size. More...
 
virtual const Size & getLayoutSize ()
 Get the content size of widget. More...
 
const Vec2getSizePercent ()
 Get size percent of widget. More...
 
virtual bool hitTest (const Vec2 &pt, const Camera *camera, Vec3 *p) const
 Checks a point is in widget's content space. More...
 
void setLayoutParameter (LayoutParameter *parameter)
 Sets a LayoutParameter to widget. More...
 
LayoutParametergetLayoutParameter () const override
 Gets LayoutParameter of widget. More...
 
virtual void ignoreContentAdaptWithSize (bool ignore)
 Toggle whether ignore user defined content size for widget. More...
 
bool isIgnoreContentAdaptWithSize () const
 Query whether the widget ignores user defined content size or not. More...
 
Vec2 getWorldPosition () const
 Gets position of widget in world space. More...
 
virtual NodegetVirtualRenderer ()
 Gets the inner Renderer node of widget. More...
 
virtual Size getVirtualRendererSize () const
 Get the virtual renderer's size. More...
 
Widgetclone ()
 Create a new widget copy of the original one. More...
 
void updateSizeAndPosition ()
 Update all children's contents size and position recursively. More...
 
void updateSizeAndPosition (const Size &parentSize)
 Update all children's contents size and position recursively.
 
void setActionTag (int tag)
 Set the tag of action. More...
 
int getActionTag () const
 Get the action tag. More...
 
void setPropagateTouchEvents (bool isPropagate)
 Allow widget touch events to propagate to its parents. More...
 
bool isPropagateTouchEvents () const
 Return whether the widget is propagate touch events to its parents or not. More...
 
void setSwallowTouches (bool swallow)
 Toggle widget swallow touch option. More...
 
bool isSwallowTouches () const
 Return whether the widget is swallowing touch or not. More...
 
bool isFocused () const
 Query whether widget is focused or not. More...
 
void setFocused (bool focus)
 Toggle widget focus status. More...
 
bool isFocusEnabled () const
 Query widget's focus enable state. More...
 
void setFocusEnabled (bool enable)
 Allow widget to accept focus. More...
 
void requestFocus ()
 when a widget calls this method, it will get focus immediately.
 
void setUnifySizeEnabled (bool enable)
 Toggle use unify size. More...
 
bool isUnifySizeEnabled () const
 Query whether unify size enable state. More...
 
void setCallbackName (const std::string &callbackName)
 Set callback name. More...
 
const std::string & getCallbackName () const
 Query callback name. More...
 
void setCallbackType (const std::string &callbackType)
 Set callback type. More...
 
const std::string & getCallbackType () const
 Query callback type. More...
 
void setLayoutComponentEnabled (bool enable)
 Toggle layout component enable. More...
 
bool isLayoutComponentEnabled () const
 Query whether layout component is enabled or not. More...
 
virtual void setScaleZ (float scaleZ)
 Changes the scale factor on Z axis of this node. More...
 
virtual float getScaleZ () const
 Returns the scale factor on Z axis of this node. More...
 
- Public Member Functions inherited from ProtectedNode
virtual void cleanup () override
 Stops all running actions and schedulers.
 
virtual void onEnterTransitionDidFinish () override
 Event callback that is invoked when the Node enters in the 'stage'. More...
 
virtual void onExitTransitionDidStart () override
 Event callback that is called every time the Node leaves the 'stage'. More...
 
virtual void updateDisplayedOpacity (uint8_t parentOpacity) override
 Update the displayed opacity of node with it's parent opacity;. More...
 
virtual void updateDisplayedColor (const Color3B &parentColor) override
 Update node's displayed color with its parent color. More...
 
virtual void addProtectedChild (Node *child)
 Adds a child to the container with z-order as 0. More...
 
virtual void addProtectedChild (Node *child, int localZOrder)
 Adds a child to the container with a local z-order. More...
 
virtual void addProtectedChild (Node *child, int localZOrder, int tag)
 Adds a child to the container with z order and tag. More...
 
virtual NodegetProtectedChildByTag (int tag)
 Gets a child from the container with its tag. More...
 
virtual void removeProtectedChild (Node *child, bool cleanup=true)
 Removes a child from the container. More...
 
virtual void removeProtectedChildByTag (int tag, bool cleanup=true)
 Removes a child from the container by tag value. More...
 
virtual void removeAllProtectedChildren ()
 Removes all children from the container with a cleanup. More...
 
virtual void removeAllProtectedChildrenWithCleanup (bool cleanup)
 Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter. More...
 
virtual void reorderProtectedChild (Node *child, int localZOrder)
 Reorders a child according to a new z value. More...
 
virtual void sortAllProtectedChildren ()
 Sorts the children array once before drawing, instead of every time when a child is added or reordered. More...
 
- Public Member Functions inherited from Node
virtual bool isRunning () const
 Returns whether or not the node is "running". More...
 
void scheduleUpdateWithPriorityLua (int handler, int priority)
 Schedules for lua script. More...
 
virtual void draw (Renderer *renderer, const Mat4 &transform, uint32_t flags)
 Override this method to draw your own node. More...
 
virtual ScenegetScene () const
 Returns the Scene that contains the Node. More...
 
virtual Rect getBoundingBox () const
 Returns an AABB (axis-aligned bounding-box) in its parent's coordinate system. More...
 
virtual void setEventDispatcher (EventDispatcher *dispatcher)
 Set event dispatcher for scene. More...
 
virtual EventDispatchergetEventDispatcher () const
 Get the event dispatcher of scene. More...
 
virtual uint8_t getOpacity () const
 Return the node's opacity. More...
 
virtual uint8_t getDisplayedOpacity () const
 Return the node's display opacity. More...
 
virtual void setOpacity (uint8_t opacity)
 Change node opacity. More...
 
virtual bool isCascadeOpacityEnabled () const
 Whether cascadeOpacity is enabled or not. More...
 
virtual void setCascadeOpacityEnabled (bool cascadeOpacityEnabled)
 Change node's cascadeOpacity property. More...
 
virtual const Color3BgetColor () const
 Query node's color value. More...
 
virtual const Color3BgetDisplayedColor () const
 Query node's displayed color. More...
 
virtual void setColor (const Color3B &color)
 Change the color of node. More...
 
virtual bool isCascadeColorEnabled () const
 Query whether cascadeColor is enabled or not. More...
 
virtual void setCascadeColorEnabled (bool cascadeColorEnabled)
 If you want node's color affect the children node's color, then set it to true. More...
 
virtual void setOpacityModifyRGB (bool value)
 If you want the opacity affect the color property, then set to true. More...
 
virtual bool isOpacityModifyRGB () const
 If node opacity will modify the RGB color value, then you should override this method and return true. More...
 
void setOnEnterCallback (const std::function< void()> &callback)
 Set the callback of event onEnter. More...
 
const std::function< void()> & getOnEnterCallback () const
 Get the callback of event onEnter. More...
 
void setOnExitCallback (const std::function< void()> &callback)
 Set the callback of event onExit. More...
 
const std::function< void()> & getOnExitCallback () const
 Get the callback of event onExit. More...
 
void setOnEnterTransitionDidFinishCallback (const std::function< void()> &callback)
 Set the callback of event EnterTransitionDidFinish. More...
 
const std::function< void()> & getOnEnterTransitionDidFinishCallback () const
 Get the callback of event EnterTransitionDidFinish. More...
 
void setOnExitTransitionDidStartCallback (const std::function< void()> &callback)
 Set the callback of event ExitTransitionDidStart. More...
 
const std::function< void()> & getOnExitTransitionDidStartCallback () const
 Get the callback of event ExitTransitionDidStart. More...
 
unsigned short getCameraMask () const
 get & set camera mask, the node is visible by the camera whose camera flag & node's camera mask is true
 
virtual void setLocalZOrder (std::int32_t localZOrder)
 LocalZOrder is the 'key' used to sort the node relative to its siblings. More...
 
virtual void _setLocalZOrder (std::int32_t z)
 
void updateOrderOfArrival ()
 !!! ONLY FOR INTERNAL USE Sets the arrival order when this node has a same ZOrder with other children. More...
 
virtual std::int32_t getLocalZOrder () const
 Gets the local Z order of this node. More...
 
virtual float getGlobalZOrder () const
 Returns the Node's Global Z Order. More...
 
virtual void setScaleZ (float scaleZ)
 Changes the scale factor on Z axis of this node. More...
 
virtual float getScaleZ () const
 Returns the scale factor on Z axis of this node. More...
 
virtual void setPositionNormalized (const Vec2 &position)
 Sets the position (x,y) using values between 0 and 1. More...
 
virtual void setNormalizedPosition (const Vec2 &position)
 
virtual const Vec2getPosition () const
 Gets the position (x,y) of the node in its parent's coordinate system. More...
 
virtual const Vec2getPositionNormalized () const
 Returns the normalized position. More...
 
virtual const Vec2getNormalizedPosition () const
 
virtual void setPosition (float x, float y)
 Sets the position (x,y) of the node in its parent's coordinate system. More...
 
virtual void getPosition (float *x, float *y) const
 Gets position in a more efficient way, returns two number instead of a Vec2 object. More...
 
virtual void setPositionX (float x)
 Gets/Sets x or y coordinate individually for position. More...
 
virtual float getPositionX () const
 Gets the x coordinate of the node in its parent's coordinate system. More...
 
virtual void setPositionY (float y)
 Sets the y coordinate of the node in its parent's coordinate system. More...
 
virtual float getPositionY () const
 Gets the y coordinate of the node in its parent's coordinate system. More...
 
virtual void setPosition3D (const Vec3 &position)
 Sets the position (X, Y, and Z) in its parent's coordinate system. More...
 
virtual Vec3 getPosition3D () const
 Returns the position (X,Y,Z) in its parent's coordinate system. More...
 
virtual void setPositionZ (float positionZ)
 Sets the 'z' coordinate in the position. More...
 
virtual float getPositionZ () const
 Gets position Z coordinate of this node. More...
 
virtual void setSkewX (float skewX)
 Changes the X skew angle of the node in degrees. More...
 
virtual float getSkewX () const
 Returns the X skew angle of the node in degrees. More...
 
virtual void setSkewY (float skewY)
 Changes the Y skew angle of the node in degrees. More...
 
virtual float getSkewY () const
 Returns the Y skew angle of the node in degrees. More...
 
virtual void setAnchorPoint (const Vec2 &anchorPoint)
 Sets the anchor point in percent. More...
 
virtual const Vec2getAnchorPoint () const
 Returns the anchor point in percent. More...
 
virtual const Vec2getAnchorPointInPoints () const
 Returns the anchorPoint in absolute pixels. More...
 
virtual const Size & getContentSize () const
 Returns the untransformed size of the node. More...
 
virtual void setVisible (bool visible)
 Sets whether the node is visible. More...
 
virtual bool isVisible () const
 Determines if the node is visible. More...
 
virtual void setRotation (float rotation)
 Sets the rotation (angle) of the node in degrees. More...
 
virtual float getRotation () const
 Returns the rotation of the node in degrees. More...
 
virtual void setRotation3D (const Vec3 &rotation)
 Sets the rotation (X,Y,Z) in degrees. More...
 
virtual Vec3 getRotation3D () const
 Returns the rotation (X,Y,Z) in degrees. More...
 
virtual void setRotationQuat (const Quaternion &quat)
 Set rotation by quaternion. More...
 
virtual Quaternion getRotationQuat () const
 Return the rotation by quaternion, Note that when _rotationZ_X == _rotationZ_Y, the returned quaternion equals to RotationZ_X * RotationY * RotationX, it equals to RotationY * RotationX otherwise. More...
 
virtual void setRotationSkewX (float rotationX)
 Sets the X rotation (angle) of the node in degrees which performs a horizontal rotational skew. More...
 
virtual float getRotationSkewX () const
 Gets the X rotation (angle) of the node in degrees which performs a horizontal rotation skew. More...
 
virtual void setRotationSkewY (float rotationY)
 Sets the Y rotation (angle) of the node in degrees which performs a vertical rotational skew. More...
 
virtual float getRotationSkewY () const
 Gets the Y rotation (angle) of the node in degrees which performs a vertical rotational skew. More...
 
virtual void setIgnoreAnchorPointForPosition (bool ignore)
 Sets whether the anchor point will be (0,0) when you position this node. More...
 
virtual bool isIgnoreAnchorPointForPosition () const
 Gets whether the anchor point will be (0,0) when you position this node. More...
 
virtual int getTag () const
 Returns a tag that is used to identify the node easily. More...
 
virtual void setTag (int tag)
 Changes the tag that is used to identify the node easily. More...
 
virtual const std::string & getName () const
 Returns a string that is used to identify the node. More...
 
virtual void setName (const std::string &name)
 Changes the name that is used to identify the node easily. More...
 
virtual void * getUserData ()
 Returns a custom user data pointer. More...
 
virtual const void * getUserData () const
 @lua NA
 
virtual void setUserData (void *userData)
 Sets a custom user data pointer. More...
 
virtual RefgetUserObject ()
 Returns a user assigned Object. More...
 
virtual const RefgetUserObject () const
 @lua NA
 
virtual void setUserObject (Ref *userObject)
 Returns a user assigned Object. More...
 
virtual void setActionManager (ActionManager *actionManager)
 Sets the ActionManager object that is used by all actions. More...
 
virtual ActionManagergetActionManager ()
 Gets the ActionManager object that is used by all actions. More...
 
virtual const ActionManagergetActionManager () const
 
virtual ActionrunAction (Action *action)
 Executes an action, and returns the action that is executed. More...
 
void stopAllActions ()
 Stops and removes all actions from the running action list .
 
void stopAction (Action *action)
 Stops and removes an action from the running action list. More...
 
void stopActionByTag (int tag)
 Removes an action from the running action list by its tag. More...
 
void stopAllActionsByTag (int tag)
 Removes all actions from the running action list by its tag. More...
 
void stopActionsByFlags (unsigned int flags)
 Removes all actions from the running action list by its flags. More...
 
ActiongetActionByTag (int tag)
 Gets an action from the running action list by its tag. More...
 
ssize_t getNumberOfRunningActions () const
 Returns the numbers of actions that are running plus the ones that are schedule to run (actions in actionsToAdd and actions arrays). More...
 
ssize_t getNumberOfRunningActionsByTag (int tag) const
 Returns the numbers of actions that are running plus the ones that are schedule to run (actions in actionsToAdd and actions arrays) with a specific tag. More...
 
virtual void setScheduler (Scheduler *scheduler)
 Sets a Scheduler object that is used to schedule all "updates" and timers. More...
 
virtual SchedulergetScheduler ()
 Gets a Scheduler object. More...
 
virtual const SchedulergetScheduler () const
 
bool isScheduled (SEL_SCHEDULE selector) const
 Checks whether a selector is scheduled. More...
 
bool isScheduled (const std::string &key) const
 Checks whether a lambda function is scheduled. More...
 
void scheduleUpdate ()
 Schedules the "update" method. More...
 
void scheduleUpdateWithPriority (int priority)
 Schedules the "update" method with a custom priority. More...
 
void unscheduleUpdate ()
 
void schedule (SEL_SCHEDULE selector, float interval, unsigned int repeat, float delay)
 Schedules a custom selector. More...
 
void schedule (SEL_SCHEDULE selector, float interval)
 Schedules a custom selector with an interval time in seconds. More...
 
void scheduleOnce (SEL_SCHEDULE selector, float delay)
 Schedules a selector that runs only once, with a delay of 0 or larger. More...
 
void scheduleOnce (const std::function< void(float)> &callback, float delay, const std::string &key)
 Schedules a lambda function that runs only once, with a delay of 0 or larger. More...
 
void schedule (SEL_SCHEDULE selector)
 Schedules a custom selector, the scheduled selector will be ticked every frame. More...
 
void schedule (const std::function< void(float)> &callback, const std::string &key)
 Schedules a lambda function. More...
 
void schedule (const std::function< void(float)> &callback, float interval, const std::string &key)
 Schedules a lambda function. More...
 
void schedule (const std::function< void(float)> &callback, float interval, unsigned int repeat, float delay, const std::string &key)
 Schedules a lambda function. More...
 
void unschedule (SEL_SCHEDULE selector)
 Unschedules a custom selector. More...
 
void unschedule (const std::string &key)
 Unschedules a lambda function. More...
 
void unscheduleAllCallbacks ()
 Unschedule all scheduled selectors and lambda functions: custom selectors, and the 'update' selector and lambda functions. More...
 
virtual void resume ()
 Resumes all scheduled selectors, actions and event listeners. More...
 
virtual void pause ()
 Pauses all scheduled selectors, actions and event listeners. More...
 
virtual void updateTransform ()
 Calls children's updateTransform() method recursively. More...
 
virtual const Mat4getNodeToParentTransform () const
 Returns the matrix that transform the node's (local) space coordinates into the parent's space coordinates. More...
 
virtual AffineTransform getNodeToParentAffineTransform () const
 
virtual Mat4 getNodeToParentTransform (Node *ancestor) const
 Returns the matrix that transform the node's (local) space coordinates into the parent's space coordinates. More...
 
virtual AffineTransform getNodeToParentAffineTransform (Node *ancestor) const
 Returns the affine transform matrix that transform the node's (local) space coordinates into the parent's space coordinates. More...
 
virtual void setNodeToParentTransform (const Mat4 &transform)
 Sets the transformation matrix manually. More...
 
virtual const Mat4getParentToNodeTransform () const
 Returns the matrix that transform parent's space coordinates to the node's (local) space coordinates. More...
 
virtual AffineTransform getParentToNodeAffineTransform () const
 
virtual Mat4 getNodeToWorldTransform () const
 Returns the world affine transform matrix. More...
 
virtual AffineTransform getNodeToWorldAffineTransform () const
 
virtual Mat4 getWorldToNodeTransform () const
 Returns the inverse world affine transform matrix. More...
 
virtual AffineTransform getWorldToNodeAffineTransform () const
 
Vec2 convertToNodeSpace (const Vec2 &worldPoint) const
 Converts a Vec2 to node (local) space coordinates. More...
 
Vec2 convertToWorldSpace (const Vec2 &nodePoint) const
 Converts a Vec2 to world space coordinates. More...
 
Vec2 convertToNodeSpaceAR (const Vec2 &worldPoint) const
 Converts a Vec2 to node (local) space coordinates. More...
 
Vec2 convertToWorldSpaceAR (const Vec2 &nodePoint) const
 Converts a local Vec2 to world space coordinates.The result is in Points. More...
 
Vec2 convertTouchToNodeSpace (Touch *touch) const
 convenience methods which take a Touch instead of Vec2. More...
 
Vec2 convertTouchToNodeSpaceAR (Touch *touch) const
 converts a Touch (world coordinates) into a local coordinate. More...
 
void setAdditionalTransform (const Mat4 *additionalTransform)
 Sets an additional transform matrix to the node. More...
 
void setAdditionalTransform (const Mat4 &additionalTransform)
 
void setAdditionalTransform (const AffineTransform &additionalTransform)
 
Component * getComponent (const std::string &name)
 Gets a component by its name. More...
 
virtual bool addComponent (Component *component)
 Adds a component. More...
 
virtual bool removeComponent (const std::string &name)
 Removes a component by its name. More...
 
virtual bool removeComponent (Component *component)
 Removes a component by its pointer. More...
 
virtual void removeAllComponents ()
 Removes all components.
 
template<typename T >
getChildByTag (int tag) const
 Gets a child from the container with its tag that can be cast to Type T. More...
 
template<typename T >
getChildByName (const std::string &name) const
 Gets a child from the container with its name that can be cast to Type T. More...
 
virtual void enumerateChildren (const std::string &name, std::function< bool(Node *node)> callback) const
 Search the children of the receiving node to perform processing for nodes which share a name. More...
 
virtual void setParent (Node *parent)
 Sets the parent node. More...
 
virtual NodegetParent ()
 Returns a pointer to the parent node. More...
 
virtual const NodegetParent () const
 
virtual void removeFromParent ()
 Removes this node itself from its parent node with a cleanup. More...
 
virtual void removeFromParentAndCleanup (bool cleanup)
 Removes this node itself from its parent node. More...
 
virtual void removeChildByTag (int tag, bool cleanup=true)
 Removes a child from the container by tag value. More...
 
virtual void removeChildByName (const std::string &name, bool cleanup=true)
 Removes a child from the container by tag value. More...
 
virtual void reorderChild (Node *child, int localZOrder)
 Reorders a child according to a new z value. More...
 
virtual void sortAllChildren ()
 Sorts the children array once before drawing, instead of every time when a child is added or reordered. More...
 
- Public Member Functions inherited from Ref
void retain ()
 Retains the ownership. More...
 
void release ()
 Releases the ownership immediately. More...
 
Refautorelease ()
 Releases the ownership sometime soon automatically. More...
 
unsigned int getReferenceCount () const
 Returns the Ref's current reference count. More...
 
virtual ~Ref ()
 Destructor. More...
 
- Public Member Functions inherited from LayoutParameterProtocol
virtual ~LayoutParameterProtocol ()
 Default destructor.
 

Static Public Member Functions

static PageViewcreate ()
 Create an empty PageView. More...
 
- Static Public Member Functions inherited from ListView
static ListViewcreate ()
 Create an empty ListView. More...
 
- Static Public Member Functions inherited from ScrollView
static ScrollViewcreate ()
 Create an empty ScrollView. More...
 
- Static Public Member Functions inherited from Layout
static Layoutcreate ()
 Create a empty layout.
 
- Static Public Member Functions inherited from Widget
static Widgetcreate ()
 Create and return a empty Widget instance pointer.
 
static WidgetgetCurrentFocusedWidget ()
 Return a current focused widget in your UI scene. More...
 
- Static Public Member Functions inherited from ProtectedNode
static ProtectedNodecreate ()
 Creates a ProtectedNode with no argument. More...
 
- Static Public Member Functions inherited from Node
static Nodecreate ()
 Allocates and initializes a node. More...
 
static int getAttachedNodeCount ()
 Gets count of nodes those are attached to scene graph.
 
template<typename _T >
static void sortNodes (cocos2d::Vector< _T * > &nodes)
 Sorts helper function. More...
 

Additional Inherited Members

- Public Attributes inherited from Layout
std::function< int(FocusDirection, Widget *)> onPassFocusToChild
 To specify a user-defined functor to decide which child widget of the layout should get focused. More...
 
- Public Attributes inherited from Widget
std::function< void(Widget *, Widget *)> onFocusChanged
 When a widget lose/get focus, this method will be called. More...
 
std::function< Widget *(FocusDirection)> onNextFocusedWidget
 use this function to manually specify the next focused widget regards to each direction
 
- Public Attributes inherited from Ref
unsigned int _ID
 object id, ScriptSupport need public _ID
 
int _luaID
 Lua reference id.
 
void * _scriptObject
 scriptObject, support for swift
 
bool _rooted
 When true, it means that the object was already rooted.
 
- Static Public Attributes inherited from Node
static const int INVALID_TAG = -1
 Default tag used for all the nodes.
 
- Protected Member Functions inherited from Widget
void propagateTouchEvent (TouchEventType event, Widget *sender, Touch *touch)
 Propagate touch events to its parents.
 
void onFocusChange (Widget *widgetLostFocus, Widget *widgetGetFocus)
 This method is called when a focus change event happens. More...
 
void dispatchFocusEvent (Widget *widgetLoseFocus, Widget *widgetGetFocus)
 Dispatch a EventFocus through a EventDispatcher. More...
 

Detailed Description

Layout manager that allows the user to flip left & right and up & down through pages of data.

Member Function Documentation

◆ create()

static PageView* create ( )
static

Create an empty PageView.

Returns
A PageView instance.

◆ setDirection()

virtual void setDirection ( Direction  direction)
overridevirtual

Changes direction Direction Direction::VERTICAL means vertical scroll, Direction::HORIZONTAL means horizontal scroll.

Parameters
directionSet the page view's scroll direction.

Reimplemented from ListView.

◆ addPage()

void addPage ( Widget page)

Insert a page into the end of PageView.

Parameters
pagePage to be inserted.

◆ insertPage()

void insertPage ( Widget page,
int  idx 
)

Insert a page into PageView at a given index.

Parameters
pagePage to be inserted.
idxA given index.

◆ removePage()

void removePage ( Widget page)

Remove a page of PageView.

Parameters
pagePage to be removed.

◆ removePageAtIndex()

void removePageAtIndex ( ssize_t  index)

Remove a page at a given index of PageView.

Parameters
indexA given index.

◆ scrollToPage() [1/2]

void scrollToPage ( ssize_t  idx)

Scroll to a page with a given index.

Parameters
idxA given index in the PageView. Index start from 0 to pageCount -1.

◆ scrollToPage() [2/2]

void scrollToPage ( ssize_t  idx,
float  time 
)

Scroll to a page with a given index and with a given scroll time.

Parameters
idxA given index in the PageView. Index start from 0 to pageCount -1.
timeScroll time must be >= 0. Otherwise last set scroll time will be used.

◆ scrollToItem() [1/2]

void scrollToItem ( ssize_t  itemIndex)

Scroll to a page with a given index.

Parameters
itemIndexA given index in the PageView. Index start from 0 to pageCount -1.

◆ scrollToItem() [2/2]

void scrollToItem ( ssize_t  idx,
float  time 
)

Scroll to a item with a given index and with a given scroll time.

Parameters
idxA given index in the PageView. Index start from 0 to pageCount -1.
timeScroll time must be >= 0. Otherwise last set scrolltime will be used.

◆ getCurrentPageIndex()

ssize_t getCurrentPageIndex ( )

Gets current displayed page index.

Returns
current page index.

◆ setCurrentPageIndex()

void setCurrentPageIndex ( ssize_t  index)

Jump to a page with a given index without scrolling.

This is the different between scrollToPage.

Parameters
indexA given index in PageView. Index start from 0 to pageCount -1.

◆ addEventListener() [1/2]

void addEventListener ( const ccPageViewCallback callback)
virtual

Add a page turn callback to PageView, then when one page is turning, the callback will be called.

Parameters
callbackA page turning callback.

Reimplemented from ListView.

◆ setIndicatorEnabled()

void setIndicatorEnabled ( bool  enabled)

Toggle page indicator enabled.

Parameters
enabledTrue if enable page indicator, false otherwise.

◆ getIndicatorEnabled()

bool getIndicatorEnabled ( ) const
inline

Query page indicator state.

Returns
True if page indicator is enabled, false otherwise.

◆ setIndicatorPositionAsAnchorPoint()

void setIndicatorPositionAsAnchorPoint ( const Vec2 positionAsAnchorPoint)

Set the page indicator's position using anchor point.

Parameters
positionAsAnchorPointThe position as anchor point.

◆ getIndicatorPositionAsAnchorPoint()

const Vec2& getIndicatorPositionAsAnchorPoint ( ) const

Get the page indicator's position as anchor point.

Returns
positionAsAnchorPoint

◆ setIndicatorPosition()

void setIndicatorPosition ( const Vec2 position)

Set the page indicator's position in page view.

Parameters
positionThe position in page view

◆ getIndicatorPosition()

const Vec2& getIndicatorPosition ( ) const

Get the page indicator's position.

Returns
positionAsAnchorPoint

◆ setIndicatorSpaceBetweenIndexNodes()

void setIndicatorSpaceBetweenIndexNodes ( float  spaceBetweenIndexNodes)

Set space between page indicator's index nodes.

Parameters
spaceBetweenIndexNodesSpace between nodes in pixel.

◆ getIndicatorSpaceBetweenIndexNodes()

float getIndicatorSpaceBetweenIndexNodes ( ) const

Get the space between page indicator's index nodes.

Returns
spaceBetweenIndexNodes

◆ setIndicatorSelectedIndexColor()

void setIndicatorSelectedIndexColor ( const Color3B color)

Set color of page indicator's selected index.

Parameters
colorNew color for selected (current) index.

◆ getIndicatorSelectedIndexColor()

const Color3B& getIndicatorSelectedIndexColor ( ) const

Get the color of page indicator's selected index.

Returns
color

◆ setIndicatorIndexNodesColor()

void setIndicatorIndexNodesColor ( const Color3B color)

Set color of page indicator's index nodes.

Parameters
colorNew indicator node color.

◆ getIndicatorIndexNodesColor()

const Color3B& getIndicatorIndexNodesColor ( ) const

Get the color of page indicator's index nodes.

Returns
color

◆ setIndicatorSelectedIndexOpacity()

void setIndicatorSelectedIndexOpacity ( uint8_t  opacity)

Set opacity of page indicator's selected index.

Parameters
colorNew opacity for selected (current) index.

◆ getIndicatorSelectedIndexOpacity()

uint8_t getIndicatorSelectedIndexOpacity ( ) const

Get the opacity of page indicator's selected index.

Returns
opacity

◆ setIndicatorIndexNodesOpacity()

void setIndicatorIndexNodesOpacity ( uint8_t  opacity)

Set opacity of page indicator's index nodes.

Parameters
opacityNew indicator node opacity.

◆ getIndicatorIndexNodesOpacity()

uint8_t getIndicatorIndexNodesOpacity ( ) const

Get the opacity of page indicator's index nodes.

Returns
opacity

◆ setIndicatorIndexNodesScale()

void setIndicatorIndexNodesScale ( float  indexNodesScale)

Set scale of page indicator's index nodes.

Parameters
indexNodesScaleScale of index nodes.

◆ setIndicatorIndexNodesTexture()

void setIndicatorIndexNodesTexture ( const std::string &  texName,
Widget::TextureResType  texType = Widget::TextureResType::LOCAL 
)

sets texture for index nodes.

Parameters
fileNameFile name of texture.
resType
See also
TextureResType .

◆ getIndicatorIndexNodesScale()

float getIndicatorIndexNodesScale ( ) const

Get scale of page indicator's index nodes.

Returns
indexNodesScale

◆ addEventListener() [2/2]

virtual void addEventListener

Add callback function which will be called when scrollview event triggered.

Parameters
callbackA callback function with type of ccScrollViewCallback.

The documentation for this class was generated from the following file: