• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.file.picker (选择器)(系统接口)
2<!--Kit: Core File Kit-->
3<!--Subsystem: FileManagement-->
4<!--Owner: @wang_zhangjun; @zhuangzhuang-->
5<!--Designer: @wang_zhangjun; @zhuangzhuang; @renguang1116-->
6<!--Tester: @liuhonggang123; @yue-ye2; @juxiaopang-->
7<!--Adviser: @foryourself-->
8
9选择器(Picker)是一个封装PhotoViewPicker、DocumentViewPicker、AudioViewPicker等API模块，具有选择与保存的能力。应用可以自行选择使用哪种API实现文件选择和文件保存的功能。该类接口，需要应用在界面UIAbility中调用，否则无法拉起photoPicker应用或FilePicker应用。
10> **说明：**
11>
12> - 本模块接口从API version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
13> - 当前页面仅包含本模块的系统接口，其他公开接口参见[@ohos.file.picker (选择器)](js-apis-file-picker.md)。
14
15## 导入模块
16
17```ts
18import  { picker } from '@kit.CoreFileKit';
19```
20
21## DocumentSelectOptions
22
23文档选择选项。
24
25**原子化服务API**：从API version 12开始，该接口支持在原子化服务中使用。<br>
26
27**系统能力**：SystemCapability.FileManagement.UserFileService<br>
28
29### 属性
30
31| 名称                    | 类型                                         | 只读  | 可选  | 说明                                     |
32| :---------------------- |---------------------------------------------| ---- | ---- |------------------------------------------|
33| themeColor<sup>18+</sup>     | [CustomColors](../apis-arkui/js-apis-arkui-theme.md#customcolors) |  否  |  是 |主题色参数, 默认为空，跟随FilePicker应用颜色。当themeColor设置为特定的主题色属性（[brand, fontPrimary, compBackgroundEmphasize, iconFourth](../apis-arkui/js-apis-arkui-theme.md#colors)时，被拉起的FilePicker应用将适配传入的主题色参数的效果。<br> **系统能力**：SystemCapability.FileManagement.UserFileService<br> **设备行为差异**：该接口在Phone设备中可正常调用，在其他设备中无效果。 |
34
35## DocumentSaveOptions
36
37文档保存选项。
38
39**原子化服务API**：从API version 12开始，该接口支持在原子化服务中使用。
40
41**系统能力**：SystemCapability.FileManagement.UserFileService
42
43### 属性
44
45| 名称                    | 类型                                          |  只读  | 可选  |说明                                       |
46| :---------------------- |---------------------------------------------| ----- |--------| ------------------------------------------|
47| themeColor<sup>18+</sup>     | [CustomColors](../apis-arkui/js-apis-arkui-theme.md#customcolors) |  否   | 是 | 主题色参数, 默认为空，跟随FilePicker应用颜色。当themeColor设置为特定的主题色属性（[fontEmphasize, compBackgroundEmphasize](../apis-arkui/js-apis-arkui-theme.md#colors)时，被拉起的FilePicker应用将适配传入的主题色参数的效果。<br> **系统能力**：SystemCapability.FileManagement.UserFileService<br> **设备行为差异**：该接口在Phone设备中可正常调用，在其他设备中无效果。|
48