鸿蒙OS PageSliderProvider

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 中的位置。

返回:

返回页面标题。

版权声明:本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权
文章名称:《鸿蒙OS PageSliderProvider》
文章链接:https://zhuji.vsping.com/314368.html
本站资源仅供个人学习交流,请于下载后24小时内删除,不允许用于商业用途,否则法律问题自行承担。