openharmony 鸿蒙 js-apis-print-sys

2025-06-12 浏览 (1)

@ohos.print (打印)(系统接口)

该模块为基本打印的操作API，提供调用基础打印功能的接口。

说明：
本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 当前界面仅包含本模块的系统接口，其他公开接口参见@ohos.print (打印)。

导入模块

import { print } from '@kit.BasicServicesKit';

PrintMargin

定义打印页边距的接口。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

属性：

名称类型必填说明
topnumber否表示页面上边距。默认值为0。
bottomnumber否表示页面下边距。默认值为0。
leftnumber否表示页面左边距。默认值为0。
rightnumber否表示页面右边距。默认值为0。

PrinterRange

定义打印范围的接口。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

属性：

名称类型必填说明
startPagenumber否表示起始页。默认值为1。
endPagenumber否表示结束页。默认值为待打印文件的最大页数。
pagesArray<number>否表示待打印的页面范围的集合。默认值为空。

PreviewAttribute

定义打印预览属性的接口。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

属性：

名称类型必填说明
previewRangePrinterRange是表示预览页面范围。
resultnumber否表示预览文件结果。默认值为-1。

PrintResolution

定义打印分辨率的接口。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

属性：

名称类型必填说明
idstring是表示分辨率ID。
horizontalDpinumber是表示水平DPI。
verticalDpinumber是表示垂直DPI。

PrinterCapability

定义打印能力的接口。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

属性：

名称类型必填说明
colorModenumber是表示色彩模式。
duplexModenumber是表示单双面打印模式。
pageSizeArray<PrintPageSize>是表示打印机支持的页面尺寸列表。
resolutionArray<PrintResolution>否表示打印机支持的分辨率列表。
minMarginPrintMargin否表示打印机最小边距。
options11+Object否表示JSON对象字符串。

PrinterInfo

定义打印信息的接口。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

属性：

名称类型必填说明
printerIdstring是表示打印机ID。
printerNamestring是表示打印机名称。
printerStatePrinterState是表示当前打印机状态。
printerIconnumber否表示打印机图标的资源ID。默认值为-1。
descriptionstring否表示打印机说明。
capabilityPrinterCapability否表示打印机功能。
optionsObject否表示JSON对象字符串。

PrintJob

定义打印任务的接口。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

属性：

名称类型必填说明
fdListArray<number>是表示待打印文件fd列表。
jobIdstring是表示打印任务ID。
printerIdstring是表示负责打印的打印机ID。
jobStatePrintJobState是表示当前打印任务状态。
jobSubstate11+PrintJobSubState是表示当前打印任务子状态。
copyNumbernumber是表示文件列表副本。
pageRangePrinterRange是表示打印范围大小。
isSequentialboolean是表示是否连续打印。true表示连续打印，false表示不连续打印。默认值为false。
pageSizePrintPageSize是表示选定的页面尺寸。
isLandscapeboolean是表示是否横向打印。true表示横向打印，false表示纵向打印。默认值为false。
colorModenumber是表示色彩模式。
duplexModenumber是表示单双面打印模式。
marginPrintMargin否表示当前页边距设置。
previewPreviewAttribute否表示预览设置。
optionsObject否表示JSON对象字符串。

PrinterExtensionInfo

定义打印扩展信息的接口。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

属性：

名称类型必填说明
extensionIdstring是表示打印机扩展的扩展ID。
vendorIdstring是表示扩展的供应商ID。
vendorNamestring是表示供应商名称。
vendorIconnumber是表示供应商图标。
versionstring是表示当前打印机扩展的版本。

print.queryAllPrinterExtensionInfos

queryAllPrinterExtensionInfos(callback: AsyncCallback<Array<PrinterExtensionInfo>>): void

查询所有已安装的打印机扩展服务，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
callbackAsyncCallback<Array<PrinterExtensionInfo>>是异步查询所有已安装的打印机扩展服务之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

print.queryAllPrinterExtensionInfos((err: BusinessError, extensionInfos: print.PrinterExtensionInfo[]) => {
    if (err) {
        console.error('queryAllPrinterExtensionInfos err ' + JSON.stringify(err));
    } else {
        console.log('queryAllPrinterExtensionInfos success ' + JSON.stringify(extensionInfos));
    }
})

print.queryAllPrinterExtensionInfos

queryAllPrinterExtensionInfos(): Promise<Array<PrinterExtensionInfo>>

查询所有已安装的打印机扩展服务，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

返回值：

类型说明
Promise<Array<PrinterExtensionInfo>>查询所有已安装的打印机扩展服务完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

print.queryAllPrinterExtensionInfos().then((extensionInfos: print.PrinterExtensionInfo[]) => {
    console.log('queryAllPrinterExtensionInfos success ' + JSON.stringify(extensionInfos));
    // ...
}).catch((error: BusinessError) => {
    console.error('failed to get AllPrinterExtension because ' + JSON.stringify(error));
})

print.startDiscoverPrinter

startDiscoverPrinter(extensionList: Array<string>, callback: AsyncCallback<void>): void

加载特定的打印机扩展并开始发现打印机，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
extensionListArray<string>是要加载的打印机扩展列表。
callbackAsyncCallback<void>是异步开始发现打印机之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let extensionList: string[] = [];
//extensionList内无信息表示发现所有扩展
print.startDiscoverPrinter(extensionList, (err: BusinessError, data : void) => {
    if (err) {
        console.error('failed to start Discover Printer because : ' + JSON.stringify(err));
    } else {
        console.log('start Discover Printer success data : ' + JSON.stringify(data));
    }
})

print.startDiscoverPrinter

startDiscoverPrinter(extensionList: Array<string>): Promise<void>

加载特定的打印机扩展并开始发现打印机，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
extensionListArray<string>是要加载的打印机扩展列表。

返回值：

类型说明
Promise<void>加载特定的打印机扩展并开始发现打印机完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let extensionList: string[] = [];
//extensionList内无信息表示发现所有扩展
print.startDiscoverPrinter(extensionList).then((data : void) => {
    console.log('start Discovery success data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('failed to start Discovery because : ' + JSON.stringify(error));
})

print.stopDiscoverPrinter

stopDiscoverPrinter(callback: AsyncCallback<void>): void

停止发现具有特定打印机扩展的打印机，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
callbackAsyncCallback<void>是异步停止发现具有特定打印机扩展的打印机之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

print.stopDiscoverPrinter((err: BusinessError, data : void) => {
    if (err) {
        console.error('failed to stop Discover Printer because : ' + JSON.stringify(err));
    } else {
        console.log('stop Discover Printer success data : ' + JSON.stringify(data));
    }
})

print.stopDiscoverPrinter

stopDiscoverPrinter(): Promise<void>

停止发现具有特定打印机扩展的打印机，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

返回值：

类型说明
Promise<void>停止发现具有特定打印机扩展的打印机完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

print.stopDiscoverPrinter().then((data : void) => {
    console.log('stop Discovery success data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('failed to stop Discovery because : ' + JSON.stringify(error));
})

print.connectPrinter

connectPrinter(printerId: string, callback: AsyncCallback<void>): void

连接特定打印机，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdstring是打印机ID。
callbackAsyncCallback<void>是异步连接特定打印机之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId: string = 'printerId_32';
print.connectPrinter(printerId, (err: BusinessError, data : void) => {
    if (err) {
        console.error('failed to connect Printer because : ' + JSON.stringify(err));
    } else {
        console.log('start connect Printer success data : ' + JSON.stringify(data));
    }
})

print.connectPrinter

connectPrinter(printerId: string): Promise<void>

连接特定打印机，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdstring是打印机ID

返回值：

类型说明
Promise<void>连接特定打印机完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId: string = 'printerId_32';
print.connectPrinter(printerId).then((data : void) => {
    console.log('start connect Printer success data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('failed to connect Printer because : ' + JSON.stringify(error));
})

print.disconnectPrinter

disconnectPrinter(printerId: string, callback: AsyncCallback<void>): void

断开特定打印机的连接，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdstring是打印机ID。
callbackAsyncCallback<void>是异步断开特定打印机的连接之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId: string = 'printerId_32';
print.disconnectPrinter(printerId, (err: BusinessError, data : void) => {
    if (err) {
        console.error('failed to disconnect Printer because : ' + JSON.stringify(err));
    } else {
        console.log('start disconnect Printer success data : ' + JSON.stringify(data));
    }
})

print.disconnectPrinter

disconnectPrinter(printerId: string): Promise<void>

断开特定打印机的连接，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdstring是打印机ID。

返回值：

类型说明
Promise<void>断开特定打印机的连接完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId: string = 'printerId_32';
print.disconnectPrinter(printerId).then((data : void) => {
    console.log('start disconnect Printer success data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('failed to disconnect Printer because : ' + JSON.stringify(error));
})

print.queryPrinterCapability

queryPrinterCapability(printerId: string, callback: AsyncCallback<void>): void

查询打印机能力，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdstring是打印机ID。
callbackAsyncCallback<void>是异步查询打印机能力之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId: string = 'printerId_32';
print.queryPrinterCapability(printerId, (err: BusinessError, data : void) => {
    if (err) {
        console.error('failed to query Printer Capability because : ' + JSON.stringify(err));
    } else {
        console.log('start query Printer Capability success data : ' + JSON.stringify(data));
    }
})

print.queryPrinterCapability

queryPrinterCapability(printerId: string): Promise<void>

查询打印机能力，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdstring是打印机ID。

返回值：

类型说明
Promise<void>查询打印机能力完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId: string = 'printerId_32';
print.queryPrinterCapability(printerId).then((data : void) => {
    console.log('start query Printer success data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('failed to query Printer Capability because : ' + JSON.stringify(error));
})

print.startPrintJob

startPrintJob(jobInfo: PrintJob, callback: AsyncCallback<void>): void

开始打印任务，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobInfoPrintJob是打印任务信息。
callbackAsyncCallback<void>是异步开始打印任务之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let jobInfo : print.PrintJob = {
    fdList : [0,1],
    jobId : 'jobId_12',
    printerId : 'printerId_32',
    jobState : 3,
    jobSubstate : print.PrintJobSubState.PRINT_JOB_COMPLETED_SUCCESS,
    copyNumber : 1,
    pageRange : {},
    isSequential : false,
    pageSize : {id : '', name : '', width : 10, height : 20},
    isLandscape : false,
    colorMode : 6,
    duplexMode : 6,
    margin : undefined,
    preview : undefined,
    options : undefined
};
print.startPrintJob(jobInfo, (err: BusinessError, data : void) => {
    if (err) {
        console.error('failed to start Print Job because : ' + JSON.stringify(err));
    } else {
        console.log('start Print Job success data : ' + JSON.stringify(data));
    }
})

print.startPrintJob

startPrintJob(jobInfo: PrintJob): Promise<void>

开始打印任务，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobInfoPrintJob是打印任务信息。

返回值：

类型说明
Promise<void>开始打印任务完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let jobInfo : print.PrintJob = {
    fdList : [0,1],
    jobId : 'jobId_12',
    printerId : 'printerId_32',
    jobState : 3,
    jobSubstate : print.PrintJobSubState.PRINT_JOB_COMPLETED_SUCCESS,
    copyNumber : 1,
    pageRange : {},
    isSequential : false,
    pageSize : {id : '', name : '', width : 10, height : 20},
    isLandscape : false,
    colorMode : 6,
    duplexMode : 6,
    margin : undefined,
    preview : undefined,
    options : undefined
};
print.startPrintJob(jobInfo).then((data : void) => {
    console.log('start Print success data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('failed to start Print because : ' + JSON.stringify(error));
})

print.cancelPrintJob

cancelPrintJob(jobId: string, callback: AsyncCallback<void>): void

取消已发送到打印机的打印任务，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobIdstring是打印任务ID。
callbackAsyncCallback<void>是异步取消已发送到打印机的打印任务之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let jobId : string = '121212';
print.cancelPrintJob(jobId, (err: BusinessError, data : void) => {
    if (err) {
        console.error('cancelPrintJob failed, because : ' + JSON.stringify(err));
    } else {
        console.log('cancelPrintJob success, data: ' + JSON.stringify(data));
    }
})

print.cancelPrintJob

cancelPrintJob(jobId: string): Promise<void>

取消已发送到打印机的打印任务，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobIdstring是打印任务ID。

返回值：

类型说明
Promise<void>取消已发送到打印机的打印任务完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let jobId : string = '121212';
print.cancelPrintJob(jobId).then((data : void) => {
    console.log('cancelPrintJob success, data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('cancelPrintJob failed, because : ' + JSON.stringify(error));
})

print.requestPrintPreview

requestPrintPreview(jobInfo: PrintJob, callback: Callback<number>): void

请求预览打印数据，使用callback回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobInfoPrintJob是打印任务信息。
callbackCallback<number>是请求预览打印数据之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';

let jobInfo : print.PrintJob = {
    fdList : [0,1],
    jobId : 'jobId_12',
    printerId : 'printerId_32',
    jobState : 3,
    jobSubstate : print.PrintJobSubState.PRINT_JOB_COMPLETED_SUCCESS,
    copyNumber : 1,
    pageRange : {},
    isSequential : false,
    pageSize : {id : '', name : '', width : 10, height : 20},
    isLandscape : false,
    colorMode : 6,
    duplexMode : 6,
    margin : undefined,
    preview : undefined,
    options : undefined
};
print.requestPrintPreview(jobInfo, (num : number) => {
    console.log('requestPrintPreview success, num : ' + JSON.stringify(num));

})

print.requestPrintPreview

requestPrintPreview(jobInfo: PrintJob): Promise<number>

请求预览打印数据，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobInfoPrintJob是打印任务信息。

返回值：

类型说明
Promise<number>请求预览打印数据完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let jobInfo : print.PrintJob = {
    fdList : [0,1],
    jobId : 'jobId_12',
    printerId : 'printerId_32',
    jobState : 3,
    jobSubstate : print.PrintJobSubState.PRINT_JOB_COMPLETED_SUCCESS,
    copyNumber : 1,
    pageRange : {},
    isSequential : false,
    pageSize : {id : '', name : '', width : 10, height : 20},
    isLandscape : false,
    colorMode : 6,
    duplexMode : 6,
    margin : undefined,
    preview : undefined,
    options : undefined
};
print.requestPrintPreview(jobInfo).then((num: number) => {
    console.log('requestPrintPreview success, num : ' + JSON.stringify(num));
}).catch((error: BusinessError) => {
    console.error('requestPrintPreview failed, because : ' + JSON.stringify(error));
})

print.on

on(type: 'printerStateChange', callback: (state: PrinterState, info: PrinterInfo) => void): void

注册打印机状态变化事件回调，使用callback回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
type'printerStateChange'是表示打印机状态改变。
callback(state: PrinterState, info: PrinterInfo) => void是打印机状态改变之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';

print.on('printerStateChange', (state: print.PrinterState, info: print.PrinterInfo) => {
    if (state === null||info === null) {
        console.error('printer state changed state is null or info is null');
        return;
    } else {
        console.log('on printer state changed, state : ' + JSON.stringify(state));
        console.log('on printer state changed, info : ' + JSON.stringify(info));
    }
})

print.off

off(type: 'printerStateChange', callback?: Callback<boolean>): void

取消注册打印机状态变化事件回调，使用callback回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
type'printerStateChange'是表示打印机状态改变。
callbackCallback<boolean>否表示取消注册打印机状态变化事件是否成功。true表示成功，false表示失败。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';

print.off('printerStateChange', (data: boolean) => {
    console.log('off printerStateChange data : ' + JSON.stringify(data));
})

print.on

on(type: 'jobStateChange', callback: (state: PrintJobState, job: PrintJob) => void): void

注册打印任务状态变化事件回调，使用callback回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
type'jobStateChange'是表示打印任务状态改变。
callback(state: PrintJobState, job: PrintJob) => void是打印任务状态改变之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';

print.on('jobStateChange', (state: print.PrintJobState, job: print.PrintJob) => {
    console.log('onJobStateChange, state : ' + JSON.stringify(state) + ', job : ' + JSON.stringify(job));
})

print.off

off(type: 'jobStateChange', callback?: Callback<boolean>): void

取消注册打印任务状态变化事件回调，使用callback回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
type'jobStateChange'是表示打印任务状态改变。
callbackCallback<boolean>否表示取消注册打印任务状态变化事件是否成功。true表示成功，false表示失败。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';

print.off('jobStateChange', (data: boolean) => {
    console.log('offJobStateChanged data : ' + JSON.stringify(data));
})

print.on

on(type: 'extInfoChange', callback: (extensionId: string, info: string) => void): void

注册打印扩展信息变化事件回调，使用callback回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
type'extInfoChange'是表示打印扩展信息改变。
callback(extensionId: string, info: string) => void是打印扩展信息改变之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';

print.on('extInfoChange', (extensionId: string, info: string) => {
    console.log('onExtInfoChange, entensionId : ' + JSON.stringify(extensionId) + ', info : ' + JSON.stringify(info));
})

print.off

off(type: 'extInfoChange', callback?: Callback<boolean>): void

取消注册打印扩展信息变化事件回调，使用callback回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
type'extInfoChange'是表示打印扩展信息改变。
callbackCallback<boolean>否表示取消注册打印扩展信息变化事件是否成功。true表示成功，false表示失败。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';

print.off('extInfoChange', (data: boolean) => {
    console.log('offExtInfoChange data : ' + JSON.stringify(data));
})

print.addPrinters

addPrinters(printers: Array<PrinterInfo>, callback: AsyncCallback<void>): void

添加打印机，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printersArray<PrinterInfo>是表示新到达的打印机列表。
callbackAsyncCallback<void>是异步添加打印机之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerInfo : print.PrinterInfo = {
    printerId : '3232',
    printerName : 'hhhhh',
    printerState : 0,
    printerIcon : 12,
    description : 'str',
    capability : undefined,
    options : 'opt'
};
print.addPrinters([printerInfo], (err: BusinessError, data : void) => {
    if (err) {
        console.error('addPrinters failed, because : ' + JSON.stringify(err));
    } else {
        console.log('addPrinters success, data : ' + JSON.stringify(data));
    }
})

print.addPrinters

addPrinters(printers: Array<PrinterInfo>): Promise<void>

添加打印机，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printersArray<PrinterInfo>是表示新到达的打印机列表。

返回值：

类型说明
Promise<void>添加打印机完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerInfo : print.PrinterInfo = {
    printerId : '3232',
    printerName : 'hhhhh',
    printerState : 0,
    printerIcon : 12,
    description : 'str',
    capability : undefined,
    options : 'opt'
};
print.addPrinters([printerInfo]).then((data : void) => {
    console.log('add printers data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('add printers error : ' + JSON.stringify(error));
})

print.removePrinters

removePrinters(printerIds: Array<string>, callback: AsyncCallback<void>): void

移除打印机，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdsArray<string>是表示需移除的打印机列表。
callbackAsyncCallback<void>是异步移除打印机之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId : string = '1212';
print.removePrinters([printerId], (err: BusinessError, data : void) => {
    if (err) {
        console.error('removePrinters failed, because : ' + JSON.stringify(err));
    } else {
        console.log('removePrinters success, data : ' + JSON.stringify(data));
    }
})

print.removePrinters

removePrinters(printerIds: Array<string>): Promise<void>

移除打印机，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdsArray<string>是表示需移除的打印机列表。

返回值：

类型说明
Promise<void>移除打印机完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId : string = '1212';
print.removePrinters([printerId]).then((data : void) => {
    console.log('remove printers data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('remove printers error : ' + JSON.stringify(error));
})

print.updatePrinters

updatePrinters(printers: Array<PrinterInfo>, callback: AsyncCallback<void>): void

更新特定打印机的信息，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printersArray<PrinterInfo>是表示待更新的打印机列表。
callbackAsyncCallback<void>是异步更新打印机信息之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerInfo : print.PrinterInfo = {
    printerId : '3232',
    printerName : 'hhhhh',
    printerState : 0,
    printerIcon : 12,
    description : 'str',
    capability : undefined,
    options : 'opt'
};
print.updatePrinters([printerInfo], (err: BusinessError, data : void) => {
    if (err) {
        console.error('updataPrinters failed, because : ' + JSON.stringify(err));
    } else {
        console.log('updataPrinters success, data : ' + JSON.stringify(data));
    }
})

print.updatePrinters

updatePrinters(printers: Array<PrinterInfo>): Promise<void>

更新特定打印机的信息，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printersArray<PrinterInfo>是表示待更新的打印机列表。

返回值：

类型说明
Promise<void>更新打印机完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerInfo : print.PrinterInfo = {
    printerId : '3232',
    printerName : 'hhhhh',
    printerState : 0,
    printerIcon : 12,
    description : 'str',
    capability : undefined,
    options : 'opt'
};
print.updatePrinters([printerInfo]).then((data : void) => {
    console.log('update printers data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('update printers error : ' + JSON.stringify(error));
})

print.updatePrinterState

updatePrinterState(printerId: string, state: PrinterState, callback: AsyncCallback<void>): void

更新打印机状态，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdstring是表示打印机ID。
statePrinterState是表示打印机状态。
callbackAsyncCallback<void>是异步更新打印机状态之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId : string = '1212';
let state : print.PrinterState = print.PrinterState.PRINTER_CONNECTED;
print.updatePrinterState(printerId, state, (err: BusinessError, data : void) => {
    if (err) {
        console.error('updataPrinterState failed, because : ' + JSON.stringify(err));
    } else {
        console.log('updataPrinterState success, data : ' + JSON.stringify(data));
    }
})

print.updatePrinterState

updatePrinterState(printerId: string, state: PrinterState): Promise<void>

更新打印机状态，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdstring是表示打印机ID。
statePrinterState是表示打印机状态。

返回值：

类型说明
Promise<void>更新打印机状态完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId : string = '1212';
let state : print.PrinterState = print.PrinterState.PRINTER_CONNECTED;
print.updatePrinterState(printerId, state).then((data : void) => {
    console.log('update printer state data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('update printer state error : ' + JSON.stringify(error));
})

print.updatePrintJobState

updatePrintJobState(jobId: string, state: PrintJobState, subState: PrintJobSubState, callback: AsyncCallback<void>): void

更新打印任务状态，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobIdstring是表示打印任务ID。
statePrintJobState是表示打印任务状态。
subStatePrintJobSubState是表示打印任务子状态。
callbackAsyncCallback<void>是异步更新打印任务状态之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let jobId : string = '3434';
let state : print.PrintJobState = print.PrintJobState.PRINT_JOB_PREPARE;
let subState : print.PrintJobSubState = print.PrintJobSubState.PRINT_JOB_COMPLETED_SUCCESS;
print.updatePrintJobState(jobId, state, subState, (err: BusinessError, data : void) => {
    if (err) {
        console.error('updataPrintJobState failed, because : ' + JSON.stringify(err));
    } else {
        console.log('updatePrintJobState success, data : ' + JSON.stringify(data));
    }
})

print.updatePrintJobState

updatePrintJobState(jobId: string, state: PrintJobState, subState: PrintJobSubState): Promise<void>

更新打印任务状态，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobIdstring是表示打印任务ID。
statePrintJobState是表示打印任务状态。
subStatePrintJobSubState是表示打印任务子状态。

返回值：

类型说明
Promise<void>更新打印任务状态完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let jobId : string = '3434';
let state : print.PrintJobState = print.PrintJobState.PRINT_JOB_PREPARE;
let subState : print.PrintJobSubState = print.PrintJobSubState.PRINT_JOB_COMPLETED_SUCCESS;
print.updatePrintJobState(jobId, state, subState).then((data : void) => {
    console.log('update print job state data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('update print job state error : ' + JSON.stringify(error));
})

print.updateExtensionInfo

updateExtensionInfo(info: string, callback: AsyncCallback<void>): void

更新打印扩展状态，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
infostring是表示打印扩展变更信息。
callbackAsyncCallback<void>是异步更新打印扩展状态之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let info : string = 'WIFI_INACTIVE';
print.updateExtensionInfo(info, (err: BusinessError, data : void) => {
    if (err) {
        console.error('updateExtensionInfo failed, because : ' + JSON.stringify(err));
    } else {
        console.log('updateExtensionInfo success, data : ' + JSON.stringify(data));
    }
})

print.updateExtensionInfo

updateExtensionInfo(info: string): Promise<void>

更新打印扩展状态，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
infostring是表示打印扩展变更信息。

返回值：

类型说明
Promise<void>更新打印扩展状态完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let info : string = 'WIFI_INACTIVE';
print.updateExtensionInfo(info).then((data : void) => {
    console.log('update print job state data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('update print job state error : ' + JSON.stringify(error));
})

print.queryAllPrintJobs(deprecated)

从API version 10开始支持，从API version 11开始废弃。 建议使用queryPrintJobList替代。

queryAllPrintJobs(callback: AsyncCallback<void>): void

查询所有打印任务，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
callbackAsyncCallback<void>是异步查询所有打印任务之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

print.queryAllPrintJobs((err: BusinessError, data : void) => {
    if (err) {
        console.error('queryAllPrintJobs failed, because : ' + JSON.stringify(err));
    } else {
        console.log('queryAllPrintJobs success, data : ' + JSON.stringify(data));
    }
})

print.queryAllPrintJobs(deprecated)

从API version 10开始支持，从API version 11开始废弃。 建议使用queryPrintJobList替代。

queryAllPrintJobs(): Promise<void>

查询所有打印任务，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

返回值：

类型说明
Promise<void>查询所有打印任务完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

print.queryAllPrintJobs().then((data : void) => {
    console.log('queryAllPrintJobs success, data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('queryAllPrintJobs failed, error : ' + JSON.stringify(error));
})

print.queryPrintJobList11+

queryPrintJobList(callback: AsyncCallback<Array<PrintJob>>): void

查询所有打印任务，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
callbackAsyncCallback<Array<PrintJob>>是异步查询所有打印任务之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

print.queryPrintJobList((err: BusinessError, printJobs : print.PrintJob[]) => {
    if (err) {
        console.error('queryPrintJobList failed, because : ' + JSON.stringify(err));
    } else {
        console.log('queryPrintJobList success, data : ' + JSON.stringify(printJobs));
    }
})

print.queryPrintJobList11+

queryPrintJobList(): Promise<Array<PrintJob>>

查询所有打印任务，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

返回值：

类型说明
Promise<Array<PrintJob>>查询所有打印任务完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

print.queryPrintJobList().then((printJobs : print.PrintJob[]) => {
    console.log('queryPrintJobList success, data : ' + JSON.stringify(printJobs));
}).catch((error: BusinessError) => {
    console.error('queryPrintJobList failed, error : ' + JSON.stringify(error));
})

print.queryPrintJobById11+

queryPrintJobById(jobId: string, callback: AsyncCallback<PrintJob>): void

按打印任务ID查询打印任务，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobIdstring是表示打印任务ID。
callbackAsyncCallback<PrintJob>是异步按打印任务ID查询打印任务之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let jobId : string = '1';
print.queryPrintJobById(jobId, (err: BusinessError, printJob : print.PrintJob) => {
    if (err) {
        console.error('queryPrintJobById failed, because : ' + JSON.stringify(err));
    } else {
        console.log('queryPrintJobById success, data : ' + JSON.stringify(printJob));
    }
})

print.queryPrintJobById11+

queryPrintJobById(jobId: string): Promise<PrintJob>

按打印任务ID查询打印任务，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobIdstring是表示打印任务ID。

返回值：

类型说明
Promise<PrintJob>按打印任务ID查询打印任务完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let jobId : string = '1';
print.queryPrintJobById(jobId).then((printJob : print.PrintJob) => {
    console.log('queryPrintJobById data : ' + JSON.stringify(printJob));
}).catch((error: BusinessError) => {
    console.error('queryPrintJobById error : ' + JSON.stringify(error));
})

print.startGettingPrintFile11+

startGettingPrintFile(jobId: string, printAttributes: PrintAttributes, fd: number, onFileStateChanged: Callback<PrintFileCreationState>): void

开始获取打印文件，使用Callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobIdstring是表示打印任务ID。
printAttributesPrintAttributes是表示打印参数。
fdnumber是表示打印文件描述符。
onFileStateChangedCallback<PrintFileCreationState>是表示更新文件状态的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let jobId : string= '1';
class MyPrintAttributes implements print.PrintAttributes {
    copyNumber?: number;
    pageRange?: print.PrintPageRange;
    pageSize?: print.PrintPageSize|print.PrintPageType;
    directionMode?: print.PrintDirectionMode;
    colorMode?: print.PrintColorMode;
    duplexMode?: print.PrintDuplexMode;
}

class MyPrintPageRange implements print.PrintPageRange {
    startPage?: number;
    endPage?: number;
    pages?: Array<number>;
}

class MyPrintPageSize implements print.PrintPageSize {
    id: string = '0';
    name: string = '0';
    width: number = 210;
    height: number = 297;
}

let printAttributes = new MyPrintAttributes();
printAttributes.copyNumber = 2;
printAttributes.pageRange = new MyPrintPageRange();
printAttributes.pageRange.startPage = 0;
printAttributes.pageRange.endPage = 5;
printAttributes.pageRange.pages = [1, 3];
printAttributes.pageSize = print.PrintPageType.PAGE_ISO_A3;
printAttributes.directionMode = print.PrintDirectionMode.DIRECTION_MODE_AUTO;
printAttributes.colorMode = print.PrintColorMode.COLOR_MODE_MONOCHROME;
printAttributes.duplexMode = print.PrintDuplexMode.DUPLEX_MODE_NONE;

let fd : number = 1;
print.startGettingPrintFile(jobId, printAttributes, fd, (state: print.PrintFileCreationState) => {
    console.log('onFileStateChanged success, data : ' + JSON.stringify(state));
})

print.notifyPrintService11+

notifyPrintService(jobId: string, type: 'spooler_closed_for_cancelled'|'spooler_closed_for_started', callback: AsyncCallback<void>): void

将spooler关闭信息通知打印服务，使用callback异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobIdstring是表示打印任务ID。
type'spooler_closed_for_cancelled' |'spooler_closed_for_started'是表示spooler关闭信息。
callbackAsyncCallback<void>是异步将spooler关闭信息通知打印服务之后的回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let jobId : string = '1';
print.notifyPrintService(jobId, 'spooler_closed_for_started', (err: BusinessError, data : void) => {
    if (err) {
        console.error('notifyPrintService failed, because : ' + JSON.stringify(err));
    } else {
        console.log('notifyPrintService success, data : ' + JSON.stringify(data));
    }
})

print.notifyPrintService11+

notifyPrintService(jobId: string, type: 'spooler_closed_for_cancelled'|'spooler_closed_for_started'): Promise<void>

将spooler关闭信息通知打印服务，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
jobIdstring是表示打印任务ID。
type'spooler_closed_for_cancelled' |'spooler_closed_for_started'是表示spooler关闭信息。

返回值：

类型说明
Promise<void>将spooler关闭信息通知打印服务后的完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let jobId : string = '1';
print.notifyPrintService(jobId, 'spooler_closed_for_started').then((data : void) => {
    console.log('notifyPrintService data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('notifyPrintService error : ' + JSON.stringify(error));
})

print.getPrinterInfoById12+

getPrinterInfoById(printerId: string): Promise<PrinterInfo>

根据打印机id获取打印机信息，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdstring是表示打印机ID。

返回值：

类型说明
Promise<PrinterInfo>根据打印机id获取打印机信息后的完成结果回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId : string = '1';
print.getPrinterInfoById(printerId).then((printerInfo : print.PrinterInfo) => {
    console.log('getPrinterInfoById data : ' + JSON.stringify(printerInfo));
}).catch((error: BusinessError) => {
    console.error('getPrinterInfoById error : ' + JSON.stringify(error));
})

print.notifyPrintServiceEvent12+

notifyPrintServiceEvent(event: ApplicationEvent): Promise<void>

将打印应用相关事件通知打印服务，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
eventApplicationEvent是表示打印应用事件。

返回值：

类型说明
Promise<void>将打印应用相关事件通知打印服务后的完成结果回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let event : print.ApplicationEvent = print.ApplicationEvent.APPLICATION_CREATED;
print.notifyPrintServiceEvent(event).then((data : void) => {
    console.log('notifyPrintServiceEvent data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('notifyPrintServiceEvent error : ' + JSON.stringify(error));
})

print.updatePrinterInformation18+

updatePrinterInformation(printerInformation: PrinterInformation): Promise<void>

更新系统中打印机的部分信息，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerInformationPrinterInformation是表示待更新信息的打印机。

返回值：

类型说明
Promise<void>更新打印机信息到系统打印机发现列表完成结果。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let testPageSize : print.PrintPageSize = {
    id : 'ISO_A4',
    name : 'iso_a4_210x297mm',
    width : 8268,
    height : 11692
};

let testCapability : print.PrinterCapabilities = {
    supportedPageSizes : [testPageSize],
    supportedColorModes : [print.PrintColorMode.COLOR_MODE_MONOCHROME],
    supportedDuplexModes : [print.PrintDuplexMode.DUPLEX_MODE_NONE],
    supportedMediaTypes : ['stationery'],
    supportedQualities : [print.PrintQuality.QUALITY_NORMAL],
    supportedOrientations : [print.PrintOrientationMode.ORIENTATION_MODE_PORTRAIT],
    options : 'testOptions'
};

let printerInformation : print.PrinterInformation = {
    printerId : 'testPrinterId',
    printerName : 'testPrinterName',
    printerStatus : 0,
    description : 'testDesc',
    capability : testCapability,
    uri : 'testUri',
    printerMake : 'testPrinterMake',
    options : 'testOptions'
};
print.updatePrinterInformation(printerInformation).then((data : void) => {
    console.log('updatePrinterInformation data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('updatePrinterInformation error : ' + JSON.stringify(error));
})

print.setPrinterPreferences18+

setPrinterPreferences(printerId: string, printerPreferences: PrinterPreferences): Promise<void>

设置打印机首选项，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdstring是表示打印机ID。
printerPreferencesPrinterPreferences是表示打印机首选项。

返回值：

类型说明
Promise<void>设置打印机首选项后的完成结果回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId : string = 'testPrinterId';
let preferences : print.PrinterPreferences = {
    defaultDuplexMode: print.PrintDuplexMode.DUPLEX_MODE_NONE
};
print.setPrinterPreferences(printerId, preferences).then((data : void) => {
    console.log('setPrinterPreferences data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('setPrinterPreferences error : ' + JSON.stringify(error));
})

print.discoverUsbPrinters18+

discoverUsbPrinters(): Promise<Array<PrinterInformation>>

发现usb打印机，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

返回值：

类型说明
Promise<Array<PrinterInformation>>发现的usb打印机列表。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

print.discoverUsbPrinters().then((printers : print.PrinterInformation[]) => {
    console.log('discoverUsbPrinters data : ' + JSON.stringify(printers));
}).catch((error: BusinessError) => {
    console.error('discoverUsbPrinters error : ' + JSON.stringify(error));
})

print.setDefaultPrinter18+

setDefaultPrinter(printerId: string, type: DefaultPrinterType): Promise<void>

设置默认打印机，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
printerIdstring是表示打印机ID。
typeDefaultPrinterType是表示默认打印机类型。

返回值：

类型说明
Promise<void>设置默认打印机后的完成结果回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let printerId : string = '1';
let type : print.DefaultPrinterType = print.DefaultPrinterType.DEFAULT_PRINTER_TYPE_SET_BY_USER;
print.setDefaultPrinter(printerId, type).then((data : void) => {
    console.log('setDefaultPrinter data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('setDefaultPrinter error : ' + JSON.stringify(error));
})

print.notifyPrintServiceEvent18+

notifyPrintServiceEvent(event: ApplicationEvent, jobId: string): Promise<void>

将打印应用相关事件通知打印服务，使用Promise异步回调。

需要权限： ohos.permission.MANAGE_PRINT_JOB

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Print.PrintFramework

参数：

参数名类型必填说明
eventApplicationEvent是表示打印应用事件。
jobIdstring是表示打印任务ID。

返回值：

类型说明
Promise<void>将打印应用相关事件通知打印服务后的完成结果回调。

错误码：

以下错误码的详细介绍请参见打印服务错误码。

错误码ID错误信息
201the application does not have permission to call this function.
202not system application
401Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.

示例：

import { print } from '@kit.BasicServicesKit';
import { BusinessError } from '@ohos.base';

let event : print.ApplicationEvent = print.ApplicationEvent.APPLICATION_CREATED;
let jobId : string = '1';
print.notifyPrintServiceEvent(event, jobId).then((data : void) => {
    console.log('notifyPrintServiceEvent data : ' + JSON.stringify(data));
}).catch((error: BusinessError) => {
    console.error('notifyPrintServiceEvent error : ' + JSON.stringify(error));
})

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Basic Services Kit（基础服务）

harmony 鸿蒙DeviceInfo

harmony 鸿蒙OH_Print

harmony 鸿蒙Print_Margin

harmony 鸿蒙Print_PageSize

harmony 鸿蒙Print_PrintAttributes

harmony 鸿蒙Print_PrintDocCallback

harmony 鸿蒙Print_Range

harmony 鸿蒙TimeService

harmony 鸿蒙ohscan.h

  • 所属分类： 后端技术
  • 本文标签： 鸿蒙 软件
  • 版权声明： 本文链接 https://seaxiang.com/blog/evUaT8