1# @ohos.app.ability.PrintExtensionAbility (打印扩展能力)
2
3该模块为打印扩展能力的操作API，提供调用打印扩展能力的接口。
4
5> **说明：**
6> 本模块首批接口从API version 14开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
7> 本模块接口仅可在Stage模型下使用。
8
9## 导入模块
10
11```ts
12import PrintExtensionAbility from '@ohos.app.ability.PrintExtensionAbility';
13```
14
15## onCreate
16
17onCreate(want: Want): void
18
19初始化扩展能力,会在系统首次连接打印扩展时调用。
20
21**系统能力：** SystemCapability.Print.PrintFramework
22
23**参数：**
24| **参数名** | **类型** | **必填** | **说明** |
25| -------- | -------- | -------- | -------- |
26| want | Want | 是 | 表示调用打印页面需要参数 |
27
28**示例：**
29
30```ts
31import PrintExtensionAbility from '@ohos.app.ability.PrintExtensionAbility';
32import Want from '@ohos.app.ability.Want';
33
34export default class HWPrintExtension extends PrintExtensionAbility {
35    onCreate(want: Want): void {
36        console.log('onCreate');
37        // ...
38    }
39}
40```
41
42## onStartDiscoverPrinter
43
44onStartDiscoverPrinter(): void
45
46开始发现与设备连接的打印机时调用。
47
48**系统能力：** SystemCapability.Print.PrintFramework
49
50**示例：**
51
52```ts
53import PrintExtensionAbility from '@ohos.app.ability.PrintExtensionAbility';
54
55export default class HWPrintExtension extends PrintExtensionAbility {
56    onStartDiscoverPrinter(): void {
57        console.log('onStartDiscoverPrinter enter');
58        // ...
59    }
60}
61```
62
63## onStopDiscoverPrinter
64
65onStopDiscoverPrinter(): void
66
67停止发现打印机时调用。
68
69**系统能力：** SystemCapability.Print.PrintFramework
70
71**示例：**
72
73```ts
74import PrintExtensionAbility from '@ohos.app.ability.PrintExtensionAbility';
75
76export default class HWPrintExtension extends PrintExtensionAbility {
77    onStopDiscoverPrinter(): void {
78        console.log('onStopDiscoverPrinter enter');
79        // ...
80    }
81}
82```
83
84## onConnectPrinter
85
86onConnectPrinter(printerId: number): void
87
88连接到特定打印机时调用。
89
90**系统能力：** SystemCapability.Print.PrintFramework
91
92**参数：**
93| **参数名** | **类型** | **必填** | **说明** |
94| -------- | -------- | -------- | -------- |
95| printerId | number | 是 | 表示打印机ID |
96
97**示例：**
98
99```ts
100import PrintExtensionAbility from '@ohos.app.ability.PrintExtensionAbility';
101
102export default class HWPrintExtension extends PrintExtensionAbility {
103    onConnectPrinter(printerId: number): void {
104        console.log('onConnectPrinter enter');
105        // ...
106    }
107}
108```
109
110## onDisconnectPrinter
111
112onDisconnectPrinter(printerId: number): void
113
114断开与特定打印机的连接时调用。
115
116**系统能力：** SystemCapability.Print.PrintFramework
117
118**参数：**
119| **参数名** | **类型** | **必填** | **说明** |
120| -------- | -------- | -------- | -------- |
121| printerId | number | 是 | 表示打印机ID |
122
123**示例：**
124
125```ts
126import PrintExtensionAbility from '@ohos.app.ability.PrintExtensionAbility';
127
128export default class HWPrintExtension extends PrintExtensionAbility {
129    onDisconnectPrinter(printerId: number): void {
130        console.log('onDisconnectPrinter enter');
131        // ...
132    }
133}
134```
135
136## onDestroy
137
138onDestroy(): void
139
140结束打印扩展时调用。
141
142**系统能力：** SystemCapability.Print.PrintFramework
143
144**示例：**
145
146```ts
147import PrintExtensionAbility from '@ohos.app.ability.PrintExtensionAbility';
148
149export default class HWPrintExtension extends PrintExtensionAbility {
150    onDestroy(): void {
151        console.log('onDestroy');
152    }
153}
154```
155