@ohos.file.picker (选择器)(系统接口)

选择器(Picker)是一个封装PhotoViewPicker、DocumentViewPicker、AudioViewPicker等API模块,具有选择与保存的能力。应用可以自行选择使用哪种API实现文件选择和文件保存的功能。该类接口,需要应用在界面UIAbility中调用,否则无法拉起photoPicker应用或FilePicker应用。

说明:

  • 本模块接口从API version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
  • 当前页面仅包含本模块的系统接口,其他公开接口参见@ohos.file.picker (选择器)

导入模块

import  { picker } from '@kit.CoreFileKit';

DocumentSelectOptions

文档选择选项。

原子化服务API:从API version 12开始,该接口支持在原子化服务中使用。

系统能力:SystemCapability.FileManagement.UserFileService

属性

名称 类型 只读 可选 说明
themeColor18+ CustomColors 主题色参数, 默认为空,跟随FilePicker应用颜色。当themeColor设置为特定的主题色属性(brand, fontPrimary, compBackgroundEmphasize, iconFourth时,被拉起的FilePicker应用将适配传入的主题色参数的效果。
系统能力:SystemCapability.FileManagement.UserFileService
设备行为差异:该接口在Phone设备中可正常调用,在其他设备中无效果。

DocumentSaveOptions

文档保存选项。

原子化服务API:从API version 12开始,该接口支持在原子化服务中使用。

系统能力:SystemCapability.FileManagement.UserFileService

属性

名称 类型 只读 可选 说明
themeColor18+ CustomColors 主题色参数, 默认为空,跟随FilePicker应用颜色。当themeColor设置为特定的主题色属性(fontEmphasize, compBackgroundEmphasize时,被拉起的FilePicker应用将适配传入的主题色参数的效果。
系统能力:SystemCapability.FileManagement.UserFileService
设备行为差异:该接口在Phone设备中可正常调用,在其他设备中无效果。