鸿蒙OS开发文档 鸿蒙OS ComponentTreeObserver

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 2

ComponentTreeObserver

java.lang.Object
|---ohos.agp.components.ComponentTreeObserver

public final class ComponentTreeObserver
extends Object

定义组件层次结构的侦听器。

您可以注册侦听器以监视组件层次结构中的全局更改。

嵌套类摘要

修饰符和类型描述
static interfaceComponentTreeObserver.GlobalFocusUpdatedListener当组件树中的焦点状态发生变化时调用的回调。
static interfaceComponentTreeObserver.GlobalLayoutListener已弃用。 此更改从 API 版本 6 开始生效。替换为 Component.LayoutRefreshedListener
static interfaceComponentTreeObserver.ScrollChangedListener滚动组件层次结构中的任何元素时调用的回调。
static interfaceComponentTreeObserver.WindowBoundListener当组件层次结构绑定到其窗口或从其窗口解除绑定时调用的回调。
static interfaceComponentTreeObserver.WindowFocusUpdatedListener当组件层次结构中窗口焦点状态发生变化时调用的回调。

方法总结

修饰符和类型方法描述
voidaddGlobalFocusUpdatedListener(ComponentTreeObserver.GlobalFocusUpdatedListener listener)为 globalFocusChanged() 注册一个监听器。
voidaddScrolledListener(ComponentTreeObserver.ScrollChangedListener listener)为 scrollChanged() 注册一个监听器。
voidaddTreeLayoutChangedListener(ComponentTreeObserver.GlobalLayoutListener listener)已弃用。 此更改从 API 版本 6 开始生效。替换为 setLayoutRefreshedListener(Component.LayoutRefreshedListener)
voidaddWindowBoundListener(ComponentTreeObserver.WindowBoundListener listener)为 windowBound() 注册一个监听器。
voidaddWindowFocusUpdatedListener(ComponentTreeObserver.WindowFocusUpdatedListener listener)为 windowFocusUpdated() 注册一个监听器。
voidremoveGlobalFocusUpdatedListener(ComponentTreeObserver.GlobalFocusUpdatedListener listener)删除为 globalFocusChanged() 注册的侦听器。
voidremoveScrolledListener(ComponentTreeObserver.ScrollChangedListener listener)删除为 scrollChanged() 注册的侦听器。
voidremoveTreeLayoutChangedListener(ComponentTreeObserver.GlobalLayoutListener listener)已弃用。 此更改从 API 版本 6 开始生效。由 setLayoutRefreshedListener(Component.LayoutRefreshedListener) 替换为 null 侦听器值。
voidremoveWindowBoundListener(ComponentTreeObserver.WindowBoundListener listener)删除为 windowAttached() 注册的侦听器。
voidremoveWindowFocusUpdatedListener(ComponentTreeObserver.WindowFocusUpdatedListener listener)删除为 windowFocusUpdated() 注册的侦听器。
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详情

addWindowFocusUpdatedListener

public void addWindowFocusUpdatedListener(ComponentTreeObserver.WindowFocusUpdatedListener listener)

为 windowFocusUpdated() 注册一个监听器。

参数:

参数名称参数描述
listener指示要注册的侦听器。

removeWindowFocusUpdatedListener

public void removeWindowFocusUpdatedListener(ComponentTreeObserver.WindowFocusUpdatedListener listener)

删除为 windowFocusUpdated() 注册的侦听器。

参数:

参数名称参数描述
listener指示要删除的侦听器。

addWindowBoundListener

public void addWindowBoundListener(ComponentTreeObserver.WindowBoundListener listener)

为 windowBound() 注册一个监听器。

参数:

参数名称参数描述
listener指示要注册的侦听器。

removeWindowBoundListener

public void removeWindowBoundListener(ComponentTreeObserver.WindowBoundListener listener)

删除为 windowAttached() 注册的侦听器。

参数:

参数名称参数描述
listener指示要删除的侦听器。

addScrolledListener

public void addScrolledListener(ComponentTreeObserver.ScrollChangedListener listener)

为 scrollChanged() 注册一个监听器。

参数:

参数名称参数描述
listener指示要注册的侦听器。

removeScrolledListener

public void removeScrolledListener(ComponentTreeObserver.ScrollChangedListener listener)

删除为 scrollChanged() 注册的侦听器。

参数:

参数名称参数描述
listener指示要删除的侦听器。

addGlobalFocusUpdatedListener

public void addGlobalFocusUpdatedListener(ComponentTreeObserver.GlobalFocusUpdatedListener listener)

为 globalFocusChanged() 注册一个监听器。

参数:

参数名称参数描述
listener指示要注册的侦听器。

removeGlobalFocusUpdatedListener

public void removeGlobalFocusUpdatedListener(ComponentTreeObserver.GlobalFocusUpdatedListener listener)

删除为 globalFocusChanged() 注册的侦听器。

参数:

参数名称参数描述
listener指示要删除的侦听器。

addTreeLayoutChangedListener

@Deprecated public void addTreeLayoutChangedListener(ComponentTreeObserver.GlobalLayoutListener listener)

已弃用。 此更改从 API 版本 6 开始生效。替换为 setLayoutRefreshedListener(Component.LayoutRefreshedListener)

为 globalLayoutChanged() 注册一个监听器。

参数:

参数名称参数描述
listener指示要注册的侦听器。

removeTreeLayoutChangedListener

@Deprecated public void removeTreeLayoutChangedListener(ComponentTreeObserver.GlobalLayoutListener listener)

已弃用。 此更改从 API 版本 6 开始生效。由 setLayoutRefreshedListener(Component.LayoutRefreshedListener) 替换为 null 侦听器值。

删除为 globalLayoutChanged() 注册的侦听器。

参数:

参数名称参数描述
listener指示要删除的侦听器。