PageSliderProvider

java.lang.Object

|---ohos.agp.components.PageSliderProvider

public abstract class PageSliderProvider
extends Object

提供页面适配器来管理页面组件。

该类提供页面项管理功能，例如计算可用组件的数量，并在指定位置创建组件。 您需要继承并实现 PageSliderProvider 以在不同的页面上显示多个组件。

Since:

3

字段摘要

修饰符和类型	字段	描述
static int	POSITION_INVALID	表示容器中的页面无效。
static int	POSITION_REMAIN	表示页面在容器中的位置保持不变。

构造函数摘要

构造函数	描述
PageSliderProvider()

方法总结

修饰符和类型	方法	描述
void	addDataSubscriber(DataSetSubscriber subscriber)	为当前的 Page Slider Provider 添加订阅者。
abstract Object	createPageInContainer(ComponentContainer container, int position)	在指定位置创建页面。
abstract void	destroyPageFromContainer(ComponentContainer container, int position, Object object)	销毁容器中的指定页面。
abstract int	getCount()	获取当前适配器中可用组件的数量。
int	getPageIndex(Object object)	获取容器中对象的索引。
String	getPageTitle(int position)	获取页面在指定位置的标题。
abstract boolean	isPageMatchToObject(Component page, Object object)	检查组件是否与从 createPageInContainer(ohos.agp.components.ComponentContainer,int) 返回的特定对象相关联。
void	notifyDataChanged()	通知页面滑块提供程序数据集更改。
void	onUpdateFinished(ComponentContainer componentContainer)	通知容器页面更新已完成。
void	removeDataSubscriber(DataSetSubscriber subscriber)	从当前 PageSliderProvider 注销订阅者。
void	startUpdate(ComponentContainer container)	收到通知，指示显示的页面上即将发生更新。

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

POSITION_INVALID

public static final int POSITION_INVALID

表示容器中的页面无效。

POSITION_REMAIN

public static final int POSITION_REMAIN

表示页面在容器中的位置保持不变。

构造函数详细信息

PageSliderProvider

public PageSliderProvider()

方法详情

getCount

public abstract int getCount()

获取当前适配器中可用组件的数量。

返回:

返回可用组件的数量。

createPageInContainer

public abstract Object createPageInContainer(ComponentContainer container, int position)

在指定位置创建页面。

页面被添加到容器中的指定位置。

参数：

参数名称	参数描述
container	指示要显示 PageSliderProvider 的容器。
position	表示容器中的指定位置。

返回:

返回显示的页面。

destroyPageFromContainer

public abstract void destroyPageFromContainer(ComponentContainer container, int position, Object object)

销毁容器中的指定页面。

参数：

参数名称	参数描述
container	指示页面适配器所属的容器。
position	表示容器中的指定位置。
object	指示要销毁的页面。

isPageMatchToObject

public abstract boolean isPageMatchToObject(Component page, Object object)

检查组件是否与从 createPageInContainer(ohos.agp.components.ComponentContainer,int) 返回的特定对象相关联。

参数：

参数名称	参数描述
page	表示要检查的组件。
object	指示与要检查的组件关联的对象。

返回:

组件是否与对象关联。

startUpdate

public void startUpdate(ComponentContainer container)

收到通知，指示显示的页面上即将发生更新。

参数：

参数名称	参数描述
container	指示页面适配器所属的ComponentContainer。

onUpdateFinished

public void onUpdateFinished(ComponentContainer componentContainer)

通知容器页面更新已完成。

调用此方法时，必须确保所有页面都已按要求添加到容器中或从容器中移除。

参数：

参数名称	参数描述
componentContainer	指示页面适配器所属的容器。

Since:

4

getPageIndex

public int getPageIndex(Object object)

获取容器中对象的索引。

参数：

参数名称	参数描述
object	表示用于生成组件的对象。

返回:

返回容器中对象的索引； 如果对象索引没有改变，则返回 POSITION_REMAIN； 如果容器中不存在对象，则返回 POSITION_INVALID。

Since:

4

notifyDataChanged

public void notifyDataChanged()

通知页面滑块提供程序数据集更改。

当要显示的数据发生变化时调用该方法。

Since:

4

addDataSubscriber

public final void addDataSubscriber(DataSetSubscriber subscriber)

为当前的 PageSliderProvider 添加订阅者。

订阅者接收与数据更改相关的回调。

参数：

参数名称	参数描述
subscriber	表示订阅者。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果参数值为 null，则引发此异常。
IllegalStateException	如果已添加对象，则抛出此异常

Since:

4

removeDataSubscriber

public final void removeDataSubscriber(DataSetSubscriber subscriber)

从当前 PageSliderProvider 注销订阅者。

参数：

参数名称	参数描述
subscriber	表示要移除的订阅者。

Throws:

Throw名称	Throw描述
IllegalArgumentException	如果参数值为 null，则引发此异常。
IllegalStateException	如果对象已被移除，则抛出此异常

Since:

4

getPageTitle

public String getPageTitle(int position)

获取页面在指定位置的标题。

该方法可用于 PageSliderProvider 对象获取指定页面的标题。

参数：

参数名称	参数描述
position	指示页面在 PageSliderProvider 中的位置。

返回:

返回页面标题。