鸿蒙OS开发文档 第33页

ComponentTreeObserver.WindowFocusUpdatedListener public static interface ComponentTreeObserver.WindowFocusUpdatedListener 当组件层次结构中窗口焦点状态发生变化时调用的回调。 此侦听器由 ComponentTreeObserver 定义。 方法总结 修饰符和类型 方法 描述 void onWindowFocusUpdated(boolean hasFocus) 当窗口焦点状态改变时调用的回调。 方法详情 onWindowFocusUpdated void onWindowFocusUpdated(boolean hasFocus) 当窗口焦点状态改变时调用的回调。 参数： 参数名称 参数描述 hasFocus 指示窗口是否获得焦点。

ComponentTreeObserver.WindowBoundListener public static interface ComponentTreeObserver.WindowBoundListener 当组件层次结构绑定到其窗口或从其窗口解除绑定时调用的回调。 此侦听器由 ComponentTreeObserver 定义。 方法总结 修饰符和类型 方法 描述 void onWindowBound() 当组件层次结构绑定到新窗口时要调用的回调方法。 void onWindowUnbound() 当组件层次结构与窗口解除绑定时要调用的回调方法。 方法详情 onWindowBound void onWindowBound() 当组件层次结构绑定到新窗口时要调用的回调方法。 onWindowUnbound void onWindowUnbound() 当组件层次结构与窗口解除绑定时要调用的回调方法。

ComponentTreeObserver.ScrollChangedListener public static interface ComponentTreeObserver.ScrollChangedListener 滚动组件层次结构中的任何元素时调用的回调。 此侦听器由 ComponentTreeObserver 定义。 方法总结 修饰符和类型 方法 描述 void onScrolled() 滚动组件层次结构中的任何元素时调用的回调方法。 方法详情 onScrolled void onScrolled() 滚动组件层次结构中的任何元素时调用的回调方法。

ComponentTreeObserver.GlobalLayoutListener @Deprecatedpublic static interface ComponentTreeObserver.GlobalLayoutListener 已弃用。 此更改从 API 版本 6 开始生效。替换为 Component.LayoutRefreshedListener 方法总结 修饰符和类型 方法 描述 void onGlobalLayoutUpdated() 已弃用。 此更改从 API 版本 6 开始生效。替换为 Component.LayoutRefreshedListener#onRefreshed(Component) 方法详情 onGlobalLayoutUpdated @Deprecated void onGlobalLayoutUpdated() 已弃用。 此更改从 API 版本 6 开始生效。替换为 Component.LayoutRefreshedListener#onRefreshed(Component) 当全局布局状态或组件树中组件的可见性发生变化时调用的回调方法。

ComponentTreeObserver.GlobalFocusUpdatedListener public static interface ComponentTreeObserver.GlobalFocusUpdatedListener 当组件树中的焦点状态发生变化时调用的回调。 此侦听器由 ComponentTreeObserver 定义。 方法总结 修饰符和类型 方法 描述 void onGlobalFocusUpdated(Component oldFocus, Component newFocus) 当组件树中的焦点状态发生变化时要调用的回调方法。 方法详情 onGlobalFocusUpdated void onGlobalFocusUpdated(Component oldFocus, Component newFocus) 当组件树中的焦点状态发生变化时要调用的回调方法。 参数： 参数名称 参数描述 oldFocus 表示焦点改变前有焦点的组件。 newFocus 表示焦点改变后有焦点的组件。

ComponentParent public interface ComponentParent 定义父组件的特征。 此类为组件提供与其父组件交互的接口。 方法总结 修饰符和类型 方法 描述 int getChildIndex(Component component) 查询子组件的位置。 ComponentParent getComponentParent() 获取子组件的父组件。 void moveChildToFront(Component component) 调整子组件的 z 顺序，使其位于所有子组件之上。 boolean onDrag(Component component, DragEvent event) 检查拖动事件是否分发到父组件。 void postLayout() 请求父组件重新排列其布局。 void removeComponent(Component component) 从父组件中移除子组件。 void removeComponentAt(int index) 从组件列表中的指定位置移除组件。 void removeComponents(int start, int count) 从组件列表中的指定位置移除所有组件。 ComponentContainer.LayoutConfig verifyLayoutConfig(ComponentContainer.LayoutConfig config) 根据当前布局类型验证布局参数。 方法详情 postLayout void postLayout() 请求父组件重新排列其布局。 getChildIndex int getChildIndex(Component component) 查询子组件的位置。 参数： 参数名称 参数描述 component 指示要查询的子组件。 返回: 返回一个正整数，表示子组件在父组件中的位置； 如果子组件不包含在父组件中，则返回 -1。 removeComponent void removeComponent(Component component) 从父组件中移除子组件。 参数： 参数名称 参数描述 component 指示要移除的子组件。 removeComponentAt void removeComponentAt(int index) 从组件列表中的指定位置移除组件。 参数： 参数名称 参数描述 index 指示要移除的组件的位置索引。 removeComponents void removeComponents(int start, int count) 从组件列表中的指定位置移除所有组件。 参数： 参数名称 参数描述 start 表示第一个移除的组件的位置索引。 count 表示要移除的组件数量。 verifyLayoutConfig ComponentContainer.LayoutConfig verifyLayoutConfig(ComponentContainer.LayoutConfig config) 根据当前布局类型验证布局参数。 参数： 参数名称 参数描述 config 指示要转换为 ComponentContainer 实例的一组布局参数。 返回: 返回 LayoutConfig 实例，它表示布局参数。 getComponentParent ComponentParent getComponentParent() 获取子组件的父组件。 返回: 返回子组件的父组件。 moveChildToFront void moveChildToFront(Component component) 调整子组件的 z 顺序，使其位于所有子组件之上。 z 顺序调整会更改顺序相关的布局。 参数：...

ComponentContainer.ArrangeListener public static interface ComponentContainer.ArrangeListener 提供自定义组件排列流程的接口。 方法总结 修饰符和类型 方法 描述 boolean onArrange(int left, int top, int width, int height) 通知组件容器在布局时设置子位置和大小 方法详情 onArrange boolean onArrange(int left, int top, int width, int height) 通知组件容器在布局时设置子位置和大小 参数： 参数名称 参数描述 left 表示左边缘的相对位置，以像素为单位。 top 表示上边缘的相对位置，以像素为单位。 width 表示组件宽度，以像素为单位。 height 表示组件高度，以像素为单位。 返回: 如果此组件在 onArrange() 中处理了布局，则应返回 True，并且无需在本机端开始布局，否则返回 false。

Component.UnconsumedKeyEventListener public static interface Component.UnconsumedKeyEventListener 如果键盘事件没有被使用，则提供一个侦听器来调度键盘事件。 方法总结 修饰符和类型 方法 描述 boolean onUnconsumedKeyEvent(Component component, KeyEvent event) 如果键盘事件尚未被焦点组件使用，则在将键盘事件分派到此组件时调用。 方法详情 onUnconsumedKeyEvent boolean onUnconsumedKeyEvent(Component component, KeyEvent event) 如果键盘事件尚未被焦点组件使用，则在将键盘事件分派到此组件时调用。 如果有来自不同组件的多个侦听器，则通知将在任何侦听器声明消费关键事件之前从上到下（按 z 顺序）发送到每个侦听器。 参数： 参数名称 参数描述 component 指示键事件被调度到的组件。 event 表示关键事件的所有信息。 返回: 如果侦听器已经消费了事件，则返回 true； 否则返回 false。

Component.TouchEventListener public static interface Component.TouchEventListener 提供在将触摸事件分派到组件时要调用的回调。 该回调将在组件接收到触摸事件之前被调用。 触摸事件的粒度小于点击事件。 方法总结 修饰符和类型 方法 描述 boolean onTouchEvent(Component component, TouchEvent event) 处理分派给组件的触摸事件。 方法详情 onTouchEvent boolean onTouchEvent(Component component, TouchEvent event) 处理分派给组件的触摸事件。 侦听器在目标组件接收到事件之前响应触摸事件。 参数： 参数名称 参数描述 component 指示将触摸事件分派到的组件。 event 指示有关触摸事件的所有信息。 返回: 如果侦听器已经处理了事件，则返回 true； 否则返回 false。

Component.SpeechEventListener public static interface Component.SpeechEventListener 提供当语音事件绑定到组件时要调用的回调。 方法总结 修饰符和类型 方法 描述 boolean onSpeechEvent(Component component, SpeechEvent event) 当语音事件绑定到组件时调用。 方法详情 onSpeechEvent boolean onSpeechEvent(Component component, SpeechEvent event) 当语音事件绑定到组件时调用。 您需要实现此回调来处理语音事件。 参数： 参数名称 参数描述 component 表示组件。 event 表示语音事件。 返回: 如果侦听器已经处理了事件，则返回 true； 否则返回 false。