鸿蒙OS开发文档 鸿蒙OS WindowManager

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

WindowManager

java.lang.Object
|---ohos.agp.window.service.WindowManager

public class WindowManager
extends Object

创建一个用于创建和销毁 Window 对象的单例 WindowManager。

Since:

2

嵌套类摘要

修饰符和类型描述
static classWindowManager.LayoutConfig封装与 Window 一起使用的布局属性、标志和常量。
static classWindowManager.NotchMode表示缺口的显示方式。
static classWindowManager.PermissionException描述创建窗口时抛出的异常。

方法总结

修饰符和类型方法描述
WindowaddComponent(ComponentContainer component, Context context, int typeFlag)根据组件布局、上下文和窗口类型创建窗口。
PixelMapcaptureScreen(Rect rectangle, int width, int height, int angle)截图。
voiddestroyWindow(Window window)销毁一个窗口。
static WindowManagergetInstance()获取单例 WindowManager。
OptionalWindowgetTopWindow()获取当前应用程序的顶部窗口。
intgetWindowCount(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描述
NullPointerException如果 mAGPWindowManager 为空,则抛出此异常。
WindowManager.PermissionException如果 agp 窗口无法显示,则抛出此异常。

destroyWindow

public void destroyWindow(Window window)

销毁一个窗口。

参数:

参数名称参数描述
window指示要销毁的窗口。

captureScreen

public PixelMap captureScreen(Rect rectangle, int width, int height, int angle)

截图。

参数:

参数名称参数描述
rectangle用指定坐标指示矩形。
width指示所需像素图的宽度。
height指示所需像素图的高度。
angle表示旋转角度。 0 表示不应用旋转。

返回:

返回当前屏幕的像素图。

Throws:

Throw名称Throw描述
NullPointerException如果 mAGPWindowManager 为空,则抛出此异常。