• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.file.picker (选择器)(系统接口)
2
3选择器(Picker)是一个封装PhotoViewPicker、DocumentViewPicker、AudioViewPicker等API模块，具有选择与保存的能力。应用可以自行选择使用哪种API实现文件选择和文件保存的功能。该类接口，需要应用在界面UIAbility中调用，否则无法拉起photoPicker应用或FilePicker应用。
4> **说明：**
5>
6> - 本模块接口从API version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
7> - 当前页面仅包含本模块的系统接口，其他公开接口参见[@ohos.file.picker (选择器)](js-apis-file-picker.md)。
8
9## 导入模块
10
11```ts
12import  { picker } from '@kit.CoreFileKit';
13```
14
15## DocumentSelectOptions
16
17文档选择选项。
18
19**原子化服务API**：从API version 12开始，该接口支持在原子化服务中使用。<br>
20
21**系统能力**：SystemCapability.FileManagement.UserFileService<br>
22
23### 属性
24
25| 名称                    | 类型                                         | 只读  | 可选  | 说明                                     |
26| :---------------------- |---------------------------------------------| ---- | ---- |------------------------------------------|
27| 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，仅支持手机设备。 |
28
29## DocumentSaveOptions
30
31文档保存选项。
32
33**原子化服务API**：从API version 12开始，该接口支持在原子化服务中使用。
34
35**系统能力**：SystemCapability.FileManagement.UserFileService
36
37### 属性
38
39| 名称                    | 类型                                          |  只读  | 可选  |说明                                       |
40| :---------------------- |---------------------------------------------| ----- |--------| ------------------------------------------|
41| 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，仅支持手机设备。|
42