diff --git a/zh-cn/application-dev/windowmanager/Readme-CN.md b/zh-cn/application-dev/windowmanager/Readme-CN.md new file mode 100644 index 0000000000000000000000000000000000000000..3fd9703535131da3414947cd088cc75418cf9f02 --- /dev/null +++ b/zh-cn/application-dev/windowmanager/Readme-CN.md @@ -0,0 +1,12 @@ +# 窗口管理 + +* 窗口 + * 窗口开发概述 + * 窗口开发指导 +* 显示设备 + * [屏幕属性开发概述](display-overview.md) + * [屏幕属性开发指导](display-guidelines.md) +* 屏幕截图 + * [屏幕截图开发概述](screenshot-overview.md) + * [屏幕截图开发指导](screenshot-guidelines.md) + diff --git a/zh-cn/application-dev/windowmanager/display-guidelines.md b/zh-cn/application-dev/windowmanager/display-guidelines.md new file mode 100644 index 0000000000000000000000000000000000000000..5133771581ab75d1906bedc5fed4e8cbfba9ef4a --- /dev/null +++ b/zh-cn/application-dev/windowmanager/display-guidelines.md @@ -0,0 +1,25 @@ +# 屏幕属性开发指导 + +## 场景介绍 + +应用通过调用屏幕接口获取默认Display或者所有Display的属性。 + +## 接口说明 + +完整版的接口定义请参考API接口说明文件:[屏幕属性](../reference/apis/js-apis-display.md)。 + +### 开发步骤 + +通过`getDefaultDisplay(): Promise`来获取当前默认的`Display`对象,具体代码示例可参考: + +```js +import display from '@ohos.display' // 导入模块 + +let disp; // disp用来保存默认Display +display.getDefaultDisplay().then((disp) => { + console.log('display.getDefaultDisplay success, display :' + JSON.stringify(disp)); +}, (err) => { + console.log('display.getDefaultDisplay failed, error : ' + JSON.stringify(err)); +}) +``` + diff --git a/zh-cn/application-dev/windowmanager/display-overview.md b/zh-cn/application-dev/windowmanager/display-overview.md new file mode 100644 index 0000000000000000000000000000000000000000..8c80828fc20c4e694ca92a6922e2afa906f7ec36 --- /dev/null +++ b/zh-cn/application-dev/windowmanager/display-overview.md @@ -0,0 +1,7 @@ +# 屏幕属性开发概述 + +屏幕具有显示应用窗口布局的能力,屏幕属性包括:屏幕id号、屏幕名称、屏幕启用标识、屏幕状态、屏幕刷新率、屏幕旋转角度、屏幕宽度、屏幕高度、屏幕像素密度、屏幕字体缩放因子和每英寸屏幕的确切物理像素值。 + +## 基本概念 + +`Display`:Display指的是对应用可见的屏幕,这是一种抽象的屏幕概念,与真实的物理屏幕不同,可作为窗口容器。 diff --git a/zh-cn/application-dev/windowmanager/screenshot-guidelines.md b/zh-cn/application-dev/windowmanager/screenshot-guidelines.md new file mode 100644 index 0000000000000000000000000000000000000000..0ed1eb14ff3a0ba00e8b64d40f3f6645d9f5a15f --- /dev/null +++ b/zh-cn/application-dev/windowmanager/screenshot-guidelines.md @@ -0,0 +1,38 @@ +# 屏幕截图开发概述 + +## 场景介绍 + +指定显示设备进行特定参数的屏幕截图。 + +## 接口说明 + +完整版的接口定义请参考API接口说明文件:[屏幕截图](../reference/apis/js-apis-screenshot.md)。 + +## 开发步骤 + +通过接口`save(options?: ScreenshotOptions): Promise`进行屏幕截图。其中`options`为预定义的截屏参数,如果没有输入`options`,则使用默认截取整屏,具体代码示例可参考: + +```js +import screenshot from '@ohos.screenshot' // 导入模块 + +// 设置屏幕截图参数 +var ScreenshotOptions = { + "screenRect": { + "left": 200, + "top": 100, + "width": 200, + "height": 200}, + "imageSize": { + "width": 300, + "height": 300}, + "rotation": 0 +}; + +let image; // image用来保存屏幕截图 +screenshot.save(ScreenshotOptions).then((image) => { + console.log('screenshot.save success, screenshot image :' + JSON.stringify(image)); +}, (err) => { + console.log('screenshot.save failed, error : ' + JSON.stringify(err)); +}) +``` + diff --git a/zh-cn/application-dev/windowmanager/screenshot-overview.md b/zh-cn/application-dev/windowmanager/screenshot-overview.md new file mode 100644 index 0000000000000000000000000000000000000000..f2faeb9256efa801a66f618b4c03acc3c568beab --- /dev/null +++ b/zh-cn/application-dev/windowmanager/screenshot-overview.md @@ -0,0 +1,7 @@ +# 屏幕截图开发指导 + +提供指定显示设备下特定参数的屏幕截图能力。 + +## 基本概念 + +`screenshot`:提供屏幕截图能力。