列表容器定位

在996引擎中，列表容器（ListView）的定位可以通过多种方式实现，主要涉及滚动到特定位置或特定子项。根据浮生梦老师前端课程内容，以下是常用的定位方法： ## 1. 滚动到指定百分比位置 ```lua -- 垂直方向滚动到50%位置，用时1秒，不衰减速度 GUI:ListView_scrollToPercentVertical(listView, 50, 1, false) -- 水平方向滚动到30%位置，用时0.5秒，衰减速度 GUI:ListView_scrollToPercentHorizontal(listView, 30, 0.5, true) ``` **参数说明：** - `listView`：列表容器对象 - `percent`：百分比（0-100） - `time`：滚动时间（秒） - `bool`：是否衰减滚动速度 ## 2. 滚动到顶部或底部 ```lua -- 滚动到顶部，用时0.8秒，不衰减速度 GUI:ListView_scrollToTop(listView, 0.8, false) -- 滚动到底部，用时1秒，衰减速度 GUI:ListView_scrollToBottom(listView, 1, true) ``` ## 3. 跳转到指定序列号子项 ```lua -- 跳转到第5个子项位置 GUI:ListView_jumpToItem(listView, 5) ``` ## 4. 通过子项对象定位 ```lua -- 先获取子项对象 local item = GUI:ListView_getItemByIndex(listView, 3) -- 然后跳转到该子项 GUI:ListView_jumpToItem(listView, 3) ``` ## 5. 获取当前位置信息 ```lua -- 获取内部容器位置 local pos = GUI:ListView_getInnerContainerPosition(listView) SL:print("内部容器位置：x=" .. pos.x .. ", y=" .. pos.y) -- 获取内部容器大小 local size = GUI:ListView_getInnerContainerSize(listView) SL:print("内部容器大小：width=" .. size.width .. ", height=" .. size.height) ``` ## 6. 获取当前可见范围子项 ```lua -- 获取最顶部可见子项 local topItem = GUI:ListView_getTopmostItemInCurrentView(listView) -- 获取最底部可见子项 local bottomItem = GUI:ListView_getBottommostItemInCurrentView(listView) ``` ## 完整示例 ```lua -- 创建列表容器 local listView = GUI:ListView_Create(parent, "list_test", 100, 100, 300, 400) -- 添加一些子项 for i = 1, 10 do local item = GUI:Widget_Create(listView, "item_" .. i, 0, 0, 200, 50) GUI:ListView_pushBackCustomItem(listView, item) end -- 3秒后滚动到70%位置 SL:ScheduleOnce(function() GUI:ListView_scrollToPercentVertical(listView, 70, 1, false) end, 3) ``` **注意：** - 百分比定位适用于需要精确控制滚动位置的场景 - 跳转到子项适用于需要定位到特定数据项的场景 - 滚动到顶部/底部适用于快速导航的场景 - 所有定位操作都可以设置动画时间和速度衰减效果 这些定位方法可以帮助你实现列表容器的精确控制，比如聊天记录定位、排行榜滚动、物品列表导航等功能。