屏幕截圖

本模塊提供屏幕截圖的能力，截取屏幕時支持設(shè)置截取的區(qū)域、大小等圖像信息。

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨標(biāo)記接口的起始版本。

該模塊接口為系統(tǒng)接口。

導(dǎo)入模塊

import screenshot from '@ohos.screenshot';

ScreenshotOptions

設(shè)置截取圖像的信息。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

Rect

表示截取圖像的區(qū)域。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

Size

表示截取圖像的大小。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

screenshot.save

save(options?: ScreenshotOptions, callback: AsyncCallback): void

獲取屏幕截圖。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

需要權(quán)限 ：ohos.permission.CAPTURE_SCREEN，僅系統(tǒng)應(yīng)用可用。

參數(shù)：

示例：

var ScreenshotOptions = {
	"screenRect": {
		"left": 200,
		"top": 100,
		"width": 200,
		"height": 200},
	"imageSize": {
		"width": 300,
		"height": 300},
	"rotation": 0,
	"displayId": 0
};
screenshot.save(ScreenshotOptions, (err, data) = > {
	if (err) {
		console.error('Failed to save the screenshot. Error: ' + JSON.stringify(err));
		return;
	}
	console.info('Screenshot saved. Data: ' + JSON.stringify(data));
});

screenshot.save

save(options?: ScreenshotOptions): Promise

獲取屏幕截圖。

系統(tǒng)能力： SystemCapability.WindowManager.WindowManager.Core

需要權(quán)限 ：ohos.permission.CAPTURE_SCREEN，僅系統(tǒng)應(yīng)用可用。

參數(shù)：

返回值：

示例：

var ScreenshotOptions = {
	"screenRect": {
		"left": 200,
		"top": 100,
		"width": 200,
		"height": 200},
	"imageSize": {
		"width": 300,
		"height": 300},
	"rotation": 0,
	"displayId": 0
};
let promise = screenshot.save(ScreenshotOptions);
promise.then(() = > {
    console.log('screenshot save success');
}).catch((err) = > {
    console.log('screenshot save fail: ' + JSON.stringify(err));
});

審核編輯 黃宇