Unity UGUI图片循环列表插件

ops/2024/12/20 2:49:57/

效果展示:

展示链接:https://www.bilibili.com/video/BV1kSBGYrEQW/?spm_id_from=333.1387.homepage.video_card.click&vd_source=8ce226deb3104a71115edff00f07c13f

概述:

LoopListView2 是一个与 UGUI ScrollRect 相同的游戏对象的组件。它可以帮助 UGUI ScrollRect 以高效率和节省内存的方式支持任意数量的项目。

对于具有10,000个项目的ScrollRect, LoopListView2并不真正创建10,000个项目,而是根据视窗的大小创建几个项目。

例如,当ScrollRect向上移动时,LoopListView2组件将进行检查最上面的项目的位置,一旦最上面的项目离开视口,则LoopListView2组件将回收最上面的项,同时检查最下方的项目位置,一旦最下方的项目接近视口底部LoopListView2组件将调用onGetItemByIndex处理程序来创建一个新项和然后将新创建的项放置在最下面的项下,因此新创建的项变为新的最下面的项目。

每个项目可以使用不同的预制件,可以有不同的高度/宽度。

在该文件夹中有几个示例可以帮助您了解LoopListView2组件与路径:Assets -> SuperScrollView -> Demo ->场景。菜单场景是入口。

下图是toptobutton安排的滚动矩形的样子:

 在上图中,scrollrect有10000个项目,但实际上,只有7个项目真正创建。

Inspector设置:

在Inspector中,为了确保LoopListView2组件工作良好,有几个需要设置的参数:

ItemPrefabList:这是要克隆的现有项。

每个项目可以使用不同的预制件,每个预制件可以有不同的默认填充滚动块中每个项目之间的间距)。而且,每个预制件都可以有不同的默认x本地位置(用于垂直scrollrect)或默认y本地位置(用于水平scrollrect),这里,称为(X/Y) pooffset。每个预制件都有一个回收InitCreateCount是开始时在池中创建的计数。

事实上,在运行时,每个项目可以有不同的填充和(X/Y) posofset,你可以改变一个item的padding和(X/Y)PosOffset在你的onGetItemByIndex回调中。你可以得到/设置它们LoopListViewItem2。填充和LoopListViewItem2。StartPosOffset。

重要提示:所有itemPrefab的localScale必须为(1,1,1)。

SupportScrollbar:如果选中,LoopListView2组件将支持滚动条。

ItemSnapEnable:

如果选中,LoopListView2组件将尝试将项捕捉到中的配置位置ViewPort。

ItemSnapPivot是项目的快速枢轴点的位置,定义为矩形本身大小的一小部分。0,0对应左下角而1,1对应右上角。

ViewPortSnapPivot是ScrollRect ViewPort的snap枢轴点的位置,定义为矩形本身大小的分数。0,0对应左下角,而1,1对应右上角。

ArrangeType:滚动方向,有四种类型:

(1) TopToBottom:这种类型用于垂直滚动,item0,item1,…itemN是在scrollrect视口中从上到下依次定位,就像下面:

(2) BottomToTop:这种类型用于垂直滚动条,item0,item1,…itemN是在scrollrect视口中从下到上依次定位,就像下面:

(3) LeftToRight:这种类型用于水平滚动,item0,item1,…itemN是在scrollrect视口中从左到右依次定位。

(4) righttolleft:该类型用于水平滚动,item0,item1,…itemN是在scrollrect视口中从右到左依次定位。

重要的公开方法:

public void InitListView(int itemTotalCount,
System. Func<LoopListView2, int, LoopListViewItem2> onGetItemByIndex,
LoopListViewInitParam initParam = nu1l)

InitListView方法用于初始化LoopListView2组件。有3个参数:

itemTotalCount:滚动视图中的项目总数。如果该参数设置为-1,则表示有无限项,不支持滚动条,ItemIndex可以从-MaxInt到+MaxInt。如果设置sssa value >=0,则ItemIndex只能来自0到itemTotalCount -1。

onGetItemByIndex:当一个项目进入scrollrect视图时,这个Action将被调用使用项目索引作为参数,以允许您创建项目并更新其内容。LoopListViewItem2是onGetItemByIndex的返回值,每个创建的项目都有一个自动附加的LoopListViewItem2组件:

LoopListViewItem2组件是一个非常简单的例子:

mItemIndex属性表示列表中项目的索引,如上所述,如果itemTotalCount设置为-1,则mItemIndex可以从-MaxInt到+MaxInt。如果将itemTotalCount设置为>=0,则mItemIndex只能在0到itemTotalCount之间取值1。

mItemId属性表示该项的id。此属性在创建项时设置从池中获取,并且在项目回收回池之前将不再更改。下面的代码是onGetItemByIndex的示例:

LoopListViewItem2 OnGetItemByIndex(LoopListView2 listView, int index)
{
if (index < 0 || index >= DataSourceMgr.Get.TotalItemCount)
{
return null;
}
//get the data to showing 
ItemData itemData = DataSourceMgr.Get.GetItemDataByIndex(index);
if(itemData == null)
{
return null;
}
/*get a new item. Every item can use a different prefab, the parameter of the 
NewListViewItem is 
the prefab’name. 
And all the prefabs should be listed in ItemPrefabList in LoopListView2 Inspector 
Setting */ 
LoopListViewItem2 item = listView.NewListViewItem("ItemPrefab1");
ListItem2 itemScript = item.GetComponent<ListItem2>();
// IsInitHandlerCalled is false means this item is new created but not fetched from pool. 
if (item.IsInitHandlerCalled == false)
{
item.IsInitHandlerCalled = true;
itemScript.Init();// here to init the item, such as add button click event listener.
}
//update the item’s content for showing, such as image,text. 
itemScript.SetItemData(itemData,index);
return item;
}

此方法用于获取新项目,新项目是命名的预制件的克隆itemPrefabName。此方法通常在onGetItemByIndex中使用。

 此方法可用于在运行时设置滚动视图的项目总数。如果此参数设置为-1,则表示有无限个项目,并且不支持滚动条ItemIndex取值范围从-MaxInt到+MaxInt。如果将该参数设置为>=0,则ItemIndex只能在0到itemTotalCount -1之间取值。

如果resetPos设置为false,则在此方法完成后滚动块的内容位置不会改变。

通过itemIndex获取可见项。如果项不可见,则此方法返回null。

所有可见项存储在List<LoopListViewItem2>中,命名为mItemList;这个方法是通过可见项列表中的索引获取可见项。参数索引为0 ~mItemList.Count。

获取所有可见项目的总数。

通过itemIndex更新项。如果itemIndex-th项不可见,则使用此方法什么都没有。否则,该方法将首先调用onGetItemByIndex(itemIndex)来获取一个更新项目,然后重新定位所有可见项目的位置。

此方法将更新所有可见项。

这个方法将滚动内容的位置移动到itemIndex-th item +的位置在当前版本中,itemIndex是从0到MaxInt, offset是从0到scrollrect视窗大小。

对于垂直滚动块,当一个可见项的高度在运行时发生变化时,这个方法应该调用LoopListView2组件来重新定位所有可见项的位置。

对于水平滚动块,当可见项的宽度在运行时发生变化时,则使用此方法来让LoopListView2组件重新定位所有可见项的位置。

快速移动将立即完成

使用viewport快照点获取最近的项目索引。

设置snap目标项索引。这个方法在PageViewDemo中使用。

清除当前的捕捉目标,然后LoopScrollView2将自动捕捉到CurSnapNearestItemIndex。


http://www.ppmy.cn/ops/143363.html

相关文章

mysql、postgresql、oceanbase调优

一、mysql 1、my.cnf [mysqld_safe] log-error=/data/mysql/log/mysql.log pid-file=/data/mysql/run/mysqld.pid[client] socket=/data/mysql/run/mysql.sock default-character-set=utf8[mysqld] basedir=/usr/local/mysql tmpdir=/data/mysql/tmp datadir=/data/mysql/dat…

【iOS】OC高级编程 iOS多线程与内存管理阅读笔记——自动引用计数(四)

目录 ARC规则 规则 对象型变量不能作为C语言结构体的成员 显式转换id和void* 属性 数组 ARC规则 规则 在ARC有效的情况下编译源代码必须遵守一定的规则&#xff1a; 主要解释一下最后两条 对象型变量不能作为C语言结构体的成员 要把对象型变量加入到结构体成员中时&a…

关于opengauss

adm开头的那些都是系统视图&#xff0c;不是系统表 ADM开头的系统视图&#xff0c;都在华为云: 路径&#xff08;GaussDB官方文档-->开发指南-->开发指南&#xff08;分布式_V2.0-8.x&#xff09;-->系统表和系统视图-->系统视图&#xff09; https://support.huaw…

使用Python实现两组数据纵向排序

一、引言 在数据分析和处理过程中&#xff0c;排序是一项非常常见的操作。排序操作能够让我们更清晰地理解数据&#xff0c;从而进行进一步的分析和处理。在Python中&#xff0c;排序操作通常可以通过内置函数或第三方库来实现。本文将详细讲解如何使用Python实现两组数据的纵…

数据库-mysql

数据库的概念 数据库是按照数据结构来组织、存储和管理数据的系统&#xff0c;它允许用户高效地存储、检索、更新和管理数据 database&#xff1a;用来组织&#xff0c;存储&#xff0c;管理数据的仓库 数据库的管理系统&#xff1a;DBMS&#xff0c;实现对数据的有效储值&…

[C++]纯虚函数与虚函数

1. 什么是虚函数&#xff1f; 1.1 定义 虚函数是用 virtual 关键字声明的成员函数&#xff0c;允许子类覆盖它&#xff0c;并支持 运行时多态。 1.2 特点 1.动态绑定&#xff08;运行时决定调用函数&#xff09;&#xff1a; 虚函数在运行时&#xff0c;根据对象的实际类型…

华为ensp--BGP自动路由聚合

学习新思想&#xff0c;争做新青年。今天学习BGP自动路由聚合 实验目的 理解BGP自动路由聚合的概念 掌握BGP自动路由聚合的配置 实验拓扑 实验要求 三台路由器都使用直连的物理接口IP地址来建立EBGP邻居关系&#xff0c;R2和R3的Loopback1接口用来模拟各自ISP中的一个网段。…

opencv——(图像梯度处理、图像边缘化检测、图像轮廓查找和绘制、透视变换、举例轮廓的外接边界框)

一、图像梯度处理 1 图像边缘提取 cv2.filter2D(src, ddepth, kernel[, dst[, anchor[, delta[, borderType]]]]) 功能&#xff1a;用于对图像进行卷积操作。卷积是图像处理中的一个基本操作&#xff0c;它通过一个称为卷积核&#xff08;或滤波器&#xff09;的小矩阵在图像上…