鴻蒙OS PageSliderProvider

2022-09-28 10:04 更新

PageSliderProvider

java.lang.Object

|---ohos.agp.components.PageSliderProvider

public abstract class PageSliderProvider
extends Object

提供頁面適配器來管理頁面組件。

該類提供頁面項(xiàng)管理功能,例如計(jì)算可用組件的數(shù)量,并在指定位置創(chuàng)建組件。 您需要繼承并實(shí)現(xiàn) PageSliderProvider 以在不同的頁面上顯示多個(gè)組件。

Since:

3

字段摘要

修飾符和類型 字段 描述
static int POSITION_INVALID 表示容器中的頁面無效。
static int POSITION_REMAIN 表示頁面在容器中的位置保持不變。

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù) 描述
PageSliderProvider()

方法總結(jié)

修飾符和類型 方法 描述
void addDataSubscriber(DataSetSubscriber subscriber) 為當(dāng)前的 Page Slider Provider 添加訂閱者。
abstract Object createPageInContainer(ComponentContainer container, int position) 在指定位置創(chuàng)建頁面。
abstract void destroyPageFromContainer(ComponentContainer container, int position, Object object) 銷毀容器中的指定頁面。
abstract int getCount() 獲取當(dāng)前適配器中可用組件的數(shù)量。
int getPageIndex(Object object) 獲取容器中對(duì)象的索引。
String getPageTitle(int position) 獲取頁面在指定位置的標(biāo)題。
abstract boolean isPageMatchToObject(Component page, Object object) 檢查組件是否與從 createPageInContainer(ohos.agp.components.ComponentContainer,int) 返回的特定對(duì)象相關(guān)聯(lián)。
void notifyDataChanged() 通知頁面滑塊提供程序數(shù)據(jù)集更改。
void onUpdateFinished(ComponentContainer componentContainer) 通知容器頁面更新已完成。
void removeDataSubscriber(DataSetSubscriber subscriber) 從當(dāng)前 PageSliderProvider 注銷訂閱者。
void startUpdate(ComponentContainer container) 收到通知,指示顯示的頁面上即將發(fā)生更新。
從類 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段詳細(xì)信息

POSITION_INVALID

public static final int POSITION_INVALID

表示容器中的頁面無效。

POSITION_REMAIN

public static final int POSITION_REMAIN

表示頁面在容器中的位置保持不變。

構(gòu)造函數(shù)詳細(xì)信息

PageSliderProvider

public PageSliderProvider()

方法詳情

getCount

public abstract int getCount()

獲取當(dāng)前適配器中可用組件的數(shù)量。

返回:

返回可用組件的數(shù)量。

createPageInContainer

public abstract Object createPageInContainer(ComponentContainer container, int position)

在指定位置創(chuàng)建頁面。

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

參數(shù):

參數(shù)名稱 參數(shù)描述
container 指示要顯示 PageSliderProvider 的容器。
position 表示容器中的指定位置。

返回:

返回顯示的頁面。

destroyPageFromContainer

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

銷毀容器中的指定頁面。

參數(shù):

參數(shù)名稱 參數(shù)描述
container 指示頁面適配器所屬的容器。
position 表示容器中的指定位置。
object 指示要銷毀的頁面。

isPageMatchToObject

public abstract boolean isPageMatchToObject(Component page, Object object)

檢查組件是否與從 createPageInContainer(ohos.agp.components.ComponentContainer,int) 返回的特定對(duì)象相關(guān)聯(lián)。

參數(shù):

參數(shù)名稱 參數(shù)描述
page 表示要檢查的組件。
object 指示與要檢查的組件關(guān)聯(lián)的對(duì)象。

返回:

組件是否與對(duì)象關(guān)聯(lián)。

startUpdate

public void startUpdate(ComponentContainer container)

收到通知,指示顯示的頁面上即將發(fā)生更新。

參數(shù):

參數(shù)名稱 參數(shù)描述
container 指示頁面適配器所屬的ComponentContainer。

onUpdateFinished

public void onUpdateFinished(ComponentContainer componentContainer)

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

調(diào)用此方法時(shí),必須確保所有頁面都已按要求添加到容器中或從容器中移除。

參數(shù):

參數(shù)名稱 參數(shù)描述
componentContainer 指示頁面適配器所屬的容器。

Since:

4

getPageIndex

public int getPageIndex(Object object)

獲取容器中對(duì)象的索引。

參數(shù):

參數(shù)名稱 參數(shù)描述
object 表示用于生成組件的對(duì)象。

返回:

返回容器中對(duì)象的索引; 如果對(duì)象索引沒有改變,則返回 POSITION_REMAIN; 如果容器中不存在對(duì)象,則返回 POSITION_INVALID。

Since:

4

notifyDataChanged

public void notifyDataChanged()

通知頁面滑塊提供程序數(shù)據(jù)集更改。

當(dāng)要顯示的數(shù)據(jù)發(fā)生變化時(shí)調(diào)用該方法。

Since:

4

addDataSubscriber

public final void addDataSubscriber(DataSetSubscriber subscriber)

為當(dāng)前的 PageSliderProvider 添加訂閱者。

訂閱者接收與數(shù)據(jù)更改相關(guān)的回調(diào)。

參數(shù):

參數(shù)名稱 參數(shù)描述
subscriber 表示訂閱者。

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果參數(shù)值為 null,則引發(fā)此異常。
IllegalStateException 如果已添加對(duì)象,則拋出此異常

Since:

4

removeDataSubscriber

public final void removeDataSubscriber(DataSetSubscriber subscriber)

從當(dāng)前 PageSliderProvider 注銷訂閱者。

參數(shù):

參數(shù)名稱 參數(shù)描述
subscriber 表示要移除的訂閱者。

Throws:

Throw名稱 Throw描述
IllegalArgumentException 如果參數(shù)值為 null,則引發(fā)此異常。
IllegalStateException 如果對(duì)象已被移除,則拋出此異常

Since:

4

getPageTitle

public String getPageTitle(int position)

獲取頁面在指定位置的標(biāo)題。

該方法可用于 PageSliderProvider 對(duì)象獲取指定頁面的標(biāo)題。

參數(shù):

參數(shù)名稱 參數(shù)描述
position 指示頁面在 PageSliderProvider 中的位置。

返回:

返回頁面標(biāo)題。

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)