-------------------------------- -- @module ListView -- @extend ScrollView -- @parent_module ccui -------------------------------- -- Set the gravity of ListView.
-- see `ListViewGravity` -- @function [parent=#ListView] setGravity -- @param self -- @param #int gravity -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- Removes the last item of ListView. -- @function [parent=#ListView] removeLastItem -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- brief Query the center item
-- return An item instance. -- @function [parent=#ListView] getCenterItemInCurrentView -- @param self -- @return Widget#Widget ret (return value: ccui.Widget) -------------------------------- -- brief Query current selected widget's index.
-- return An index of a selected item. -- @function [parent=#ListView] getCurSelectedIndex -- @param self -- @return int#int ret (return value: int) -------------------------------- -- Get the time in seconds to scroll between items.
-- return The time in seconds to scroll between items
-- see setScrollDuration(float) -- @function [parent=#ListView] getScrollDuration -- @param self -- @return float#float ret (return value: float) -------------------------------- -- brief Query margin between each item in ListView.
-- return A margin in float. -- @function [parent=#ListView] getItemsMargin -- @param self -- @return float#float ret (return value: float) -------------------------------- -- brief Jump to specific item
-- param itemIndex Specifies the item's index
-- param positionRatioInView Specifies the position with ratio in list view's content size.
-- param itemAnchorPoint Specifies an anchor point of each item for position to calculate distance. -- @function [parent=#ListView] jumpToItem -- @param self -- @param #int itemIndex -- @param #vec2_table positionRatioInView -- @param #vec2_table itemAnchorPoint -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- Set magnetic type of ListView.
-- see `MagneticType` -- @function [parent=#ListView] setMagneticType -- @param self -- @param #int magneticType -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- Return the index of specified widget.
-- param item A widget pointer.
-- return The index of a given widget in ListView. -- @function [parent=#ListView] getIndex -- @param self -- @param #ccui.Widget item -- @return int#int ret (return value: int) -------------------------------- -- Insert a custom item into the end of ListView.
-- param item An item in `Widget*`. -- @function [parent=#ListView] pushBackCustomItem -- @param self -- @param #ccui.Widget item -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- brief Set current selected widget's index and call TouchEventType::ENDED event.
-- param itemIndex A index of a selected item. -- @function [parent=#ListView] setCurSelectedIndex -- @param self -- @param #int itemIndex -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- Insert a default item(create by cloning model) into listview at a give index.
-- param index An index in ssize_t. -- @function [parent=#ListView] insertDefaultItem -- @param self -- @param #int index -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- Set magnetic allowed out of boundary. -- @function [parent=#ListView] setMagneticAllowedOutOfBoundary -- @param self -- @param #bool magneticAllowedOutOfBoundary -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- Add an event click callback to ListView, then one item of Listview is clicked, the callback will be called.
-- param callback A callback function with type of `ccListViewCallback`. -- @function [parent=#ListView] addEventListener -- @param self -- @param #function callback -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] doLayout -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- brief Query the topmost item in horizontal list
-- return An item instance. -- @function [parent=#ListView] getTopmostItemInCurrentView -- @param self -- @return Widget#Widget ret (return value: ccui.Widget) -------------------------------- -- brief Remove all items in current ListView. -- @function [parent=#ListView] removeAllItems -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- brief Query the bottommost item in horizontal list
-- return An item instance. -- @function [parent=#ListView] getBottommostItemInCurrentView -- @param self -- @return Widget#Widget ret (return value: ccui.Widget) -------------------------------- -- Return all items in a ListView.
-- returns A vector of widget pointers. -- @function [parent=#ListView] getItems -- @param self -- @return array_table#array_table ret (return value: array_table) -------------------------------- -- brief Query the leftmost item in horizontal list
-- return An item instance. -- @function [parent=#ListView] getLeftmostItemInCurrentView -- @param self -- @return Widget#Widget ret (return value: ccui.Widget) -------------------------------- -- Set the margin between each item in ListView.
-- param margin A margin in float. -- @function [parent=#ListView] setItemsMargin -- @param self -- @param #float margin -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- Get magnetic type of ListView. -- @function [parent=#ListView] getMagneticType -- @param self -- @return int#int ret (return value: int) -------------------------------- -- Return an item at a given index.
-- param index A given index in ssize_t.
-- return A widget instance. -- @function [parent=#ListView] getItem -- @param self -- @param #int index -- @return Widget#Widget ret (return value: ccui.Widget) -------------------------------- -- Remove an item at given index.
-- param index A given index in ssize_t. -- @function [parent=#ListView] removeItem -- @param self -- @param #int index -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- @overload self, int, vec2_table, vec2_table, float -- @overload self, int, vec2_table, vec2_table -- @function [parent=#ListView] scrollToItem -- @param self -- @param #int itemIndex -- @param #vec2_table positionRatioInView -- @param #vec2_table itemAnchorPoint -- @param #float timeInSec -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- Insert a default item(create by a cloned model) at the end of the listview. -- @function [parent=#ListView] pushBackDefaultItem -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- Query whether the magnetic out of boundary is allowed. -- @function [parent=#ListView] getMagneticAllowedOutOfBoundary -- @param self -- @return bool#bool ret (return value: bool) -------------------------------- -- brief Query the closest item to a specific position in inner container.
-- param targetPosition Specifies the target position in inner container's coordinates.
-- param itemAnchorPoint Specifies an anchor point of each item for position to calculate distance.
-- return An item instance if list view is not empty. Otherwise, returns null. -- @function [parent=#ListView] getClosestItemToPosition -- @param self -- @param #vec2_table targetPosition -- @param #vec2_table itemAnchorPoint -- @return Widget#Widget ret (return value: ccui.Widget) -------------------------------- -- brief Query the rightmost item in horizontal list
-- return An item instance. -- @function [parent=#ListView] getRightmostItemInCurrentView -- @param self -- @return Widget#Widget ret (return value: ccui.Widget) -------------------------------- -- Set the time in seconds to scroll between items.
-- Subsequent calls of function 'scrollToItem', will take 'time' seconds for scrolling.
-- param time The seconds needed to scroll between two items. 'time' must be >= 0
-- see scrollToItem(ssize_t, const Vec2&, const Vec2&) -- @function [parent=#ListView] setScrollDuration -- @param self -- @param #float time -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- brief Query the closest item to a specific position in current view.
-- For instance, to find the item in the center of view, call 'getClosestItemToPositionInCurrentView(Vec2::ANCHOR_MIDDLE, Vec2::ANCHOR_MIDDLE)'.
-- param positionRatioInView Specifies the target position with ratio in list view's content size.
-- param itemAnchorPoint Specifies an anchor point of each item for position to calculate distance.
-- return An item instance if list view is not empty. Otherwise, returns null. -- @function [parent=#ListView] getClosestItemToPositionInCurrentView -- @param self -- @param #vec2_table positionRatioInView -- @param #vec2_table itemAnchorPoint -- @return Widget#Widget ret (return value: ccui.Widget) -------------------------------- -- Set an item model for listview.
-- When calling `pushBackDefaultItem`, the model will be used as a blueprint and new model copy will be inserted into ListView.
-- param model Model in `Widget*`. -- @function [parent=#ListView] setItemModel -- @param self -- @param #ccui.Widget model -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- brief Insert a custom widget into ListView at a given index.
-- param item A widget pointer to be inserted.
-- param index A given index in ssize_t. -- @function [parent=#ListView] insertCustomItem -- @param self -- @param #ccui.Widget item -- @param #int index -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- Create an empty ListView.
-- return A ListView instance. -- @function [parent=#ListView] create -- @param self -- @return ListView#ListView ret (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] createInstance -- @param self -- @return Ref#Ref ret (return value: cc.Ref) -------------------------------- -- @overload self, cc.Node, int -- @overload self, cc.Node -- @overload self, cc.Node, int, int -- @overload self, cc.Node, int, string -- @function [parent=#ListView] addChild -- @param self -- @param #cc.Node child -- @param #int zOrder -- @param #string name -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- Override functions -- @function [parent=#ListView] jumpToBottom -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] init -- @param self -- @return bool#bool ret (return value: bool) -------------------------------- -- Changes scroll direction of scrollview.
-- Direction Direction::VERTICAL means vertical scroll, Direction::HORIZONTAL means horizontal scroll.
-- param dir Set the list view's scroll direction. -- @function [parent=#ListView] setDirection -- @param self -- @param #int dir -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] jumpToTopRight -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] jumpToLeft -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] removeAllChildrenWithCleanup -- @param self -- @param #bool cleanup -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] requestDoLayout -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] removeAllChildren -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] jumpToTopLeft -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] removeChild -- @param self -- @param #cc.Node child -- @param #bool cleanup -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] jumpToBottomRight -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] jumpToTop -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] jumpToBottomLeft -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] jumpToPercentBothDirection -- @param self -- @param #vec2_table percent -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] jumpToPercentHorizontal -- @param self -- @param #float percent -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] jumpToRight -- @param self -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- -- @function [parent=#ListView] getDescription -- @param self -- @return string#string ret (return value: string) -------------------------------- -- -- @function [parent=#ListView] jumpToPercentVertical -- @param self -- @param #float percent -- @return ListView#ListView self (return value: ccui.ListView) -------------------------------- -- Default constructor
-- js ctor
-- lua new -- @function [parent=#ListView] ListView -- @param self -- @return ListView#ListView self (return value: ccui.ListView) return nil