鸿蒙OS开发文档 第18页

WindowManager.LayoutConfig java.lang.Object |—ohos.agp.window.service.WindowManager.LayoutConfig public static class WindowManager.LayoutConfig extends Object 封装与 Window 一起使用的布局属性、标志和常量。 Since: 3 字段摘要 修饰符和类型 字段 描述 int alignment 指示窗口的方向。 float alpha 表示窗口的透明度。 static int ALTER_ALPHA 指示 alpha 值已更改。 static int ALTER_DIM 表示调光量发生了变化。 static int ALTER_FLAGS 指示标志已更改。 static int ALTER_FORMAT 表示像素格式已更改。 static int ALTER_LAYOUT 表示布局已更改。 static int ALTER_TITLE 表明标题已更改。 int animations 指示窗口动画的资源 id。 float dim 指示窗口的亮度。 static int FIRST_SUB_WINDOW 1000：表示第一个子窗口。 static int FIRST_SYSTEM_WINDOW 2000：表示第一个系统窗口。 int flags 指示窗口的各种标志。 int height 指示窗口的高度。 static int INPUT_ADJUST_NOTHING 0x00000018：不调整输入法窗口； 调整窗口大小或移动窗口。 static int INPUT_ADJUST_PAN 0x00000010：移动窗口位置以显示软输入光标的焦点。 static int INPUT_ADJUST_RESIZE 0x00000008：重新调整窗口大小以确保输入焦点可见。 static int INPUT_ADJUST_UNSPECIFIED 0x00：依赖于窗口的内容。 static int INPUT_IS_FORWARD_NAVIGATION 0x00000080：当此窗口请求用户获得焦点时，系统自动设置此标志。 static int INPUT_MASK_ADJUST 0x00000078：调整窗口使软输入区域可见。 static int INPUT_MASK_STATE 0x15：与窗口确认软输入面板的显示状态。 static int INPUT_STATE_ALWAYS_HIDDEN 0x80000001：当面板接收到焦点时，软输入区域被隐藏。 static int INPUT_STATE_ALWAYS_VISIBLE 0x80000002：当面板获得焦点时，软输入区域始终可见。 static int INPUT_STATE_HIDDEN 0x00000001：当此窗口请求用户获得焦点时，软输入面板不可见。 static int INPUT_STATE_UNCHANGED 0x80000000：无法更改软输入面板的可见性。 static int INPUT_STATE_UNSPECIFIED 0：窗口请求焦点后，软输入面板可见或不可见。 static int INPUT_STATE_VISIBLE 0x00000002：当用户向前导航到面板时，显示软输入区域。 static int LAYOUT_IN_DISPLAY_SIDE_MODE_ALWAYS 表示始终显示侧边栏。 static int LAYOUT_IN_DISPLAY_SIDE_MODE_DEFAULT 指示侧边栏的默认显示模式。 static int LAYOUT_IN_DISPLAY_SIDE_MODE_NEVER 指示从不显示侧边栏。 int layoutInDisplaySideMode 指示该窗口侧边栏的显示方式。 static int MARK_ALLOW_EXTEND_LAYOUT 0x00000100：面板可以扩展到屏幕之外。 static int MARK_ALLOW_LAYOUT_COVER_SCREEN 0x00000080：扩展窗口覆盖全屏，同时保持边框周围的装饰（如状态栏）正常显示。 static int MARK_ALLOW_LAYOUT_OVERSCAN 0x01000000：表示窗口可以将内容扩散到屏幕的过扫描范围，如果有的话。...

WindowManager java.lang.Object |—ohos.agp.window.service.WindowManager public class WindowManager extends Object 创建一个用于创建和销毁 Window 对象的单例 WindowManager。 Since: 2 嵌套类摘要 修饰符和类型 类 描述 static class WindowManager.LayoutConfig 封装与 Window 一起使用的布局属性、标志和常量。 static class WindowManager.NotchMode 表示缺口的显示方式。 static class WindowManager.PermissionException 描述创建窗口时抛出的异常。 方法总结 修饰符和类型 方法 描述 Window addComponent(ComponentContainer component, Context context, int typeFlag) 根据组件布局、上下文和窗口类型创建窗口。 PixelMap captureScreen(Rect rectangle, int width, int height, int angle) 截图。 void destroyWindow(Window window) 销毁一个窗口。 static WindowManager getInstance() 获取单例 WindowManager。 OptionalWindow getTopWindow() 获取当前应用程序的顶部窗口。 int getWindowCount(Context context) 获取当前应用程序所有窗口的数量。 从类 java.lang.Object 继承的方法 clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 方法详情 getInstance public static WindowManager getInstance() 获取单例 WindowManager。 这是一个静态工厂方法。 返回: 返回 WindowManager 实例。 getTopWindow public OptionalWindow getTopWindow() 获取当前应用程序的顶部窗口。 返回: 返回当前应用程序的顶部窗口。 Throws: Throw名称 Throw描述 NullPointerException 如果 mAGPWindowManager 为空，则抛出此异常。 getWindowCount public int getWindowCount(Context context) 获取当前应用程序所有窗口的数量。 参数： 参数名称 参数描述 context 指示窗口的上下文。 返回: 返回当前应用程序所有窗口的数量。 Throws: Throw名称 Throw描述 NullPointerException 如果 mAGPWindowManager 为空，则抛出此异常。 addComponent public Window addComponent(ComponentContainer component, Context context, int typeFlag) 根据组件布局、上下文和窗口类型创建窗口。 参数： 参数名称 参数描述 component 表示用户定义的组件布局。 context 指明要使用的上下文。 typeFlag 指明窗口类型。 返回: 返回创建的窗口。 Throws: Throw名称 Throw描述...

Window java.lang.Object |—ohos.agp.window.service.Window public class Window extends Object windows 的实现类。 该类提供了基于 LayoutConfig 修改窗口属性的方法。 Since: 2 嵌套类摘要 修饰符和类型 类 描述 static interface Window.IAccessibilityEventListener 填充可访问性事件侦听器的实现类。 构造函数摘要 构造函数 描述 Window() 用于创建 Window 实例的构造函数。 方法总结 修饰符和类型 方法 描述 void addFlags(int flags) 添加窗口标志。 void addWindowFlags(int flags) 在 ohos 中添加窗口的特征标志。 void clearFlags(int flags) 从窗口中清除标志。 void clearWindowFlags(int flags) 清除窗口中的标志。 float getAltitude() 获取窗口在垂直于手机屏幕方向的高度。 Rect getBoundRect() 获取移动窗口的边界。 OptionalComponent getCurrentComponentFocus() 获取在此窗口中获得焦点的 Component 对象。 OptionalWindowManager.LayoutConfig getLayoutConfig() 获取要读取或修改的 Window 实例的 LayoutConfig 对象。 LayoutScatter getLayoutScatter() 获取此窗口的布局散点图。 int getStatusBarVisibility() 获取状态栏是否可见。 int getSystemBarStyle() 获取导航栏或状态栏的可见性类型。 boolean isActive() 检查此窗口是否处于活动状态。 boolean isMovable() 检查窗口是否可移动。 boolean isWCGMode() 检查此窗口是否处于广色域 (WCG) 模式。 int replicateFrom(WindowManager.LayoutConfig param) 为此窗口设置布局属性。 void setAccessibilityEventListener(Window.IAccessibilityEventListener listener) 设置可访问性事件的侦听器。 void setAltitude(float altitude) 设置垂直于电话屏幕方向的窗口高度。 void setBackground(String elementPath) 设置窗口的背景。 void setBackgroundColor(RgbColor rgbColor) 设置窗口的背景颜色。 void setBoundRect(Rect boundRect) 设置移动窗口的边界。 void setInputPanelDisplayType(int type) 设置软输入面板的显示类型。 void setLayoutAlignment(int alignment) 设置窗口的文本对齐方式。 void setLayoutConfig(WindowManager.LayoutConfig param) 设置 Window 实例的 LayoutConfig。 void setLayoutFlags(int flags, int mask) 为窗口设置标志。 void setLayoutInDisplaySideMode(int mode) 设置此窗口侧边栏的显示模式。 void setLayoutInNotchMode(WindowManager.NotchMode mode) 设置此窗口在凹槽中的显示模式。 void setMovable(boolean isMovable) 设置窗口是否可移动。 void setNavigationBarColor(int color) 设置导航栏的颜色。 void setOnApplyComponentPaddingListener(IApplyComponentPaddingListener listener) 设置一个监听器来监控 ComponentPadding 的变化。 void setPadding(int left, int top, int right, int bottom)...

DisplayNotch java.lang.Object |—ohos.agp.window.service.DisplayNotch public class DisplayNotch extends Object 表示一个显示槽口，不能用于显示内容。 您可以使用此类中的方法来获取设备上的缺口大小和安全填充。 Since: 5 构造函数摘要 构造函数 描述 DisplayNotch() 用于创建 DisplayNotch 实例的构造函数。 方法总结 修饰符和类型 方法 描述 boolean equals(Object object) 检查此 DisplayNotch 对象是否等于指定的对象。 Rect getNotchRectBottom() 获取屏幕底部的矩形显示槽口。 Rect getNotchRectLeft() 获取屏幕左侧的矩形显示槽口。 Rect getNotchRectRight() 获取屏幕右侧的矩形显示槽口。 ListRect getNotchRects() 获取 Rect 对象列表，每个对象代表屏幕上的一个矩形显示槽口。 Rect getNotchRectTop() 获取屏幕顶部的矩形显示槽口。 int getPaddingBottom() 从屏幕底部获取安全填充，不包括显示槽口。 int getPaddingLeft() 从屏幕左侧获取安全填充，不包括显示槽口。 int getPaddingRight() 从屏幕右侧获取安全填充，不包括显示槽口。 int getPaddingTop() 从屏幕顶部获取安全填充，不包括显示槽口。 int hashCode() 获取此 DisplayNotch 对象的哈希码。 String toString() 返回表示此 DisplayNotch 对象的字符串。 从类 java.lang.Object 继承的方法 clone, finalize, getClass, notify, notifyAll, wait, wait, wait 构造函数详细信息 DisplayNotch public DisplayNotch() 用于创建 DisplayNotch 实例的构造函数。 方法详情 getNotchRectBottom public Rect getNotchRectBottom() 获取屏幕底部的矩形显示槽口。 返回: 返回一个 Rect 对象，以像素为单位。 Throws: Throw名称 Throw描述 ohos.agp.window.view.DisplayCutoutWrapper.ParameterInvalidException 如果 mDisplayCutoutWrapper 为空，则抛出此异常。 Since: 5 getNotchRectLeft public Rect getNotchRectLeft() 获取屏幕左侧的矩形显示槽口。 返回: 返回一个 Rect 对象，以像素为单位。 Throws: Throw名称 Throw描述 ohos.agp.window.view.DisplayCutoutWrapper.ParameterInvalidException 如果 mDisplayCutoutWrapper 为空，则抛出此异常。 Since: 5 getNotchRectRight public Rect getNotchRectRight() 获取屏幕右侧的矩形显示槽口。 返回: 返回一个 Rect 对象，以像素为单位。 Throws: Throw名称 Throw描述 ohos.agp.window.view.DisplayCutoutWrapper.ParameterInvalidException 如果 mDisplayCutoutWrapper 为空，则抛出此异常。 Since: 5 getNotchRectTop public Rect...

DisplayManager java.lang.Object |—ohos.agp.window.service.DisplayManager public class DisplayManager extends Object 管理显示实例。 此类是单例，用于获取 Display 对象以获取有关显示的更多信息。 Since: 2 方法总结 修饰符和类型 方法 描述 void addDisplayEventCallback(Context context, IDisplayEventCallback listener) 为显示事件注册回调。 ListDisplay getAllDisplays(Context context) 获取特定上下文的所有显示。 OptionalDisplay getDefaultDisplay(Context context) 获取特定上下文的默认显示。 static DisplayManager getInstance() 创建单个 DisplayManager 实例。 void removeDisplayEventCallback(Context context, IDisplayEventCallback listener) 取消注册显示事件的回调。 从类 java.lang.Object 继承的方法 clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 方法详情 getInstance public static DisplayManager getInstance() 创建单个 DisplayManager 实例。 此方法是静态工厂方法。 返回: 返回一个 DisplayManager 实例。 getDefaultDisplay public OptionalDisplay getDefaultDisplay(Context context) 获取特定上下文的默认显示。 参数： 参数名称 参数描述 context 指示当前上下文。 返回: 返回默认显示。 getAllDisplays public ListDisplay getAllDisplays(Context context) 获取特定上下文的所有显示。 参数： 参数名称 参数描述 context 指示当前上下文。 返回: 返回所有显示。 addDisplayEventCallback public void addDisplayEventCallback(Context context, IDisplayEventCallback listener) 为显示事件注册回调。 参数： 参数名称 参数描述 context 指示应用程序上下文。 listener 指示 IDisplayEventCallback 对象。 Since: 5 removeDisplayEventCallback public void removeDisplayEventCallback(Context context, IDisplayEventCallback listener) 取消注册显示事件的回调。 参数： 参数名称 参数描述 context 指示应用程序上下文。 listener 指示 IDisplayEventCallback 对象。 Since: 5

DisplayAttributes java.lang.Object |—ohos.agp.window.service.DisplayAttributes public class DisplayAttributes extends Object 以像素为单位封装显示属性，包括显示宽度、高度和密度。 Since: 3 字段摘要 修饰符和类型 字段 描述 int densityDpi 表示显示分辨率。 float densityPixels 以像素为单位表示显示密度。 int height 表示显示的实际高度，以像素为单位。 static int HIGH_DENSITY 表示高分辨率显示的密度，值为 240。 static int LOW_DENSITY 表示低分辨率显示的密度，值为 120。 static int MEDIUM_DENSITY 表示中分辨率显示的密度，值为 160。 float scalDensity 指示显示的文本比例密度。 int width 表示显示的实际宽度，以像素为单位。 float xDpi 表示 X 轴上的每英寸点数 (DPI)。 float yDpi 表示 Y 轴上的 DPI。 构造函数摘要 构造函数 描述 DisplayAttributes() 用于创建 DisplayAttributes 实例的默认构造函数。 方法总结 从类 java.lang.Object 继承的方法 clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 字段详细信息 HIGH_DENSITY public static final int HIGH_DENSITY 表示高分辨率显示的密度，值为 240。 LOW_DENSITY public static final int LOW_DENSITY 表示低分辨率显示的密度，值为 120。 MEDIUM_DENSITY public static final int MEDIUM_DENSITY 表示中分辨率显示的密度，值为 160。 densityDpi public int densityDpi 表示显示分辨率。 densityPixels public float densityPixels 以像素为单位表示显示密度。 低分辨率显示器的值为 1.0。 height public int height 表示显示的实际高度，以像素为单位。 scalDensity public float scalDensity 指示显示的文本比例密度。 width public int width 表示显示的实际宽度，以像素为单位。 xDpi public float xDpi 表示 X 轴上的每英寸点数 (DPI)。 yDpi public float yDpi 表示...

Display java.lang.Object |—ohos.agp.window.service.Display public class Display extends Object 封装显示属性和操作。 DisplayManager.getDefaultDisplay(Context) 返回一个 Display 对象。 Since: 2 字段摘要 修饰符和类型 字段 描述 static int STATE_DOZE 表示此屏幕正在打瞌睡。 static int STATE_DOZE_SUSPEND 表示此屏幕正在打瞌睡，但 CPU 暂停更新它。 static int STATE_OFF 表示此屏幕已关闭。 static int STATE_ON 表示此屏幕已打开。 static int STATE_ON_SUSPEND 表示此屏幕已打开，但 CPU 暂停更新它。 static int STATE_UNKNOWN 表示此屏幕处于未知状态。 static int STATE_VR 表示此屏幕处于虚拟现实（VR）状态。 构造函数摘要 构造函数 描述 Display() 用于创建 Display 实例的构造函数。 方法总结 修饰符和类型 方法 描述 DisplayAttributes getAttributes() 获取显示的属性。 void getCurrentSizeRange(Point outSmallestSize, Point outLargestSize) 获取显示器的尺寸范围，以像素为单位。 int getDisplayId() 获取显示器的ID。 String getDisplayName() 获取显示器的名称。 int getDisplayState() 获取此显示设备的状态。 DisplayAttributes getRealAttributes() 获取显示的实际属性。 void getRealSize(Point outSize) 获取实际显示尺寸。 float getRefreshRate() 获取此显示设备每秒的屏幕刷新率。 int getRotation() 获取显示器的旋转度数。 void getSize(Point outSize) 获取显示器的尺寸。 boolean isAlive() 检查此显示设备是否处于活动状态。 从类 java.lang.Object 继承的方法 clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 字段详细信息 STATE_DOZE public static final int STATE_DOZE 表示此屏幕正在打瞌睡。 Since: 5 STATE_DOZE_SUSPEND public static final int STATE_DOZE_SUSPEND 表示此屏幕正在打瞌睡，但 CPU 暂停更新它。 Since: 5 STATE_OFF public static final int STATE_OFF 表示此屏幕已关闭。 Since: 5 STATE_ON public static final...

ComponentPadding java.lang.Object |—ohos.agp.window.service.ComponentPadding public class ComponentPadding extends Object 描述窗口填充。 通过 Window#setOnApplyComponentPaddingListener 设置监听器后，将在填充更改时调用回调 IApplyComponentPaddingListener#notifyPaddingChange(ComponentPadding padding)。 应用程序将使用传递给回调的新填充值进行布局。 Since: 5 构造函数摘要 构造函数 描述 ComponentPadding() 用于创建 ComponentPadding 实例的构造函数。 方法总结 修饰符和类型 方法 描述 DisplayNotch getDisplayNotch() 获取有关显示槽口的信息。 Rect getGestureRect() 获取可设置的系统手势区域。 Rect getNotSettableGestureRect() 获取无法设置的系统手势区域。 int getSystemComponentPaddingBottom() 从系统窗口获取到屏幕底部的填充。 int getSystemComponentPaddingLeft() 从屏幕左侧的系统窗口获取填充。 int getSystemComponentPaddingRight() 从屏幕右侧的系统窗口获取填充。 int getSystemComponentPaddingTop() 获取从系统窗口到屏幕顶部的填充。 int getUnchangedPaddingBottom() 获取从未更改区域到屏幕底部的填充。 int getUnchangedPaddingLeft() 从屏幕左侧未更改的区域获取填充。 int getUnchangedPaddingRight() 从屏幕右侧未更改的区域获取填充。 int getUnchangedPaddingTop() 获取从未更改区域到屏幕顶部的填充。 boolean hasNonZeroPadding() 检查是否有任何非零填充。 boolean hasSystemComponentPadding() 检查系统窗口是否有任何填充。 boolean hasUnchangedPadding() 检查是否有任何未更改的窗口填充。 boolean isPaddingFullyUsed() 检查填充是否被充分使用。 boolean isRoundCorner() 检查关联窗口是否有圆角。 ComponentPadding useDisplayNotch() 清除显示槽口。 ComponentPadding useSystemComponentPadding() 清除系统组件填充。 ComponentPadding useUnchangedPadding() 清除未更改的区域。 从类 java.lang.Object 继承的方法 clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 构造函数详细信息 ComponentPadding public ComponentPadding() 用于创建 ComponentPadding 实例的构造函数。 方法详情 getNotSettableGestureRect public Rect getNotSettableGestureRect() 获取无法设置的系统手势区域。 返回: 返回一个 Rect 对象，表示获得的系统手势区域。 Throws: Throw名称 Throw描述 ohos.agp.window.view.WindowInsetsWrapper.ParameterInvalidException 如果 mWindowInsetsWrapper 无效，则抛出此异常。 Since: 5 getGestureRect public Rect getGestureRect() 获取可设置的系统手势区域。 返回: 返回一个 Rect 对象，表示获得的系统手势区域。...

Window.IAccessibilityEventListener public static interface Window.IAccessibilityEventListener 填充可访问性事件侦听器的实现类。 Since: 3 方法总结 修饰符和类型 方法 描述 void onDispatchEvent(AccessibilityEventInfo event) 设置填充辅助功能事件调度。 方法详情 onDispatchEvent void onDispatchEvent(AccessibilityEventInfo event) 设置填充辅助功能事件调度。 参数： 参数名称 参数描述 event 填充辅助功能事件。

IDisplayEventCallback public interface IDisplayEventCallback 提供回调以报告显示设备的事件。 当显示设备连接、移除或显示设备信息发生变化时，您可以调用该类中提供的回调来报告事件。 Since: 5 方法总结 修饰符和类型 方法 描述 void onDisplayChanged(int displayId) 当显示设备信息（如显示大小或密度）发生变化时调用。 void onDisplayConnected(int displayId) 连接显示设备时调用。 void onDisplayDisconnected(int displayId) 当显示设备断开连接时调用。 方法详情 onDisplayConnected void onDisplayConnected(int displayId) 连接显示设备时调用。 参数： 参数名称 参数描述 displayId 指示显示设备 ID。 Since: 5 onDisplayDisconnected void onDisplayDisconnected(int displayId) 当显示设备断开连接时调用。 参数： 参数名称 参数描述 displayId 指示显示设备 ID。 Since: 5 onDisplayChanged void onDisplayChanged(int displayId) 当显示设备信息（如显示大小或密度）发生变化时调用。 参数： 参数名称 参数描述 displayId 指示显示设备 ID。 Since: 5